Configurar la transferencia a un centro de interacción genérico

Copilot Studio le permite transferir conversaciones agente de manera fluida y contextualizada a un humano agente a través de un centro de interacción.

Con un poco de desarrollo personalizado, puedes configurar tu agente para transferir conversaciones a cualquier centro de interacción. Esta guía describe cómo puede hacer esto.

Requisitos previos

• Debes haber creado un agente usando . Copilot Studio
• Necesita un centro de interacción que pueda interactuar mediante programación mediante API o SDK.

Importante

Algunas instrucciones de esta sección requieren que usted o sus desarrolladores realicen tareas de desarrollo de software. Está destinado a profesionales de TI con experiencia, como administradores de TI o desarrolladores que tienen una sólida comprensión de las herramientas de desarrollo, las utilidades y los entornos de desarrollo integrado (IDE) y que consideren integrar centros de interacción de terceros con Copilot Studio.

Introducción

Una transferencia completa a un centro de interacción sigue este patrón:

1. Un usuario final interactúa con el lienzo de chat del centro de interacción.

2. El centro de interacción dirige el chat entrante a través de capacidades de enrutamiento de chat integradas a un agente.

3. Un adaptador personalizado retransmite los mensajes de chat entrantes desde el centro de interacción a un Copilot Studio agente.

4. Una vez que el usuario final desencadene la transferencia, Copilot Studio comienza la transferencia con un contexto de conversación completo.

5. El adaptador personalizado intercepta el mensaje de transferencia, analiza el contexto completo de la conversación y enruta sin problemas la conversación derivada a un agente humano experto, según la disponibilidad.

6. El chat del usuario final se transfiere de manera ágil y contextual a un agente humano que puede reanudar la conversación.

Para transferir la conversación a un agente humano, debe crear un adaptador de transferencias personalizado.

Cree un adaptador de transferencias personalizado

Un adaptador conecta conversaciones hacia y desde su centro de interacción agente al transmitir y transformar mensajes entre usuarios finales, agentes y agentes humanos.

Los centros de participación de agentes más populares proporcionan kits de desarrollo de software (SDK) o documentan sus API públicamente, lo que le permite construir dichos adaptadores.

Está fuera del alcance de este documento cubrir lo que podría contener un adaptador personalizado. Sin embargo, el siguiente mensaje de handoff de muestra, basado en lo que Copilot Studio se genera como parte de nuestra experiencia de transferencia estándar a un agente por chat, puede ayudarlo a comenzar.

Estos fragmentos de código y muestras le permiten extraer contexto de la conversación para transferir de manera fluida y contextualizada las conversaciones agente a cualquier centro de interacción genérico.

Ejemplo de carga útil de mensajes de transferencia

El traspaso solo se admite actualmente a través de Direct Line. Obtenga más información sobre cómo interactuar con un agente . Direct Line Tras la transferencia, una actividad de evento llamada handoff.initiate se eleva y se envía al adaptador.

Puede ver un ejemplo completo de actividad de mensajes de transferencia en nuestro sitio de GitHub.

Extraer contexto del mensaje de transferencia

Para usar contexto conversacional, debe analizar la actividad del evento handoff.initiate del evento. El siguiente fragmento de código analiza la actividad del evento handoff.initiate y extrae el contexto conversacional. Vea el ejemplo completo de código en GitHub.

public void InitiateHandoff(string botresponseJson)
{
    BotResponse response = JsonConvert.DeserializeObject<BotResponse>(botresponseJson);

    // Look for Handoff Initiate Activity. This indicates that conversation needs to be handed off to agent
    Activity handoffInitiateActivity = response.Activities.ToList().FirstOrDefault(
        item => string.Equals(item.Type, ActivityTypes.Event, System.StringComparison.Ordinal)
        && string.Equals(item.Name, HandoffInitiateActivityName, System.StringComparison.Ordinal));

    if (handoffInitiateActivity != null)
    {
        // Read transcript from attachment
        if (handoffInitiateActivity.Attachments?.Any() == true)
        {
            Attachment transcriptAttachment = handoffInitiateActivity.Attachments.FirstOrDefault(a => string.Equals(a.Name.ToLowerInvariant(), TranscriptAttachmentName, System.StringComparison.Ordinal));
            if (transcriptAttachment != null)
            {
                Transcript transcript = JsonConvert.DeserializeObject<Transcript>(transcriptAttachment.Content.ToString());
            }
        }

        // Read handoff context
        HandoffContext context = JsonConvert.DeserializeObject<HandoffContext>(handoffInitiateActivity.Value.ToString());

        // Connect to Agent Hub
        // <YOUR CUSTOM ADAPTER CODE GOES HERE>
    }
}