Respuesta corta
Un agente se integra con CRM o ERP mediante herramientas específicas que consultan o ejecutan acciones autorizadas. La IA interpreta la intención y prepara parámetros; la integración valida identidad, permisos, reglas y resultado antes de responder al usuario.
No conectes el modelo directamente a todo
Dar acceso amplio a una base o API aumenta el riesgo y dificulta las pruebas. Expón operaciones pequeñas: buscar cliente, consultar estado, crear borrador, registrar nota o solicitar aprobación. Cada herramienta debe tener entradas validadas y una respuesta estructurada.
La acción crítica ocurre en código, no en texto. Si una política prohíbe descuentos mayores a cierto valor, la API debe rechazarlo aunque el agente lo solicite.
Lecturas y escrituras
Empieza con consultas de bajo riesgo. Permite que el agente busque información y cite la fuente. Luego añade escrituras reversibles, como crear un borrador o una tarea. Las acciones financieras, legales o irreversibles requieren confirmación y, con frecuencia, aprobación humana.
Evita responder “listo” antes de recibir confirmación del sistema. Guarda identificador, estado y mensaje de error. Si la operación es lenta, comunica que está en proceso y ofrece seguimiento.
Identidad y permisos
El agente debe actuar con la identidad del usuario o con una cuenta de servicio de alcance limitado. No aceptes un rol escrito en el mensaje como autorización. Aplica las mismas reglas del CRM o ERP y registra quién inició cada acción.
Oculta campos que el usuario no puede ver. Minimiza los datos enviados al modelo y evita incluir secretos, tokens o información completa cuando basta un resumen.
Manejo de duplicados
Las conversaciones pueden repetirse y las redes pueden reintentar solicitudes. Usa claves de idempotencia para no crear dos clientes, facturas o tickets. Antes de insertar, busca identificadores confiables y define cómo combinar registros.
Pruebas necesarias
Incluye permisos insuficientes, registros inexistentes, datos incompletos, API lenta, error temporal, respuesta duplicada y cambios concurrentes. Verifica que el agente no esconda el fallo ni invente el resultado.
Prueba también instrucciones maliciosas dentro de documentos o mensajes. Las fuentes externas son datos, no órdenes para cambiar las reglas del sistema.
Observabilidad
Registra herramienta, parámetros seguros, duración, resultado y responsable. Crea alertas para errores, tasas inusuales y acciones sensibles. Revisa conversaciones de muestra y causas de escalamiento.
Implementación por etapas
Comienza con una operación valiosa y medible. Valida exactitud y uso, añade una segunda herramienta y evita convertir el agente en una interfaz para todo el ERP desde el primer día.
Solventio diseña la conversación, la integración y los controles como un solo sistema para que la experiencia sea sencilla sin sacrificar seguridad.
Contrato de cada herramienta
Define cada integración como un contrato pequeño. Especifica nombre, propósito, parámetros, validaciones, permisos, respuesta, errores y si la acción es reversible. “Gestionar CRM” es demasiado amplio; “buscar contacto por correo” y “crear nota asociada” pueden probarse y autorizarse por separado.
Usa esquemas estrictos. Fechas, monedas, identificadores y enumeraciones no deberían viajar como texto ambiguo. La herramienta rechaza campos desconocidos y devuelve códigos claros. El agente transforma el lenguaje del usuario en parámetros, pero no modifica las reglas.
Capa de orquestación
Coloca una capa entre el modelo y los sistemas. Allí se valida identidad, se aplican permisos, se limitan operaciones y se registran resultados. Esta capa puede reutilizar APIs existentes, colas y servicios de integración. Evita exponer credenciales del CRM o ERP al navegador o incluirlas en el prompt.
Para operaciones largas, crea un trabajo y devuelve su estado. El agente puede informar “la solicitud fue recibida” con un identificador, no “el reporte está listo”. Cuando el proceso termina, una notificación o consulta posterior muestra el resultado real.
Confirmación proporcional al riesgo
Una lectura rutinaria puede ejecutarse directamente. Crear un borrador puede requerir una confirmación simple. Enviar, aprobar o modificar un registro sensible necesita mostrar un resumen exacto y solicitar aprobación. Algunas acciones deben permanecer exclusivas de un rol humano.
La pantalla de confirmación incluye objeto, valores principales, sistema destino y consecuencia. Después muestra identificador y estado devuelto por el sistema. Si hay error parcial, explica qué pasos sí ocurrieron y cuáles no.
Resiliencia e idempotencia
Las APIs fallan, vencen y limitan solicitudes. Define tiempos de espera, reintentos solo para errores seguros y circuitos que detengan llamadas cuando un servicio está inestable. Una clave de idempotencia vinculada a la intención evita duplicar facturas o clientes ante un reintento.
No reintentes automáticamente una operación cuyo resultado es desconocido. Primero consulta si se creó. Mantén una cola de revisión para conflictos o respuestas inesperadas.
Seguridad del contenido
Los campos del CRM, adjuntos y documentos son datos no confiables. Una instrucción escrita dentro de una nota no debe cambiar el comportamiento del agente. Separa instrucciones del sistema de contenido recuperado, limita herramientas y valida todo en servidor.
Minimiza el contexto enviado al modelo. Enmascara o resume cuando sea suficiente. Aplica retención y permisos también a logs y evaluaciones. Los ambientes de prueba no deberían copiar datos productivos sin controles.
Estrategia de pruebas
Construye pruebas unitarias para validadores y reglas, pruebas de contrato contra entornos controlados y recorridos completos con identidades de distintos roles. Incluye concurrencia, duplicados, API lenta, token vencido, campo nuevo, respuesta inesperada y caída después de ejecutar.
Evalúa el comportamiento lingüístico aparte de la integración. El agente debe elegir la herramienta correcta, pedir datos faltantes y abstenerse cuando no tiene permiso. Conserva un conjunto de conversaciones críticas como regresión.
Observabilidad para operar
Asigna un identificador de correlación a conversación y acción. Registra herramienta, duración, resultado, usuario y versión, evitando secretos. Crea tableros de errores por integración, operaciones rechazadas, tiempos y escalamiento. Las alertas se enfocan en cambios relevantes, no en cada respuesta imperfecta.
Permite a soporte reconstruir qué ocurrió sin leer toda la conversación ni acceder a datos que no le corresponden. Una bitácora clara reduce el tiempo de diagnóstico.
Gobierno de cambios
Las APIs y reglas cambian. Versiona contratos, prueba compatibilidad y despliega gradualmente. Asigna propietarios para cada herramienta y revisa permisos. Si un sistema agrega un campo obligatorio, la integración debe fallar de forma visible hasta adaptarse.
Empieza con lectura, añade borradores y después acciones confirmadas. Esta progresión genera confianza y revela la calidad real de los datos. Integrar un agente con CRM o ERP no consiste en darle acceso a todo: consiste en convertir necesidades concretas en operaciones pequeñas, seguras y comprobables.