Sistema Multi-Agente de MIMI: Guía de Uso y Configuración

1. ¿Qué significa Multi-Agente?

Una misma empresa puede operar múltiples agentes de voz de Inteligencia Artificial dentro de la misma cuenta de MIMI.

• Cada agente puede gestionar tanto llamadas entrantes (*inbound*) como salientes (*outbound*).
• El espacio de trabajo multi-agente permite a la empresa administrar *prompts* específicos, llamadas, estadísticas, configuraciones de llamadas salientes, números telefónicos y registros vinculados desde una sola cuenta.

Ejemplo Práctico:

• Agente Principal (Main Agent): Es el agente predeterminado de la empresa. Puede atender y realizar llamadas utilizando el Número Principal de la Empresa.
• Agente de Tax / Contabilidad (Tax Agent): Es un segundo agente dentro de la misma empresa. Puede atender y realizar llamadas utilizando el Número de Tax.
• Agente Predeterminado = Agente Principal: El Agente Predeterminado es el Agente Principal de la empresa. Es el agente primario y se utiliza como el respaldo principal (fallback) cuando aplique un comportamiento de reserva.

2. Espacio de Trabajo Multi-Agente (Multi-Agent Workspace)

El Selector de Agentes (ubicado en la barra superior de la plataforma) permite al administrador desplazarse entre los diferentes espacios de trabajo de cada agente sin necesidad de crear cuentas de empresa independientes.

Lo que está disponible y se administra por cada Agente:

• Prompts y configuración de OpenAI: Se gestionan específicamente para el agente seleccionado.
• Historial de Llamadas: Asociado directamente al agente que gestionó la interacción.
• Analíticas y Estadísticas: Se muestran en el contexto del agente seleccionado.
• Llamadas Salientes (Outbound): Cada agente puede tener su propia configuración de salidas.
• Números de Teléfono: Se pueden asignar diferentes números telefónicos a distintos agentes.
• Advertencia de Salud / Cuota de OpenAI: Muestra el estado de la cuota según el agente seleccionado.

📌 Aclaración Útil de Rutas: El Selector de Agentes únicamente cambia tu espacio de trabajo administrativo en pantalla. Por sí solo, no decide qué agente responde una llamada entrante. El enrutamiento de llamadas entrantes utiliza el número telefónico configurado. Las llamadas salientes utilizan el agente asignado a la tarea saliente.

3. Conexiones Compartidas y Configuración de Agentes

Ciertas conexiones de proveedores permanecen compartidas a nivel de empresa (Tenant), mientras que las configuraciones de soporte del agente se gestionan en su espacio de trabajo individual:

--Twilio:

• La conexión de la cuenta de Twilio es compartida por toda la empresa.
• Se pueden asignar distintos números telefónicos de Twilio a diferentes agentes (Ej. Número Principal > Agente Principal | Número Tax > Agente Tax).

--Google Calendar:

• La conexión de la cuenta de Google es compartida a nivel de empresa.
• Los agentes pueden utilizar su selección de calendario configurada para agendar citas (Ej. Agente Principal > Calendario Oficina Principal | Agente Tax > Calendario Tax).

--Microsoft Calendar:

• La conexión de Microsoft Calendar permanece como una conexión a nivel de empresa cuando se utiliza.

--Google Sheets para Llamadas Salientes (Outbound):

• La conexión de Google Sheets es compartida por la empresa.
• Cada agente puede utilizar su propia hoja o pestaña configurada para los datos de salidas.

--Horarios de Atención y Programación:

• Se pueden utilizar anulaciones de horarios de atención (*Business Hours*) y reglas de agendamiento específicas por agente donde estén configuradas.

--Ajustes de Websocket (Websocket Settings):

• Los ajustes del Websocket se administran dentro del contexto del agente seleccionado.

4. Llamadas Entrantes y Salientes

--Llamadas Entrantes (Inbound)

