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

I messaggi contestuali nel Contact Center di Dynamics 365 vengono inviati come attività di evento agli agenti IA. Le informazioni contestuali, ad esempio le informazioni sul cliente, l'elemento di lavoro attivo o l'ID conversazione, vengono inviate all'agente come parte di un JSON di attività. Il codice JSON può essere di tipo startConversation per la maggior parte dei canali e ConversationUpdate per le conversazioni vocali.

Recuperare e utilizzare il contesto per gli agenti nel codice dell'agente

Per elaborare questi messaggi di contesto, utilizzare i gestori di attività ed eseguirne l'override nel codice dell'agente. Per informazioni su come utilizzare i gestori di attività, vedere Conversazioni basate su eventi tramite un gestore di attività.

Nell'esempio seguente, quando viene ricevuta l'attività evento, viene chiamato il OnEventActivityAsync metodo per recuperare e utilizzare il contesto.

namespace Microsoft.CCaaS.MessagingRuntime.TestAgent.Agents;

public class TestAgentApplication : AgentApplication
{
    private readonly IContextManager _contextManager;

    public TestAgentApplication(AgentApplicationOptions options, IContextManager contextManager) : base(options)
    {
        _contextManager = contextManager ?? throw new ArgumentNullException(nameof(contextManager));
        OnConversationUpdate(ConversationUpdateEvents.MembersAdded, OnMembersAddedAsync);
        OnEvent(ActivityTypes.Event, OnEventActivityAsync);
        OnActivity(ActivityTypes.Message, OnMessageActivityAsync, rank: RouteRank.Last);
    }

    protected async Task OnMessageActivityAsync(ITurnContext turnContext, ITurnState turnState, CancellationToken cancellationToken)
    {
        ArgumentNullException.ThrowIfNull(turnContext);
        var text = turnContext.Activity.Text?.ToLower(CultureInfo.InvariantCulture);
        var responseActivity = Activity.CreateMessageActivity();
        Responses.BuildCustomerFileAttachmentResponse(turnContext, responseActivity);
    }
}

Passaggi successivi

Esempi di codice per l'analisi dell'attività JSON

Informazioni pertinenti

setContextProvider
Integrare un agente di Azure