💡 Ideas6 min

Trabajar con agentes IA sin perder contexto: qué documentar

Cómo trabajar con agentes IA sin fragmentar la memoria del proyecto: qué documentar, qué delegar y qué revisar para mantener contexto y control a largo plazo.

Ilustración editorial: Trabajar con agentes IA sin perder contexto: qué documentar
Carlos Martin Pavon

Carlos Martin Pavon

Software Architect & Founder

Para trabajar con agentes IA sin perder contexto, necesitás separar tres cosas: qué sabe el proyecto, qué puede decidir el agente y qué tiene que revisar una persona. Si esas reglas no están escritas, la velocidad se transforma en fragmentación: más entregas, pero también más dudas escondidas.

La escena se repite en negocios chicos y medianos. Un agente resume llamadas, otro arma propuestas, otro revisa tickets, otro escribe documentación. Todo parece avanzar, hasta que alguien pregunta: "¿por qué prometimos onboarding en 48 horas si operaciones tarda 5 días?" Ahí aparece el costo real: no es la herramienta, es la memoria del sistema.

Qué documentar antes de trabajar con agentes IA

Antes de sumar agentes, documentá las decisiones que se repiten, los límites comerciales y los criterios de calidad. No hace falta armar una biblia interna de 80 páginas. Lo útil es una base mínima que el agente pueda consultar y que el equipo pueda corregir sin pedir permiso.

Lo primero que conviene documentar es lo que más caro sale cuando se interpreta mal:

  1. Oferta actual: qué vendés, qué incluye y qué no incluye.
  2. Precios y excepciones: descuentos permitidos, mínimos, formas de pago.
  3. Proceso de venta: etapas, responsables y próximos pasos.
  4. Promesas prohibidas: cosas que suenan lindas pero rompen operaciones.
  5. Criterios de calidad: qué significa "listo" para una entrega.
  6. Tono de comunicación: cómo hablás con clientes, leads y proveedores.
  7. Decisiones recientes: cambios de política de los últimos 30 días.

Para la capa técnica más profunda — cómo los agentes guardan y recuperan ese contexto — el artículo sobre context engineering para agentes IA con memoria persistente cubre el diseño de la infraestructura de memoria.

Cómo trabajar con agentes IA sin convertir todo en caos

La forma más sana de trabajar con agentes IA es asignarles tareas con entrada, salida y criterio de revisión. Si la consigna tiene más de dos objetivos mezclados, probablemente necesitás dividirla.

Un error común es pedirle al agente algo como: "analizá estos tickets, encontrá problemas, proponé mejoras y escribí una respuesta para clientes". Parece eficiente. En realidad, junta diagnóstico, decisión, priorización y comunicación en una sola caja negra.

Separalo en pasos más chicos. Primero, que clasifique 50 tickets por motivo. Después, que detecte los tres patrones más repetidos. Recién ahí, que proponga cambios. Y antes de mandar nada a clientes, una persona revisa el tono y la promesa.

La paradoja es que los agentes funcionan mejor cuando no les pedís que sean "autónomos" desde el día uno. Funcionan mejor cuando tienen bordes. Un borde no los limita; les baja la ambigüedad.

Para profundizar en cómo diseñar esos briefs, el artículo sobre diseño de tareas para agentes con autonomía cubre esa disciplina en detalle.

Tipo de tareaBuen uso del agenteRiesgo si falta contextoRevisión humana
VentasResumir llamadas y preparar borradoresPrometer descuentos o plazos incorrectosRevisar propuesta final
SoporteClasificar tickets por causaConfundir síntoma con problema realRevisar patrones críticos
OperacionesArmar checklist de entregaSaltear dependencias entre áreasValidar responsables
ReportingResumir métricas semanalesMezclar datos viejos con nuevosConfirmar fuente y fecha

Qué delegar y qué revisar cuando el agente acelera

Delegá tareas reversibles, repetibles y basadas en información explícita. Revisá decisiones que afecten dinero, reputación o experiencia del cliente.

El agente es muy bueno para reducir fricción. Puede leer una transcripción de 35 minutos y dejarte ocho puntos accionables. Pero la revisión no puede ser "mirar por arriba". Una pregunta que uso bastante es: ¿qué parte de esta salida me daría vergüenza defender frente al cliente si estuviera mal?

El sistema mínimo para no perder contexto

Un sistema mínimo combina una fuente de verdad, un registro de decisiones y una rutina de revisión semanal.

Lo pensaría en tres capas:

  1. Contexto estable: oferta, precios, procesos, tono, políticas.
  2. Contexto vivo: decisiones de esta semana, cambios de prioridad, clientes sensibles.
  3. Contexto de tarea: qué se le pidió al agente, con qué materiales y qué resultado dejó.

Si mezclás esas capas, todo envejece mal. Un precio puede cambiar una vez por trimestre. Una prioridad puede cambiar el viernes. Una instrucción de tarea puede servir solo para hoy.

Un registro simple puede tener cinco campos: fecha, decisión, motivo, responsable y dónde impacta.

Señales de que el contexto ya se está rompiendo

El contexto se está rompiendo cuando el equipo discute decisiones que ya habían sido tomadas o cuando dos salidas del agente se contradicen entre sí. Si eso pasa dos veces en una semana, no es mala suerte: es falta de sistema.

Un diagnóstico rápido:

  1. Tomá las últimas 10 tareas hechas con agentes.
  2. Marcá cuántas usaron documentos actualizados.
  3. Revisá cuántas tuvieron correcciones humanas importantes.
  4. Contá cuántas decisiones quedaron registradas.
  5. Mirá si alguien podría repetir el proceso mañana sin preguntarte.

Si menos de 7 de esas 10 tareas tienen rastro claro, el problema no es productividad. Es trazabilidad.

Si estás construyendo una operación con agentes IA y querés armar ese primer circuito de contexto, documentación y revisión, trabajo en eso desde solu30.

Preguntas frecuentes

¿Qué significa trabajar con agentes IA sin perder contexto? Significa usar agentes para ejecutar tareas sin que se pierdan decisiones, datos o criterios del negocio. Requiere al menos una fuente de verdad, un registro de decisiones y una revisión semanal.

¿Qué debería documentar primero antes de trabajar con agentes IA? Primero documentá oferta, precios, excepciones, proceso de venta y promesas prohibidas. Con cinco documentos cortos ya podés reducir gran parte de los errores comunes.

¿Cada cuánto conviene revisar lo que hacen los agentes? Para tareas internas, una revisión semanal de 30 minutos suele alcanzar. Para tareas que llegan a clientes, conviene revisar cada salida antes de enviarla durante las primeras semanas.

¿Qué tareas no conviene delegar completamente a un agente? Decisiones sobre precios, contratos, reclamos sensibles o promesas de entrega. Si un error puede costar más de dos horas de trabajo, tiene que pasar por una persona.

¿Cómo sé si mi empresa ya está perdiendo contexto con IA? Una señal clara es que el equipo discute dos o más veces por semana decisiones que ya estaban tomadas. Otra es que dos agentes producen respuestas distintas sobre precios o políticas usando supuestamente la misma información.

#thoughts#construir con ia#trabajar#con

Compartir este post

Preguntas frecuentes