Skip to content

Commit 31bb0a0

Browse files
author
Russ Williams
committed
Fixed "server refused connection" error from change in port the bot was running on (was 3978 with SDK bots and it 3980 with Composer). When the port is wrong, the agent hub can't find the bot's MessageToBot endpoint which the ACSConnector add to the Composer bot
1 parent 307c200 commit 31bb0a0

19 files changed

+120
-17
lines changed

ACSConnector/ACSConnector.csproj

Lines changed: 7 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -19,8 +19,8 @@
1919
<Authors>Russ Williams</Authors>
2020
<PackageRequireLicenseAcceptance>true</PackageRequireLicenseAcceptance>
2121
<PackageLicenseExpression>MIT</PackageLicenseExpression>
22-
<PackageProjectUrl>http://aka.ms/corptex</PackageProjectUrl>
23-
<RepositoryUrl>http://aka.ms/corptex</RepositoryUrl>
22+
<PackageProjectUrl>http://aka.ms/acshub#adding-escalation-to-your-bot</PackageProjectUrl>
23+
<RepositoryUrl>http://aka.ms/acshub#adding-escalation-to-your-bot</RepositoryUrl>
2424
<PackageIcon>Agent.png</PackageIcon>
2525
<PackageIconUrl />
2626
<RepositoryType>GitHub</RepositoryType>
@@ -38,12 +38,15 @@
3838
<Pack>True</Pack>
3939
<PackagePath></PackagePath>
4040
</None>
41-
<None Include="README.md" Condition="Exists('README.md')" Pack="true" PackagePath="" />
41+
<None Include="doc/CreatingLocalFeed.png">
42+
<Pack>True</Pack>
43+
<PackagePath></PackagePath>
44+
</None>
45+
<None Include="README.md" Condition="Exists('README.md')" Pack="true" PackagePath="" />
4246
</ItemGroup>
4347

4448

4549
<ItemGroup>
46-
<PackageReference Include="Microsoft.Azure.EventGrid" Version="3.2.0" />
4750
<PackageReference Include="Microsoft.Bot.Builder.Integration.AspNet.Core" Version="4.13.1" />
4851
<PackageReference Include="Microsoft.NETCore.App" Version="2.2.8" />
4952
</ItemGroup>

ACSConnector/Controllers/ACSController.cs

Lines changed: 0 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,8 +1,6 @@
11
using ACSAgentHubSDK.Models;
22
using ACSConnector.Models;
33
using Microsoft.AspNetCore.Mvc;
4-
using Microsoft.Azure.EventGrid;
5-
using Microsoft.Azure.EventGrid.Models;
64
using Microsoft.Bot.Builder;
75
using Microsoft.Bot.Builder.Integration.AspNet.Core;
86
using Microsoft.Bot.Connector;

ACSConnector/README.md

Lines changed: 10 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -1,12 +1,16 @@
11
# 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.
48

59
### Prerequisites
610
Successful use of this package requires the installation of a set of prerequisites so if you haven't installed them
711
yet, browse the the [ACS Agent Hub Prerequisites](http://aka.ms/acshub#prerequisites) and install them
812

9-
### <a name="GettingStarted"></a>Getting Started
13+
### Getting Started
1014

1115
Getting started couldn't be easier. Simply clone the ACS Agent Hub repo and run a single deployment script and
1216
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
3236
- **\<location name>** is the Azure location name of the region that services will be deployed in
3337
- **\<nuget path>** is the full path to the nuget.exe (e.g., c:\nuget\nuget.exe)
3438

35-
### <a name="ExploreEscalationScenarios"></a>Explore Escalation Scenarios
39+
### Explore Escalation Scenarios
3640
To make it easy for you to quickly experiment with the ACS Agent Hub we've included sample applications that are all
3741
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
3842
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
4246
a short [demo video](http://add-demo-here) you can watch that shows all these steps and various escalation and agent
4347
management scenaios you can replicate using this sample app.
4448

45-
### <a name="AddingEscalationToYourBot"></a>Adding Escalation to Your Bot
49+
### Adding Escalation to Your Bot
4650
The sample is nice for quickly experimenting with escalation and taking a look at how it's coded, but it doesn't
4751
address how to add escalation to bots. The good news is that adding agent escalation to a Composer bot is very
4852
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
5155
1) **Install Agent Hub Package** - First, create a local feed and set its URL property to the full path of the
5256
.\ACSConnector\localFeed folder so Composer will know where find the package and second, add the ACSConnector package
5357
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>
5559
![High-level Subsystem Overview](doc/InstallingACSConnector.png)
5660
2) **Set App Setting** - Paste the following at the top of the bot's appsettings.json file:<br>
5761
```

ACSConnector/doc/AppSettings.png

78.5 KB
Loading
92 KB
Loading

ACSConnector/doc/EscalateAction.png

35 KB
Loading
55.3 KB
Loading
95.7 KB
Loading
1.09 MB
Loading
52.8 KB
Loading

0 commit comments

Comments
 (0)