Partilhar via

Analisar JSON de atividade de 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 ao vivo 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 em seu código de agente

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

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óximos passos

Exemplos de código para analisar a atividade JSON

setContextProvider
Integrar um agente do Azure

  • Last updated on