Ρυθμίστε το πλαίσιο του πράκτορα στους πράκτορες Azure

Σημείωμα

Το bot Copilot Studio μετονομάζεται σε πράκτορα Copilot (ή πράκτορας AI). Ο ανθρώπινος παράγοντας μετονομάζεται πλέον σε αντιπρόσωπος υπηρεσίας εξυπηρέτησης πελατών (αντιπρόσωπος υπηρεσίας ή αντιπρόσωπος). Ενδέχεται να συναντήσετε αναφορές στους παλιούς και νέους όρους κατά την ενημέρωση του περιβάλλοντος εργασίας χρήστη, της τεκμηρίωσης και του εκπαιδευτικού περιεχομένου του προϊόντος.

Για τους πράκτορες Azure, πρέπει να εγκαταστήσετε το agent SDK και να ξεκινήσει το μεσαίο λογισμικό Omnichannel προτού ρυθμίσετε τις παραμέτρους του πλαισίου του πράκτορα.

Εγκατάσταση του bot SDK στο έργο σας

1. Για να ανοίξετε το Διαχείριση πακέτου NuGet, κάντε δεξί κλικ στο έργο σας και, στη συνέχεια, επιλέξτε Διαχείριση πακέτων NuGet.

2. Στη Διαχείριση πακέτων NuGet, επιλέξτε την προέλευση πακέτου ως nuget.org και αναζητήστε το "Microsoft.Dynamics.AgentsSDK.Middleware". Επιλέξτε το πακέτο και, στη συνέχεια, επιλέξτε Εγκατάσταση. Μάθετε περισσότερα στη σελίδα nuget.

   Εναλλακτικά, μπορείτε να χρησιμοποιήσετε την ακόλουθη εντολή στο NuGet CLI.

   Install-Package Microsoft.Dynamics.AgentsSDK.Middleware
   

Το SDK του παράγοντα είναι τώρα εγκατεστημένο και το μεσαίο λογισμικό omnichannel είναι διαθέσιμο στο έργο σας.

Χρήση του πανκαναλικού μεσαίου λογισμικού στον κωδικό πράκτορά σας

1. Ανοίξτε το αρχείο AdapterWithErrorHandler.cs .

2. Προσθέστε τη δήλωση εισαγωγής και ενεργοποιήστε το middleware Omnichannel.

   using Microsoft.Dynamics.AgentsSDK.Middleware.Core; 
   Use(new OmnichannelMiddleware()); 
   

   using System.Globalization;
   using System.Text;
   using Microsoft.Agents.Connector;
   using Microsoft.Agents.Core;
   using Microsoft.Agents.Core.Errors;
   using Microsoft.Extensions.Logging;
   using Microsoft.Dynamics.AgentsSDK.Middleware.Core;
   
   namespace Microsoft.CCaaS.MessagingRuntime.TestAgent;
   
   public class AdapterWithErrorHandler : CloudAdapter
   {
       public AdapterWithErrorHandler(
           IChannelServiceClientFactory channelServiceClientFactory,
           IActivityTaskQueue activityTaskQueue,
           ILogger<CloudAdapter> logger)
           : base(channelServiceClientFactory, activityTaskQueue, logger)
       {
           // OmnichannelMiddleware has special handling for OC event messages
           Use(new OmnichannelMiddleware());
   
           OnTurnError = async (turnContext, exception) =>
           {
               var exceptionInfo = GetExceptionInfo(exception);
               logger.LogAppException(exceptionInfo, exception);
   
               // Send a message to the user
               await turnContext.SendActivityAsync($"The bot encountered an error or bug.{Environment.NewLine}{exceptionInfo}");
               await turnContext.SendActivityAsync("To continue to run this bot, please fix the bot source code.");
   
               // Send a trace activity, which will be displayed in the Bot Framework Emulator
               await turnContext.TraceActivityAsync("OnTurnError Trace", exception.Message, "https://www.botframework.com/schemas/error", "TurnError");
           };
       }
   
       private static string GetExceptionInfo(Exception exception)
       {
           var sb = new StringBuilder();
   
           // Pull some well known info from ErrorResponse.Exception if available.
           if (exception is ErrorResponseException responseException)
           {
               sb.AppendLine(CultureInfo.InvariantCulture, $"Error code: {responseException.Body?.Error?.Code ?? "NA"}");
               sb.AppendLine(CultureInfo.InvariantCulture, $"Error message: {responseException.Body?.Error?.Message ?? "NA"}");
           }
   
           sb.AppendLine(CultureInfo.InvariantCulture, $"Exception message: {exception.Message}");
           sb.AppendLine();
           sb.AppendLine(exception.ToString());
   
           var exceptionInfo = sb.ToString();
           return exceptionInfo;
       }
   }
   

Επόμενα βήματα

Ανάλυση JSON δραστηριότητας για λήψη περιβάλλοντος παράγοντα

Σχετικές πληροφορίες

Αποστολή προσαρμοσμένου πλαισίου
setContextProvider
Ενσωμάτωση ενός παράγοντα Azure