Temporada 2 · Episodio 3 · Arquitectura

Lo que un agente necesita para trabajar

Un agente no trabaja en el vacío. Para conectarlo a la operación hay que definir cómo consulta, cómo actúa y qué controles necesita; las piezas concretas dependen de la tarea.

Equipo XophiaActualizado el 5 min de lectura

El equipo de TI recibe el encargo un lunes: «queremos un agente que gestione la cobranza». El martes descubren que el ERP no tiene una API documentada para consultar facturas vencidas. El miércoles, que los pagos del banco llegan en archivos que alguien descarga a mano. El jueves, que la regla de a quién llamar primero no está escrita en ninguna parte. El viernes, el proyecto del agente se convierte en un proyecto de integración de seis meses.

Es otra composición, y resume por qué tantos agentes se quedan en la demo. El modelo era capaz desde el primer día. Lo que faltaba era todo lo que tenía alrededor. Este episodio recorre esas piezas, una por una.

APIs operacionales: las manos del agente

Para actuar de forma confiable sobre sistemas, un agente necesita interfaces controladas: crear un borrador de factura, registrar un pago, actualizar una etapa en el CRM o abrir un ticket. Puede producir trabajo útil sin escribir en esos sistemas, pero ejecutar cambios exige un mecanismo autorizado y verificable. Cada acción expuesta es también una superficie de riesgo: hay que acotar qué se puede hacer, con qué parámetros y con qué validaciones.

APIs analíticas: los ojos del agente

Consultar datos es distinto de actuar sobre ellos. Una API analítica puede responder preguntas como saldos por cliente, ventas por período o facturas vencidas por antigüedad. Separarla de las interfaces operacionales permite aplicar controles distintos. La lectura también requiere permisos, filtros por rol y registro, en especial cuando expone datos sensibles; las acciones añaden validaciones y, según su impacto, aprobaciones.

Capa semántica: el diccionario

Como vimos en el episodio anterior, consultar métricas gobernadas reduce la necesidad de improvisar fórmulas. Cuando el proceso depende de indicadores de negocio, una capa semántica puede dar definiciones versionadas a la API analítica. Eso no reemplaza la calidad de las fuentes, los permisos ni la validación de cada respuesta.

Herramientas: el contrato

Para el modelo, una capacidad puede presentarse como herramienta: un nombre, una descripción y un esquema de parámetros. Parece un detalle de implementación, pero influye en qué elige el agente y cómo la usa. Las herramientas con alcance acotado, validaciones y errores claros facilitan las pruebas; aun así hay que medir si el modelo selecciona la correcta en casos reales y adversarios.

El modelo decide qué herramienta usar. La calidad de esa decisión depende de lo bien que esté diseñada la herramienta.

Skills: el procedimiento

Las herramientas dicen qué puede hacer un agente. Una forma de documentar cómo se hace una tarea son las skills, o habilidades: instrucciones, ejemplos y recursos sobre los pasos de la conciliación, el orden de la cobranza o qué revisar antes de proponer un descuento. Algunas plataformas cargan estos paquetes cuando la tarea lo requiere; otras organizan los procedimientos de otra forma. En cualquier caso, hay que versionarlos, probarlos y asignarles un dueño.

MCP: el enchufe común

Durante años, conectar un modelo a cada sistema exigía una integración a medida. El Model Context Protocol, un estándar abierto que presentó Anthropic a fines de 2024 y que luego adoptaron otros grandes proveedores, define una forma común de exponer herramientas, recursos y plantillas de prompts a clientes compatibles. No convierte esas plantillas en procedimientos ejecutables ni reemplaza las skills del equipo. Le dedicamos el próximo episodio completo, porque cambia lo que una organización puede hacer desde las herramientas de IA que su equipo ya usa.

El orden de construcción

Esta infraestructura no se construye de una vez para toda la empresa. Se construye para el primer proceso y se diseña para que el segundo reutilice conectores, permisos, evaluaciones y registro. Las definiciones semánticas se suman cuando el proceso consulta métricas de negocio. El segundo agente puede costar menos si esas piezas son realmente reutilizables. Antes de producción, cada acción necesita límites, pruebas y trazabilidad acordes con su riesgo.

Para el lunes

  1. Para el proceso candidato a un agente, lista cada sistema que tendría que consultar y cada uno donde tendría que actuar.
  2. Marca cuáles tienen hoy una API usable y cuáles dependen de exportaciones manuales.
  3. Escribe el procedimiento de la tarea en una página: es el borrador de su primera skill.

Fuentes y contexto

Lecturas relacionadas

Ver la plataforma

Las escenas de estos episodios son composiciones de situaciones frecuentes, no casos de clientes. Las cifras que aparecen en ellas son ilustrativas.

¿Te suena alguno de estos episodios?

En 20 minutos revisamos tu caso y te llevas un mapa de qué se queda, qué se conecta y qué conviene reemplazar.

Xophia

Cuéntame a qué se dedica tu empresa.

Veamos qué necesitas y preparemos un ejemplo que puedas explorar antes de conversar con el equipo.

Xophia está preparando una respuesta…

Conversas con un agente de IA. Tus mensajes se envían para responderte. Evita compartir información confidencial.