Analizar JSON de actividad de eventos para obtener el contexto del agente

Los mensajes contextuales en Dynamics 365 Contact Center se envían como actividad de eventos a los agentes de IA. La información de contexto, como la información del cliente, el elemento de trabajo activo o el identificador de conversación, se envía al agente como parte de un JSON de actividad. El JSON puede ser de tipo startConversation para la mayoría de los canales y ConversationUpdate para las conversaciones de voz.

Obtener y usar contexto para agentes en el código de agente

Para procesar estos mensajes de contexto, use controladores de actividad y anule en el código del agente. Para obtener información sobre cómo usar controladores de actividad, consulte Conversaciones controladas por eventos mediante un controlador de actividad.

En el ejemplo siguiente, cuando se recibe la actividad de evento, OnEventActivityAsync se llama al método para capturar y usar el 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);
    }
}

Pasos siguientes

Ejemplos de código para analizar JSON de actividad

Información relacionada

setContextProvider
Integrar un agente de Azure