Configuración avanzada del agente
La configuración avanzada controla cómo procesa entradas el agente, cómo responde, qué protecciones aplica y cómo se vincula con servicios nativos como Nexus CRM. Revisala después de definir el rol, cargar conocimiento y conectar los canales.
Nexus CRM nativo
La tarjeta Nexus CRM conecta el agente con un workspace de CRM para sincronizar contactos, conversaciones de Inbox y eventos comerciales sin agregar una tool manual. Esta conexión vive en Agentes → [tu agente] → Configuración y es distinta de los nodos o tools de Nexus CRM que se usan dentro de workflows.
Activar la integración
- Abrí Agentes y seleccioná el agente.
- Entrá en Configuración.
- Desplegá la tarjeta Nexus CRM.
- Activá Estado.
- Elegí la Conexión y el Tenant de Nexus.
- Configurá qué datos se sincronizan y qué canales pueden crear contactos.
- Guardá con Guardar Nexus.
Conexión y credencial
| Campo | Uso |
|---|---|
| Cuenta Nexus conectada | Usa la cuenta Nexus vinculada al owner del agente. Es la opción recomendada cuando el mismo workspace de Atendium y Nexus ya están relacionados. |
| Credencial del agente | Usa una credencial nexus_api_key específica para ese agente. Elegila cuando el agente deba operar contra otro tenant o cuando Nexus entregue una clave S2S dedicada. |
| Tenant | Define el workspace de Nexus CRM donde se van a crear o actualizar registros. |
| Crear S2S / Cargar credencial S2S | Guarda una API key S2S de Nexus como credencial segura del agente. No pegues esa clave en instrucciones, recursos, notas ni tickets. |
Si al activar la integración se muestra un error de credencial, verificá que el owner tenga Nexus conectado o cargá una credencial S2S válida para el agente.
Qué sincronizar
| Opción | Resultado |
|---|---|
| Contactos | Crea o actualiza contactos de Nexus usando la identidad detectada en la conversación. |
| Inbox | Registra mensajes de la conversación en el Inbox de Nexus para mantener el historial comercial. |
| Eventos | Envía eventos comerciales o de actividad configurados para el agente. |
Podés activar solo las partes que necesitás. Por ejemplo, un agente de soporte puede sincronizar Inbox sin registrar eventos comerciales, mientras un agente de ventas suele activar contactos, Inbox y eventos.
Actualizar datos durante la conversación
Con Contactos activo, podés habilitar Actualizar datos del contacto durante la conversación. Está desactivado por defecto.
En los turnos conversacionales de agentes legacy y nodos agente de workflows, el mismo modelo que redacta la respuesta puede capturar nombre, apellido, email, teléfono y los campos personalizados de contactos configurados en el tenant. No agrega una llamada de extracción ni obliga al agente a preguntar los campos faltantes. Los campos de empresas y los identificadores internos no se capturan.
Los datos se validan y sincronizan en segundo plano. Se completan campos vacíos; para reemplazar un valor existente, el usuario debe expresar una corrección explícita. No se borran datos por omisión. Si todavía no se puede crear el contacto según la política del canal, la captura queda pendiente hasta contar con los identificadores necesarios. Ante fallos de Nexus, se reintenta automáticamente.
La captura interna no se muestra al usuario. Cuando está habilitada, la respuesta se entrega después de procesar la salida estructurada, sin transmitir el JSON interno por streaming. Requiere un modelo compatible con salida JSON estructurada. Las respuestas estáticas y los turnos que terminan directamente en una herramienta no disparan una llamada adicional para capturar datos.
Políticas por canal
Cada canal puede habilitarse o deshabilitarse para Nexus CRM y definir cuándo se permite crear un contacto nuevo.
| Política | Cuándo usarla |
|---|---|
| Identificador del canal | Para canales con identidad propia suficiente, como WhatsApp Business, Telegram o Voz. |
| Email o teléfono | Para Web, Instagram, Facebook Messenger o Webhook cuando el agente puede pedir cualquiera de los dos datos antes de crear el contacto. |
| Cuando el proceso exige email como identificador principal. | |
| Teléfono | Cuando el proceso exige teléfono como identificador principal. |
| Email y teléfono | Cuando necesitás ambos datos antes de crear un contacto. |
Desactivá un canal si no querés que sus conversaciones alimenten Nexus CRM. Si lo dejás activo con una política estricta, el agente debe pedir los datos faltantes antes de crear o actualizar el contacto.
Eventos
Cuando Eventos está activo, podés completar reglas por tipo de evento. Usá una clave estable en eventKey y, si Nexus ya tiene una definición creada, agregá el definitionId correspondiente. Mantené nombres consistentes entre ambientes para poder auditar campañas, oportunidades, derivaciones y acciones del agente.
Multimedia entrante
Cada tipo de medio puede configurarse por separado:
| Acción | Resultado |
|---|---|
| Rechazar | El agente no incorpora ese tipo de archivo. |
| Recibir o guardar | El archivo queda asociado a la conversación sin análisis de IA. |
| Procesar | La IA analiza el contenido y usa el resultado durante la conversación. |
La disponibilidad depende del formato, el modelo y el plan. Configurá imágenes y documentos según el tipo de información que realmente necesitás extraer.
Prompts para imágenes y documentos
Elegí Prompt por defecto para un análisis general o Prompt personalizado para dirigir la extracción.
Un buen prompt indica:
- Qué clase de material espera.
- Qué campos debe extraer.
- Qué formato debe devolver.
- Qué hacer cuando un dato no está visible.
- Qué información debe ignorar.
Ejemplo para imágenes
Analizá la imagen como comprobante de pago. Extraé monto, moneda, fecha, nombre visible y número de operación. Si un dato no aparece con claridad, indicalo sin inferirlo.
Ejemplo para documentos
Leé el documento como una orden de compra. Identificá proveedor, fecha, productos, cantidades, total y condiciones. No completes campos ausentes.
Calidad y seguridad
- Moderación: limita temas o contenido no permitido.
- Verificación de alucinaciones: reduce respuestas no respaldadas por contexto o tools.
- Reglas del agente: definen límites, derivaciones y condiciones de respuesta.
- Bloqueo y etiquetado: clasifican conversaciones y pueden detener futuras respuestas.
Estilo de respuesta
Configurá idioma, zona horaria, rol, Character, tono, longitud, emojis y stickers. Cuando existe estilo por canal, usalo para adaptar formato sin duplicar la identidad principal.
Canales y workflows
Revisá qué agente responde en cada canal y cuál workflow está activo. Un cambio de workflow puede alterar tools, variables, recursos, esperas y derivaciones aunque las instrucciones generales del agente no cambien. Para cambiarlo, trabajá primero en Borrador, probalo y confirmá el estado de guardado antes de activarlo.
Mantenimiento
Antes de eliminar un agente revisá canales, automatizaciones, seguimientos, workflows, conversaciones, credenciales, recursos compartidos y Mini Apps vinculadas. La eliminación puede dejar integraciones sin destino.
Para el procedimiento completo y las alternativas más seguras (desvincular canal o eliminar la cuenta), usá Eliminar un agente.