Compartir a través de

Configuración del contexto del agente en agentes de Azure

Nota:

El bot pasa de Copilot Studio a llamarse agente de Copilot (agente o agente de IA). El agente humano ahora pasa a llamarse representante del servicio al cliente (representante de servicio o representante). Es posible que encuentre referencias a los términos antiguos y nuevos mientras actualizamos la interfaz de usuario, la documentación y el contenido de formación del producto.

Para los agentes de Azure, debe instalar el SDK del agente y crea instancias del middleware omnicanal antes de configurar el contexto del agente.

Instalación del SDK del bot en el proyecto

  1. Para abrir el Administrador de paquetes NuGet, haga clic con el botón derecho en el proyecto y seleccione Administrar paquetes NuGet.

  2. En el Administrador de paquetes NuGet, seleccione el origen del paquete como nuget.org y busque "Microsoft.Dynamics.AgentsSDK.Middleware". Seleccione el paquete y, a continuación, seleccione Instalar. Obtenga más información en la página Nuget.

    Como alternativa, puede usar el siguiente comando en la CLI de NuGet.

    Install-Package Microsoft.Dynamics.AgentsSDK.Middleware

El SDK del agente ahora está instalado y el middleware omnicanal está disponible en el proyecto.

Usa el middleware omnicanal en el código del agente

  1. Abra el archivo AdapterWithErrorHandler.cs .

  2. Agregue la instrucción import y cree una instancia del 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;
    }
}

Pasos siguientes

Análisis del JSON de la actividad para obtener el contexto del agente

Enviar contexto personalizado
setContextProvider
Integrar un agente de Azure

  • Last updated on