1
1
# ACS Agent Hub
2
- The ACS Agent Hub package implements agent escalation and makes it extremely simple to
3
- add a human handoff capability to any bot.
2
+ This package integrates with a ready-made agent hub solution built on the Azure Communication Service that allows
3
+ you to add human handoff experiences to your bot. Super simple to use, just add a Send Handoff Activity to your
4
+ dialog and the ACSConnector takes care of the rest. Escalations will be sent to a ready-made agent hub that you
5
+ clone from GitHub which allows multiple agents to handle multiple simultaneous conversations with bot users.
6
+ Because it's built purely from Azure Services, you can have an agent escalation capability up and working in 15
7
+ minutes or so.
4
8
5
9
### Prerequisites
6
10
Successful use of this package requires the installation of a set of prerequisites so if you haven't installed them
7
11
yet, browse the the [ ACS Agent Hub Prerequisites] ( http://aka.ms/acshub#prerequisites ) and install them
8
12
9
- ### < a name = " GettingStarted " ></ a > Getting Started
13
+ ### Getting Started
10
14
11
15
Getting started couldn't be easier. Simply clone the ACS Agent Hub repo and run a single deployment script and
12
16
you're ready to run add escalation to your bot. There are a variety of escalation scenarios you can support and
@@ -32,7 +36,7 @@ other services created by this script
32
36
- ** \< location name>** is the Azure location name of the region that services will be deployed in
33
37
- ** \< nuget path>** is the full path to the nuget.exe (e.g., c:\nuget\nuget.exe)
34
38
35
- ### < a name = " ExploreEscalationScenarios " ></ a > Explore Escalation Scenarios
39
+ ### Explore Escalation Scenarios
36
40
To make it easy for you to quickly experiment with the ACS Agent Hub we've included sample applications that are all
37
41
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
38
42
the Home tab and open the ComposerExample that's in the root folder of the solution. This is a very simple bot with
@@ -42,7 +46,7 @@ when the bot finishes it's startup processing. Type, _**talk to human**_ to sta
42
46
a short [ demo video] ( http://add-demo-here ) you can watch that shows all these steps and various escalation and agent
43
47
management scenaios you can replicate using this sample app.
44
48
45
- ### < a name = " AddingEscalationToYourBot " ></ a > Adding Escalation to Your Bot
49
+ ### Adding Escalation to Your Bot
46
50
The sample is nice for quickly experimenting with escalation and taking a look at how it's coded, but it doesn't
47
51
address how to add escalation to bots. The good news is that adding agent escalation to a Composer bot is very
48
52
simple and only involves a few steps. The following steps are shown in a very short video
@@ -51,7 +55,7 @@ simple and only involves a few steps. The following steps are shown in a very s
51
55
1 ) ** Install Agent Hub Package** - First, create a local feed and set its URL property to the full path of the
52
56
.\ACSConnector\localFeed folder so Composer will know where find the package and second, add the ACSConnector package
53
57
to your bot as shown in the following screen shots, respectively<br >
54
- ![ High-level Subsystem Overview] ( doc/ CreatingLocalFeed.png) <br >
58
+ ![ High-level Subsystem Overview] ( CreatingLocalFeed.png ) <br >
55
59
![ High-level Subsystem Overview] ( doc/InstallingACSConnector.png )
56
60
2 ) ** Set App Setting** - Paste the following at the top of the bot's appsettings.json file:<br >
57
61
```
0 commit comments