Udostępnij przez

Konfigurowanie kontekstu agenta w agentach platformy Azure

Uwaga / Notatka

Nazwa bota Copilot Studio zostanie zmieniona na agent funkcji Copilot (agent lub agent AI). Nazwa człowieka agent została zmieniona na przedstawiciela działu obsługi klienta (przedstawiciela działu obsługi klienta lub przedstawiciela). Możesz natknąć się na odwołania do starych i nowych terminów podczas aktualizowania interfejsu użytkownika, dokumentacji i zawartości szkoleniowej produktu.

W przypadku agentów platformy Azure należy zainstalować SDK agenta i zainicjować middleware Omnichannel przed skonfigurowaniem kontekstu agenta.

Instalowanie zestawu SDK bota w projekcie

  1. Aby otworzyć Menedżera pakietów NuGet, kliknij prawym przyciskiem myszy projekt, a następnie wybierz polecenie Zarządzaj pakietami NuGet.

  2. W Menedżerze pakietów NuGet wybierz źródło pakietu nuget.org i wyszukaj "Microsoft.Dynamics.AgentsSDK.Middleware". Wybierz pakiet, a następnie wybierz pozycję Zainstaluj. Dowiedz się więcej na stronie Nuget.

    Alternatywnie możesz użyć następującego polecenia w interfejsie wiersza polecenia NuGet.

    Install-Package Microsoft.Dynamics.AgentsSDK.Middleware

Zestaw SDK agenta jest teraz zainstalowany, a oprogramowanie pośredniczące Omnichannel jest dostępne w projekcie.

Użyj oprogramowania pośredniczącego Omnichannel w kodzie agenta

  1. Otwórz plik AdapterWithErrorHandler.cs .

  2. Dodaj instrukcję importu i zainstancjuj oprogramowanie pośredniczące 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;
    }
}

Dalsze kroki

Analizowanie JSON aktywności aby uzyskać kontekst agenta

Wyślij kontekst niestandardowy
setContextProvider
Integracja agenta Azure

  • Last updated on