Un agente decide, ejecuta y vuelve a decidir sin que mires cada paso, así que lo que sabe tiene que estar definido antes de su primera tarea y no después del primer error. Esta ficha es media carilla: dominio, documentación, memoria, herramientas y la casilla que casi nadie escribe, a qué no debe acceder nunca. Viene con un prompt que te entrevista y la llena contigo.
Las cinco casillas en una página, para llenar a mano o en pantalla:
La misma ficha en Markdown, más abajo en esta página, para dejarla en el ticket del agente, en el README del repositorio o en el documento del equipo. Donde quede, tiene que estar antes de la primera tarea.
Pégalo en la IA que uses y te entrevista, una casilla a la vez. Lo que propone y no confirmaste queda marcado.
Lo que no hace: dar la ficha por cerrada en tu nombre.
O uno que estés por armar. Llena las cinco casillas, con el prompt o a mano. Te vas a encontrar con al menos una vacía.
Una pregunta que el agente debería poder responder antes de su primera tarea. Si con lo anotado no puede, hay una casilla incompleta: vuelve a ella antes de crearlo.
Dar acceso no es dar permiso. La casilla de herramientas y la del límite son las que alguien más tiene que poder leer cuando el agente haga algo que nadie esperaba.
Quiero llenar la Ficha de conocimiento de un agente antes de su primera
tarea. Entrevístame una pregunta a la vez y espera mi respuesta antes de
seguir con la siguiente.
Las casillas, en este orden:
1. Dominio: qué parte del negocio toca y cuál queda fuera de su alcance.
2. Documentación: qué tiene que leer antes de decidir. No todo: lo que manda.
3. Memoria: qué recuerda entre una tarea y la siguiente, y qué olvida a propósito.
4. Herramientas: qué puede ejecutar de verdad, con qué permiso y quién lo revisa.
5. Límite: a qué no debe acceder nunca.
Reglas:
- Si mi respuesta es vaga, repregunta con un ejemplo de mi contexto en vez
de completarla por tu cuenta.
- Si propones algo que yo no dije, márcalo como [propuesto: confirmar].
- Al terminar, devuelve la ficha llena en Markdown y agrega la prueba de
arranque: una pregunta que el agente debería poder responder solo con lo
anotado.
- No des la ficha por cerrada ni la firmes por mí. Termina con la lista de
lo que falta confirmar.# Ficha de conocimiento del agente
Llénala **antes de la primera tarea** del agente, no después del primer error.
Si no puedes completar las cinco casillas, todavía no tienes un agente: tienes
la idea de un agente.
---
**Agente:**
**Primera tarea:**
---
## 01 · Dominio
¿Qué parte del negocio toca este agente? ¿Cuál queda fuera de su alcance?
```
```
## 02 · Documentación
¿Qué tiene que leer antes de decidir? No todo: lo que manda.
```
```
## 03 · Memoria
¿Qué recuerda entre una tarea y la siguiente? ¿Y qué olvida a propósito?
```
```
## 04 · Herramientas
¿Qué puede ejecutar de verdad? ¿Con qué permiso, y quién lo revisa?
```
```
## 05 · Límite
¿A qué no debe acceder nunca? Es la casilla que casi nadie escribe.
```
```
---
## Prueba de arranque
Escribe una pregunta que este agente debería poder responder antes de su primera
tarea. Si con lo anotado arriba no puede responderla, hay una casilla
incompleta: vuelve a ella antes de crearlo.
```
```
---
**Ley #2 de Calidad sin Humo**
Un agente solo puede tomar decisiones con el conocimiento al que tiene acceso.
calidadsinhumo.comPara que la próxima vez que un agente te devuelva «ejecuta la suite completa, por las dudas», sepas qué casilla estaba vacía en lugar de culpar al modelo. Y para que cuando pueda hacer algo que no debía, la pregunta de quién lo autorizó tenga una respuesta escrita.
Descargar ficha-conocimiento-del-agente.pdf