Analitzar JSON d'activitat d'esdeveniment per obtenir el context de l'agent

Els missatges contextuals al Centre de Contacte de Dynamics 365 s'envien com a activitat d'esdeveniment als agents d'IA. La informació de context, com ara la informació del client, l'element de treball en directe o l'identificador de conversa, s'envia a l'agent com a part d'un JSON d'activitat. L'Activitat és del tipus startConversation per als agents de Copilot Studio i omnichannelSetContext per als agents Azure.

Obtenir i utilitzar el context dels agents al codi de l'agent

Per processar aquests missatges de context, utilitzeu controladors d'activitat i substituïu-los al codi de l'agent. Per obtenir informació sobre com utilitzar els controladors d'activitats, vegeu Converses basades en esdeveniments mitjançant un controlador d'activitats.

En l'exemple següent, quan es rep l'activitat d'esdeveniment, es crida el OnEventActivityAsync mètode per obtenir i utilitzar el context.

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

Passos següents

Exemples de codi per a l'activitat d'anàlisi JSON

setContextProvider
Integrar un agent de l'Azure