Agenten in Azure Bot Service-Kanälen veröffentlichen

Sie können Ihren Agenten mit vorhandenen Azure Bot Service-Kanälen verbinden, was hilfreich sein kann, wenn Sie Ihren Agenten in Azure Bot Service-Kanälen mit Kundschaft verbinden möchten.

Das Hinzufügen Ihres Agenten zu Azure Bot Service-Kanälen erfordert beträchtliche Kenntnisse in der Entwicklung. Dieser Artikel wurde für IT-Administratoren oder Entwickler geschrieben, die Erfahrung in der Entwicklung und dem Schreiben von Code haben.

Tipp

Sie müssen sich nicht an dieses Dokument halten, um Ihren Copilot Studio-Agenten zu Ihrer Webseite, Facebook oder Microsoft Teams hinzuzufügen. Wenn Sie eine Verbindung zu einer benutzerdefinierten webbasierten oder nativen App herstellen möchten, erfahren Ihre Entwicklungsfachkräfte mehr unter Einen Agenten an mobile oder benutzerdefinierte Apps veröffentlichen.

Wichtig

Anweisungen in diesem Abschnitt erfordern Softwareentwicklung von Ihnen oder Ihren Entwicklern. Es richtet sich an erfahrene IT-Experten wie IT-Administratoren oder -Entwickler, die ein solides Verständnis für Entwicklertools, Dienstprogramme und IDEs haben.

Voraussetzungen

• Ein Azure Bot Service-Abonnement.
• Ein Azure Bot Service-Bot mit v4 SDK.
• .NET Core SDK Version 2.1.
• Nuget-Paket Microsoft.Bot.Connector.DirectLine.
• Ein in Copilot Studio erstellter Agent, mit dem Sie eine Verbindung zu einem Azure Bot Service-Kanal herstellen möchten.
• Veröffentlichen Sie einen Agenten in mobilen oder benutzerdefinierten Apps.

Codebeispiele

In diesem Dokument verwendete Codefragmente stammen von Relay-Bot-Beispielcode.

Referenzen

Die Anweisungen in diesem Dokument beziehen sich die folgenden Dokumente:

• Stellen Sie Ihren Bot in Azure bereit enthält Anweisungen zum Bereitstellen des Azure Bot Service-Bots.
• Azure Bot Service-Kanäle, um eine Verbindung zu einem von Azure Bot Service unterstützten Kanal herzustellen.
• Azure Bot Service-Debugging mit dem Emulator für Anweisungen zum Debuggen des Azure Bot Service-Bots.

Einen vorhandenen Azure Bot Service-Bot erstellen oder verwenden

Sie benötigen einen Azure Bot Service-Bot, der Unterhaltungen zwischen Ihrem Copilot Studio-Agenten- und Azure Bot Service-Kanälen weiterleiten kann.

Der Relay-Bot-Beispielcode ist ein guter Ausgangspunkt, wenn Sie keinen vorhandenen Azure Bot Service-Bot haben. Er wird erstellt aus Microsoft Bot Framework-Bot-Beispielcode, der kompiliert und für den Azure Bot Service bereitgestellt werden kann. Der Beispielcode soll als Ausgangspunkt und nicht direkt in der Produktion verwendet werden. Sie müssen Code und Optimierung hinzufügen, um Ihren Geschäftsanforderungen zu entsprechen.

Wenn Sie bereits einen Azure Bot Service-Bot haben, müssen Sie einen Copilot Studio Connector und Code zum Verwalten von Konversationssitzungen hinzufügen. Anschließend können Sie den Bot für den Azure Bot Service bereitstellen und mit dem Azure-Portal eine Verbindung zu Kanälen herstellen.

Copilot Studio-Agenten-Parameter abrufen

Um eine Verbindung zu dem Agenten herzustellen, den Sie mithilfe von Copilot Studio erstellt haben, müssen Sie den Namen und den Token-Endpunkt Ihres Agenten abrufen.

