Plantilla de contexto para agentes de IA

Los agentes de IA ya pueden leer documentos, buscar contexto, llamar herramientas y preparar trabajo para otras personas. Eso los hace útiles, pero también exige una configuración más clara que un prompt rápido.

Antes de pedirle a ChatGPT, Claude, Cursor, Codex, Notion Custom Agents, Agent 365 o una herramienta MCP que actúe sobre trabajo real, dale una guía de contexto. El objetivo es que el resultado sea revisable en email, Teams, Slack, Google Docs, Notion, Jira, Confluence o GitHub issues.

En resumen

En un equipo que reparte trabajo entre Jira, Confluence, GitHub issues y documentos internos, el brief sirve para que el agente no deduzca políticas desde un chat largo. Deja por escrito qué fuente manda, qué regla no debe tocar y dónde debe terminar la respuesta.

Usa una guía de contexto cuando la tarea toca trabajo de equipo, fuentes dispersas, permisos, datos sensibles o una salida que alguien más debe revisar.

• Define la tarea y el criterio de éxito.
• Lista fuentes, documentos, tickets y conversaciones útiles.
• Marca límites: qué no usar, no cambiar y no revelar.
• Separa permisos de lectura, herramientas permitidas y acciones que requieren aprobación.
• Pide un formato de salida que otra persona pueda auditar.

Descargar gráfico

La estructura recomendada

Plantilla copiable

# Contexto para agente de IA

## 1. Tarea
¿Qué debe hacer el agente?

## 2. Criterio de éxito
¿Cómo sabremos que el resultado es bueno?

## 3. Fuentes
- Conversaciones relevantes:
- Docs:
- Tickets:
- Archivos:
- Enlaces:

## 4. Límites
- No usar:
- No cambiar:
- No revelar:
- Preguntar antes de:

## 5. Permisos
- Fuentes solo lectura:
- Herramientas permitidas:
- Acciones de escritura permitidas:
- Aprobación humana requerida para:

## 6. Reglas del proyecto
- Tono:
- Terminología:
- Seguridad o privacidad:
- Restricciones conocidas:

## 7. Formato de salida
- Resumen:
- Decisión:
- Pasos realizados:
- Archivos o sistemas tocados:
- Preguntas abiertas:
- Próximo paso:

Mini ejemplo rellenado

# Contexto para agente de IA

## Tarea
Revisar tres tickets de soporte y preparar un resumen para producto.

## Criterio de éxito
Producto debe poder decidir si el problema es de texto, flujo o documentación.

## Fuentes
- Ticket SUP-1842, SUP-1851 y SUP-1860.
- Captura del paso de exportación.
- Nota interna sobre planes afectados.

## Límites
- No incluir nombres, correos ni IDs de cuenta.
- No abrir tickets nuevos sin aprobación.
- Preguntar si falta evidencia.

## Salida
Resumen de una página con patrón, evidencia, riesgo y próxima acción.

Cuándo basta con un brief corto

Para una primera pasada de resumen, investigación u organización, usa una versión de seis líneas: tarea, audiencia, fuentes, no incluir, formato y cuándo preguntar. Lo importante es dejar claro el contexto antes de que el agente improvise.

Cuándo necesitas el brief completo

Usa el formato completo si el agente puede consultar varias fuentes, tocar trabajo de clientes, abrir issues, proponer cambios de código o escribir en una herramienta conectada. Si hay escritura, la aprobación humana y el registro de acciones no son opcionales.

Error común

Pegar un chat largo como contexto no equivale a preparar al agente. Una guía separa lo estable, lo temporal, lo sensible y lo accionable para que la IA no arrastre ruido al resultado.

Cómo encaja Highlight Reel

Highlight Reel encaja después de redactar la guía: puedes guardar los fragmentos del chat que sí explican reglas, decisiones y fuentes, y convertirlos en una nota que el equipo revise antes de darle más acceso a un agente. Los permisos, aprobaciones y acciones reales siguen viviendo en la plataforma correspondiente.

Preguntas frecuentes

¿Esto reemplaza las instrucciones del sistema?

No. La guía es una capa de trabajo para una tarea concreta. Las instrucciones del sistema, permisos de plataforma y controles de administrador siguen aplicando.

¿Debo usarlo para tareas pequeñas?

Solo una versión corta. Si la tarea no toca datos sensibles ni herramientas, cinco campos suelen bastar.