Analizar o JSON da actividade do evento para obter o contexto do axente

As mensaxes contextuais no Centro de Contacto de Dynamics 365 envíanse como actividade de evento aos axentes de IA. A información de contexto, como a información do cliente, o elemento de traballo en directo ou o ID de conversa, envíase ao axente como parte dun JSON de actividade. A actividade é do tipo startConversation para axentes de Copilot Studio e omnichannelSetContext para axentes Azure.

Obter e usar o contexto para os axentes no código do axente

Para procesar estas mensaxes de contexto, use xestores de actividades e ignoralos no código do axente. Para obter información sobre como usar os xestores de actividades, consulte Conversas dirixidas por eventos usando un xestor de actividades.

No seguinte exemplo, cando se recibe a actividade do evento, chámase o OnEventActivityAsync método para obter 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);
    }
}

Pasos seguintes

Exemplos de código para a análise da actividade JSON

setContextProvider
Integrar un axente de Azure