Compartilhar via


Analise o JSON da atividade do evento para obter o contexto do agente

As mensagens de contexto no Dynamics 365 Contact Center são enviadas como atividade de evento para agentes de IA. Informações de contexto, como informações do cliente, item de trabalho ativo ou ID de conversa, são enviadas ao agente como parte de um JSON de atividade. O JSON pode ser do tipo startConversation para a maioria dos canais e ConversationUpdate para conversas de voz.

Buscar e usar o contexto para agentes no código do agente

Para processar essas mensagens de contexto, use manipuladores de atividades e substitua-os no código do agente. Para obter informações sobre como usar manipuladores de atividades, consulte Conversas controladas por eventos usando um manipulador de atividades.

No exemplo a seguir, quando a atividade de evento é recebida, o OnEventActivityAsync método é chamado para buscar e usar o contexto.

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

Próximas etapas

Exemplos de código para analisar a atividade JSON

setContextProvider
Integrar um agente do Azure