1. Kopieren Sie den Namen Ihres Agenten in Copilot Studio.

   

2. Wählen Sie im Navigationsmenü unter Einstellungen die Option Kanäle.

3. Wählen Sie den Kanal aus, mit dem Sie eine Verbindung herstellen möchten. Dieses Szenario verwendet Slack als Beispiel.

   

4. Um den Token Endpunkt Wert zu kopieren und zu speichern wählen Sie Kopieren. Sie benötigen Ihren Endpunkt, um Ihren Agenten mit dem Azure Bot Service-Kanal zu verbinden.

   

Unterhaltungssitzungen mit Ihrem Copilot Studio-Agenten verwalten

Es können mehrere Unterhaltungen zwischen den Azure Bot Service-Kanälen und der Direct Line-Verbindung mit Ihrem Copilot Studio-Agenten stattfinden.

Ihr Azure Bot Service-Bot muss die Unterhaltung vom Azure Bot Service-Kanal zuordnen und an die Direct Line-Unterhaltung mit dem Copilot Studio-Agenten weiterleiten und umgekehrt.

Beispielcodebeispiel

Das folgende Beispiel verwendet Beispiele aus dem Relay-Bot-Beispielcode.

1. Starten Sie bei jedem neuen Start der Unterhaltung mit einem externen Azure Bot Service-Kanal eine Copilot Studio-Agentenunterhaltung. Anweisungen zum Starten einer neuen Unterhaltung mit dem Bot finden Sie unter Direct Line-Token erhalten und Verwenden von Direct Line zur Kommunikation mit dem Agenten.

   using (var httpRequest = new HttpRequestMessage())
   {   
       httpRequest.Method = HttpMethod.Get;
       UriBuilder uriBuilder = new UriBuilder(TokenEndPoint);
       httpRequest.RequestUri = uriBuilder.Uri;
       using (var response = await s_httpClient.SendAsync(httpRequest))
       {
           var responseString = await response.Content.ReadAsStringAsync();
           string token = SafeJsonConvert.DeserializeObject<DirectLineToken>(responseString).Token;
       }
   }
   
   /// <summary>
   /// class for serialization/deserialization DirectLineToken
   /// </summary>
   public class DirectLineToken
   {
       public string Token { get; set; }
   }
   

    // Use the retrieved token to create a DirectLineClient instance
    using (var directLineClient = new DirectLineClient(token))
    {
        var conversation = await directLineClient.Conversations.StartConversationAsync();
        string conversationtId = conversation.ConversationId;
    }
   

2. Um mehrere Sitzungen zu verwalten, müssen Sie eine Zuordnung der externen Azure Bot Service-Kanalunterhaltungen zu den entsprechenden Copilot Studio-Agentenunterhaltungen beibehalten. Eine Copilot Studio-Agentenunterhaltung kann mit zwei Eigenschaften identifiziert und verbunden werden: ConversationtId und Token.

   Dictionary<string, PowerVirtualAgentsConversation> ConversationRouter = new Dictionary<string, PowerVirtualAgentsConversation>();  
   

   Um den Konversationslebenszyklus zu verwalten, aktualisieren Sie die Direct Line-Tokens oder im Leerlauf befindliche Konversationen bereinigen. Weitere Informationen zur Token-Aktualisierung finden Sie unter Direct Line-Tokens aktualisieren. Eine Copilot Studio-Agentenunterhaltung zur Unterstützung der Aktualisierung Direct Line-Token ist wie folgt definiert:

   /// <summary>
   /// Data model class for Copilot Studio agent conversation
   /// </summary>
   public class PowerVirtualAgentsConversation
   {
       public string ConversationtId { get; set; } // The Copilot Studio agent conversation ID retrieved from step 1
   
       public string Token { get; set; } // The DirectLine token retrieved from step 1
   
       public string WaterMark { get; set; } // Identify turn in a conversation
   
       public DateTime LastTokenRefreshTime { get; set; } = DateTime.Now; // Timestamp of last token refresh
   
       public DateTime LastConversationUpdateTime { get; set; } = DateTime.Now; // Timestamp of last active user message sent to agent
   }
   

