Condividi tramite

Configurare il contesto dell'agente negli agenti di Azure

Annotazioni

Il bot Copilot Studio viene rinominato come agente Copilot (agente o agente IA). L'agente umano è ora rinominato rappresentante del servizio clienti (rappresentante o rappresentante del servizio). Potresti imbatterti in riferimenti ai termini vecchi e nuovi mentre aggiorniamo l'interfaccia utente, la documentazione e i contenuti di formazione del prodotto.

Per gli agenti di Azure, è necessario installare l'SDK dell'agente e creare un'istanza del middleware Omnichannel prima di configurare il contesto dell'agente.

Installare bot SDK nel progetto

  1. Per aprire Gestione pacchetti NuGet, fare clic con il pulsante destro del mouse sul progetto e quindi scegliere Gestisci pacchetti NuGet.

  2. In Gestione pacchetti NuGet selezionare l'origine del pacchetto come nuget.org e cercare "Microsoft.Dynamics.AgentsSDK.Middleware". Selezionare il pacchetto e quindi selezionare Installa. Altre informazioni sono disponibili nella pagina NuGet.

    In alternativa, è possibile usare il comando seguente nell'interfaccia della riga di comando di NuGet.

    Install-Package Microsoft.Dynamics.AgentsSDK.Middleware

L'SDK dell'agente è ora installato e il middleware Omnichannel è disponibile nel progetto.

Usare il middleware Omnichannel nel codice dell'agente

  1. Aprire il file AdapterWithErrorHandler.cs .

  2. Aggiungi l'istruzione di importazione e crea un'istanza del middleware Multicanale.

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

Passaggi successivi

Analizzare il codice JSON dell'attività per ottenere il contesto dell'agente

Inviare un contesto personalizzato
setContextProvider
Integrare un agente di Azure

  • Last updated on