Twilio Flex Agent Assist Integration

Contexto: arquitectura histórica de integración.

El plugin muestra la experiencia en Flex; las Functions y el conector resuelven otros tramos. Separar esas responsabilidades hace mucho más fácil encontrar dónde se cortó la invocación. (๑•̀ㅂ•́)و✧

Índice

Integración Agent Desktop Mejoras futuras

Integración Agent Desktop

Componentes principales de la integración

Twilio Functions: Un entorno sin servidor para alojar la interfaz de usuario de Agent Assist (un iframe) y las APIs necesarias para la integración.
Twilio Flex Plugin: El componente del lado del cliente que muestra la interfaz de Agent Assist en el escritorio del agente.
UI Connector Backend: El servicio de Google que gestiona la autenticación, la comunicación en tiempo real y la conexión con el motor de Conversational Agents de Agent Assist.

Detalles de los componentes

Twilio Functions

Funciones:
- Alojan el documento HTML (la interfaz de Agent Assist).
- Manejan los métodos de la API para usar Agent Assist.
- Proporcionan la verificación de usuarios, tokens para el servicio de chat y la interfaz de Agent Assist.
Beneficio: Evita la necesidad de alojar la interfaz en un servidor externo.

Twilio Flex Plugin

Funciones:
- Permite construir una experiencia de usuario personalizada para los agentes.
- Muestra la consola de Agent Assist dentro de la aplicación de Twilio Flex.
Flujo de datos: El plugin envía parámetros al backend de Twilio Functions, que a su vez retorna la solución de iframe para la interfaz del agente.
Parámetros de consulta (Query parameters):
- conversation profile
- channelType (voz o chat)
- features (las funcionalidades de Agent Assist que se quieren activar)
- conversation SID (ID de la conversación)
- agent identity (identificador de contexto; por sí solo no verifica pertenencia ni autoriza acceso)

UI Connector Backend

Funciones:
- Autenticación: Utiliza un método de autenticación personalizado para los escritorios de agentes.
- Generación de JWT: Crea tokens web temporales (JSON Web Tokens o JWT) para validar las solicitudes.
- Conexión WebSocket: Establece una conexión en tiempo real con el escritorio del agente para enviar eventos de Agent Assist.
- Manejo de eventos: Recibe y envía notificaciones de eventos desde y hacia el escritorio del agente.

Configuración y despliegue

Requisitos

CLI de Twilio: Con los plugins serverless y Flex plugin instalados.
Variables de entorno: Se deben configurar antes de realizar el despliegue.

Despliegue

Se utilizan dos scripts npm para desplegar la solución:
- deploy plug-in: Despliega el componente del frontend.
- deploy functions: Despliega dos APIs para la autenticación y la interfaz de usuario.

Configuración de voz

Se usa el conector SIP del Marketplace de Twilio.
Se puede configurar en Twilio Studio.
El conector SIP necesita un parámetro llamado conversation que tiene un valor compuesto por el ID del proyecto y el ID de la conversación de Twilio.

Mejoras futuras

Roadmap del curso: los puntos siguientes no se presentan como funciones entregadas ni fechas prometidas. Revisar versión y disponibilidad antes de planificar con ellos.

1. Despliegue y configuración mejorados

Despliegue con un solo clic: Permite un despliegue rápido con una configuración predeterminada.
Integración de CI/CD: Posibilidad de usar GitHub Actions para el despliegue continuo en múltiples entornos, con una configuración mínima.
Variables de entorno: Serán gestionadas a través de una interfaz de administración (Admin UI) en lugar de archivos de configuración. Esto centraliza la configuración.
Gestión de secretos: Se pueden generar secretos para cada entorno (Twilio secret) para gestionar credenciales de manera segura.

2. Funcionalidades en la interfaz de usuario (UI)

Manipulación del UI de Twilio Flex: La integración permitirá manipular la interfaz del agente de Twilio Flex.
Eventos del UI: Se podrán utilizar los eventos de la interfaz para crear una solución más robusta y reaccionar a las acciones del agente.
UI de administración:
- Permite probar la conexión al backend en la nube.
- Permite habilitar o deshabilitar funcionalidades de Agent Assist.
- Permite seleccionar diferentes versiones de los modelos de Agent Assist.

3. Mejoras en funcionalidades específicas de Agent Assist

Respuestas inteligentes (Smart Reply): Las sugerencias aparecerán en un contenedor debajo de la caja de mensajes, permitiendo al agente editar la respuesta antes de enviarla.
Resumen de la conversación (Conversation Summary): Se podrá activar la generación automática de resúmenes al finalizar la conversación.
Asistencia de conocimiento (Knowledge Assist): Se mostrará en el lado derecho de la pantalla del agente para dar soporte a la conversación.

4. Despliegue en múltiples entornos

Soporte multi-entorno: El sistema está diseñado para funcionar en múltiples entornos de forma sencilla (ej. desarrollo, producción).
Gestión de secretos por entorno: Se pueden configurar secretos específicos para cada entorno para una mayor seguridad.

Navegación del módulo

Anterior: 06 Agent Desktop Integration with Salesforce
Siguiente: 08 Conversation Agents runtime integrations

Referencia: Twilio integration basics. Los nombres «deploy plug-in/functions», parámetros y conector de Marketplace requieren la revisión exacta del repositorio. Revisar la autenticación, WebSocket y SIP según la versión del conector. Un parámetro URL no debe llevar secretos ni sustituir la autorización del servidor.

+----------------------------------------+
| Floure &                               |
| Tachibana's guild                      |
| [Hikari · Nozomi · Iona]               |
| SEAL: sha256/12: c1c261f04a47          |
| STATUS: LITURGY_IN_PROGRESS            |
+----------------------------------------+