3. Wenn eine neue Copilot Studio-Agentenunterhaltung beginnt, fügen Sie ein Schlüsselwertpaar (external_Azure_Bot_Service_channel_conversationID, PowerVirtualAgentsConversation) zur Zuordnungstabelle hinzu.

   // After new Copilot Studio agent conversation starts
   ConversationRouter[external_Azure_Bot_Service_channel_conversationID] = new PowerVirtualAgentsConversation()
     {
       Token = token,
       ConversationtId = conversationId,
       WaterMark = null,
       LastConversationUpdateTime = DateTime.Now,
       LastTokenRefreshTime = DateTime.Now,
     }; 
   

4. Um mit einer vorhandenen Unterhaltung fortzufahren, rufen Sie nach Erhalt einer neuen externen Azure Bot Service-Kanalnachricht die vorhandene Unterhaltung aus der Zuordnungstabelle ab, leiten Sie die externe Unterhaltungsaktivität an Ihren Copilot Studio-Agenten weiter und erhalten eine Antwort.

   Das folgende Beispiel zeigt die Weiterleitung von Konversationen durch Überschreiben der Methode ActivityHandler.OnMessageActivityAsync((ITurnContext<IMessageActivity>, CancellationToken)

   // Invoked when a message activity is received from the user
   // Send the user message to Copilot Studio agent and get response
   protected override async Task OnMessageActivityAsync(ITurnContext<IMessageActivity> turnContext, CancellationToken cancellationToken)
   {
       // Retrieve agent conversation from mapping table
       // If not exists for the given external conversation ID, start a new Copilot Studio agent conversation
       ConversationRouter.TryGetValue(externalCID, out PowerVirtualAgentsConversation currentConversation) ?
               currentConversation : /*await StartBotConversationAsync(externalCID)*/;
   
       // Create DirectLine client with the token associated to current conversation
       DirectLineClient client = new DirectLineClient(currentConversation.Token);
   
       // Send user message using directlineClient
       await client.Conversations.PostActivityAsync(currentConversation.ConversationtId, new DirectLineActivity()
       {
         Type = DirectLineActivityTypes.Message,
         From = new ChannelAccount { Id = turnContext.Activity.From.Id, Name = turnContext.Activity.From.Name },
         Text = turnContext.Activity.Text,
         TextFormat = turnContext.Activity.TextFormat,
         Locale = turnContext.Activity.Locale,
       });
   
       // Update LastConversationUpdateTime for session management
       currentConversation.LastConversationUpdateTime = DateTime.Now;
   }  
   

5. Unter Verwenden von Direct Line zur Kommunikation mit dem Agenten finden Sie Informationen darüber, wie man eine Antwort vom Copilot Studio-Agenten erhält. Wenn Sie die Antwort des Copilot Studio-Agenten empfangen, finden Sie unter Die Unterhaltungsnuztungsdaten vom Agenten analysieren Informationen zum Analysieren der Antwort auf die externe Azure Bot Service-Kanalantwort.

Ein Beispiel für das Parsen von Antworten finden Sie in der Relay-Bot-Beispielcode ResponseConverter.cs.

Für Azure Bot Service bereitstellen

Nachdem Sie Ihren Azure Bot Service-Relay-Bot bereit haben, müssen Sie den Bot für Ihren Azure Bot Service bereitstellen.

Azure Bot Service-Kanäle einrichten

Sie können die Kanäle einrichten, zu denen Sie eine Verbindung herstellen möchten, indem Sie sich beim Azure-Portal anmelden und die Azure Bot Service-Ressourcengruppe auswählen, für die Sie die Bereitstellung durchgeführt haben. Sehen Sie sich die spezifischen Anweisungen für jeden Kanal unter Azure Bot Service-Kanäle an.