Parsa händelseaktivitets-JSON för att hämta agentkontext

Kontextmeddelandena i Dynamics 365 Contact Center skickas som händelseaktivitet till AI-agenter. Kontextinformation, till exempel kundinformation, pågående arbetsobjekt eller konversations-ID, skickas till handläggaren som en del av en aktivitets-JSON. Aktiviteten är av typen startConversation för Copilot Studio-agenter och omnichannelSetContext för Azure-agenter.

Hämta och använd kontext för agenter i din agentkod

Om du vill bearbeta dessa kontextmeddelanden använder du aktivitetshanterare och åsidosätter dem i agentkoden. Information om hur du använder aktivitetshanterare finns i Händelsedrivna konversationer med hjälp av en aktivitetshanterare.

I följande exempel, när händelseaktiviteten tas emot, OnEventActivityAsync anropas metoden för att hämta och använda kontexten.

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

Nästa steg

Kodexempel för parsning av JSON-aktivitet

setContextProvider
Integrera en Azure agent

  • Last updated on