Sdílet prostřednictvím

Konfigurace kontextu agenta v agentech Azure

Poznámka:

Produkt Copilot Studio bot se přejmenuje na agenta Copilot (agent nebo AI agent). Lidský agent je nyní přejmenován na zástupce zákaznického servisu (zástupce servisu nebo zástupce). Odkazy na staré a nové termíny můžete narazit při aktualizaci uživatelského rozhraní produktu, dokumentace a obsahu školení.

Pro Azure agenty musíte před konfigurací kontextu agenta nainstalovat sadu SDK agenta a vytvořit instanci middlewaru Omnichannel.

Instalace sady SDK robota v projektu

  1. Pokud chcete otevřít Package Manager NuGet, klikněte pravým tlačítkem na projekt a vyberte Spravované balíčky NuGet.

  2. V Package Manager NuGet vyberte zdroj balíčku jako nuget.org a vyhledejte microsoft.Dynamics. AgentsSDK.Middleware. Vyberte balíček a pak vyberte Nainstalovat. Další informace najdete na stránce Nuget.

    Alternativně můžete v rozhraní příkazového řádku NuGet použít následující příkaz.

    Install-Package Microsoft.Dynamics.AgentsSDK.Middleware

Sada SDK agenta je teď nainstalovaná a middleware Omnichannel je k dispozici ve vašem projektu.

Použití middlewaru Omnichannel v kódu agenta

  1. Otevřete soubor AdapterWithErrorHandler.cs .

  2. Přidejte příkaz importu a vytvořte instanci middlewaru 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;
    }
}

Další kroky

Parsování kódu JSON aktivity za účelem získání kontextu agenta

Odeslat vlastní kontext
setContextProvider
Integrace agenta Azure

  • Last updated on