Configurar o contexto do axente en Azure agents

Nota

Copilot Studio bot é renomeado como axente Copilot (axente ou axente de IA). O axente humano agora cambia o nome como representante do servizo ao cliente (representante do servizo ou representante). É posible que atopes referencias aos termos antigos e novos mentres actualizamos a IU do produto, a documentación e o contido de formación.

Para axentes de Azure, debes instalar o SDK do axente e instanciar o middleware Omnichannel antes de configurar o contexto do axente.

Instala o bot SDK no teu proxecto

  1. Para abrir o Package Manager NuGet, fai clic dereito no teu proxecto e logo selecciona Xestionar paquetes NuGet.

  2. No Package Manager NuGet, selecciona a fonte do paquete como nuget.org e busca "Microsoft.Dynamics. AxentesSDK.Middleware". Selecciona o paquete e logo selecciona Instalar. Máis información na páxina Nuget.

    Alternativamente, pode usar o seguinte comando en NuGet CLI.

    Install-Package Microsoft.Dynamics.AgentsSDK.Middleware

O SDK do axente xa está instalado e o middleware omnicanal está dispoñible no teu proxecto.

Usa o middleware omnicanal no código do teu axente

  1. Abrir o ficheiro AdapterWithErrorHandler.cs .

  2. Engade a instrución de importación e instanza do middleware omnicanal.

    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;
    }
}

Pasos seguintes

Analizar o JSON da actividade para obter o contexto do axente

Enviar un contexto personalizado
setContextProvider
Integrar un axente de Azure

  • Última actualización o