Se enrutan principalmente por el número de teléfono al que llama el cliente (Ej. *Número Principal* > *Agente Principal* | *Número Tax* > *Agente Tax*). Una vez que se resuelve el agente, MIMI utiliza el *prompt* correspondiente de dicho agente y sus configuraciones de ejecución.

--Llamadas Salientes (Outbound)

Cada agente puede realizar llamadas salientes. La tarea saliente (*job*) se asigna a un agente y MIMI carga la configuración saliente de dicho agente.

• Agente Principal: Puede recibir llamadas en el Número Principal y realizar llamadas salientes utilizando su configuración de salida.
• Agente de Tax: Puede recibir llamadas en el Número de Tax y realizar llamadas salientes utilizando su configuración de salida propia.

--Registros y Estadísticas

Los registros de llamadas y las estadísticas visibles se asocian al agente correspondiente para que el administrador pueda revisar la actividad de forma organizada.

5. WhatsApp y Actividad Post-Llamada

• WhatsApp Post-Llamada: Utiliza la sesión conectada del agente que gestionó esa llamada. Esto mantiene la actividad confirmada de WhatsApp alineada con el contexto del agente correspondiente.
• Conexión de WhatsApp: La integración principal de WhatsApp sigue siendo parte de la configuración a nivel de empresa.
• Triggers / Disparadores Post-Llamada: Pueden utilizar una configuración específica por agente cuando exista. Si un agente no tiene su propia configuración para ese elemento, MIMI utilizará el *trigger* predeterminado/compartido.
• Estado de Cuota de OpenAI: La advertencia de cuota/salud mostrada en el panel refleja el agente seleccionado actualmente.

6. Configuración Simple de un Agente (Paso a Paso)

• Paso 1 - Crear y Seleccionar el Agente: Dirígete a la sección **Agents** en el menú lateral, haz clic en **New agent**, créalo, actívalo y selecciónalo desde el Selector de Agentes.
• Paso 2 - Establecer el Agente Principal: Define el Agente Predeterminado (*Default Agent*) que actuará como Agente Principal.
• Paso 3 - Configurar Prompt y Ajustes de OpenAI: Configura las instrucciones (*prompt*) y los ajustes de OpenAI para el agente seleccionado.
• Paso 4 - Asignar el Número de Teléfono: Asigna el número telefónico correcto al agente desde la cuenta compartida de Twilio.
• Paso 5 - Configurar Calendario y Horarios: Selecciona el proveedor de calendario (Google o Microsoft), asigna el ID del calendario y configura los horarios comerciales u homologaciones de agendamiento.
• Paso 6 - Configurar Llamadas Salientes (Outbound): Define la configuración de salida para el agente seleccionado.
• Paso 7 - Configurar Hoja/Pestaña Saliente: Utiliza la conexión compartida de Google Sheets y configura la hoja o pestaña utilizada para los datos de llamadas salientes de ese agente.
• Paso 8 - Configurar Triggers si es Necesario: Utiliza un *trigger* específico para el agente cuando se requiera; de lo contrario, se usará el *trigger* predeterminado/compartido.
• Paso 9 - Revisar el Panel del Agente: Revisa las llamadas, estadísticas, actividad saliente y la información de cuota/salud de OpenAI para el agente seleccionado.

7. Resumen Final de Funciones

• Workspace Multi-Agente: Permite a una empresa gestionar múltiples agentes de IA desde la misma cuenta.
• Llamadas: Cada agente puede gestionar llamadas entrantes y salientes.
• Agente Predeterminado: Actúa como el Agente Principal.
• Selector de Agentes: Cambia entre espacios de trabajo.
• Prompts / OpenAI: Disponibles individualmente por agente.
• Analíticas / Logs: Filtrados por el contexto del agente activo.
• Conexiones Compartidas de Empresa: La cuenta de Twilio, la conexión de Microsoft Calendar, la conexión de SMTP y la integración principal de WhatsApp permanecen a nivel de empresa. Esto mantiene centralizada la configuración del proveedor mientras separa el espacio de trabajo de cada agente.