Skip to content

Commit 7a7da1f

Browse files
author
Russ Williams
committedOct 13, 2021
Update README
1 parent 8f39798 commit 7a7da1f

File tree

4 files changed

+18
-9
lines changed

4 files changed

+18
-9
lines changed
 

‎README.md

+18-9
Original file line numberDiff line numberDiff line change
@@ -69,16 +69,24 @@ required services
6969
- **\<nuget path>** is the full path to the nuget.exe (e.g., c:\nuget\nuget.exe)
7070

7171
### <a name="ExploreEscalationScenarios"></a>Explore Escalation Scenarios
72-
Open the Bot Framework Composer and select the **Open** link on the Home tab and open the ComposerExample that's in
73-
the root folder of the solution. This is a very simple bot with an Escalate trigger that you can look at to see how
74-
to code an escalation and then try it out by using the **Start bot** command. After the bot starts, choose the
75-
**Open Web Chat** option in the flyout menu that appears when the bot finishes it's startup processing. Type, _**talk
76-
to human**_ to start an escalation experience. There's a short [demo video](http://add-demo-here) you can watch that
77-
shows all these steps and various escalation and agent management scenaios you can replicate using this sample app.
72+
To make it easy for you to quickly experiment with the ACS Agent Hub we've included sample applications that are all
73+
ready to go. All you need to do to try it out is to open the Bot Framework Composer and select the **Open** link on
74+
the Home tab and open the ComposerExample that's in the root folder of the solution. This is a very simple bot with
75+
an Escalate trigger that you can look at to see how to code an escalation and then try it out by using the
76+
**Start bot** command. After the bot starts, choose the **Open Web Chat** option in the flyout menu that appears
77+
when the bot finishes it's startup processing. Type, _**talk to human**_ to start an escalation experience. There's
78+
a short [demo video](http://add-demo-here) you can watch that shows all these steps and various escalation and agent
79+
management scenaios you can replicate using this sample app.
7880

7981
### <a name="AddingEscalationToYourBot"></a>Adding Escalation to Your Bot
80-
Adding agent escalation to a Composer bot is very simple and only involves a few steps:
81-
1) **Install Package** - Use the package manager to install the ACSConnector package
82+
The samples are nice for quickly experimenting with escalation and taking a look at how it's coded, but they don't
83+
address how to add escalation to bots. The good news is that adding agent escalation to a Composer bot is very
84+
simple and only involves a few steps. These following steps are shown in a very short video [here](http://adding-escalation-=video)
85+
that you might find easier to follow.
86+
1) **Install Agent Hub Package** - First create a local feed so Composer will know where the package lives and second,
87+
add the ACSConnector package to your bot as show in the following screen shots, respectively<br>
88+
![High-level Subsystem Overview](doc/CreatingLocalFeed.png)<br>
89+
![High-level Subsystem Overview](doc/InstallingACSConnector.png)
8290
2) **Add Escalation Action** - Add a _**Send handoff activity**_ action to any dialog and wherever it makes sense in your bo<br>
8391
![High-level Subsystem Overview](doc/EscalateAction.png)
8492
3) **Set Escalation Action Properties** - Paste the following escalation payload into **Context** property of escalation action and set **Transcription**
@@ -97,12 +105,13 @@ the this agent hub solution you'll use the above payload. Currently, the **Skil
97105
being used and can be set to whatever you like or left empty. The **Name** and **WhyTheyNeedHelp** properties
98106
are used in the agent-portal and the ComposerExample shows a nice way to gather and set those properties.<br>
99107
![High-level Subsystem Overview](doc/EscalationProperties.png)
100-
3) **Set App Setting** - Paste the following into the bot's appsettings.json:<br>
108+
4) **Set App Setting** - Paste the following at the top of the bot's appsettings.json file:<br>
101109
```
102110
"ACSConnector": {
103111
"acsAgentHubBaseAddress": "http://localhost:7071"
104112
},
105113
```
114+
![High-level Subsystem Overview](doc/AppSettings.png)
106115

107116
### <a name="AddingAgentEscalationToNewOrExistingBot"></a>Appendix A: Agent Escalation in a VA Template Bot
108117
If you want to add agent escalation to a Virtual Assistant Template bot, you can explore

‎doc/AppSettings.png

78.5 KB
Loading

‎doc/CreatingLocalFeed.png

92 KB
Loading

‎doc/InstallingACSConnector.png

179 KB
Loading

0 commit comments

Comments
 (0)
Please sign in to comment.