Guías
Documentación
Trabajar con agentes

Base de conocimiento

La biblioteca del espacio de trabajo que tus agentes leen al correr.

La Base de conocimiento es la biblioteca compartida de archivos de tu espacio de trabajo. Subes un documento una vez —una spec, una referencia de diseño, la documentación de una API, una captura— y queda en el espacio de trabajo para que cualquier agente y cualquier compañero lo aproveche. El contexto vive en el sistema, no en la cabeza de alguien.

Nada de la Base de conocimiento se envía a ningún lado por sí solo. Los archivos llegan a un agente únicamente cuando los adjuntas a una corrida, y se preparan en el directorio de trabajo del agente, en tu propia máquina, justo antes de que empiece.

Qué puedes guardar

Los mismos límites aplican a los archivos de la Base de conocimiento y a los archivos de una sola vez que adjuntas a una spec o un issue.

  • Formatos — PDF, Markdown, texto plano, HTML e imágenes (JPEG, PNG, WebP, GIF, SVG).
  • Tamaño de archivo — hasta 10 MB por archivo.
  • Capacidad del espacio de trabajo — hasta 1 GB de archivos en todo el espacio de trabajo.

Cómo lo usan los agentes

Cuando empiezas una Spec, redactas la solicitud y luego eliges qué archivos de la Base de conocimiento debe leer el agente —una lista con búsqueda, acotada a tu espacio de trabajo. Los archivos que elijas se preparan como lectura obligatoria: el agente lee cada uno antes de trabajar. Esos mismos archivos se vuelven a preparar cuando corre la construcción, así que todo lo que la spec menciona sigue ahí al construir. Consulta la Agente de Spec para ver dónde encaja esto en una corrida.

Archivos de una sola vez (fuera de la Base de conocimiento)

No tienes que agregar un archivo a la biblioteca para usarlo una vez. Cada spec e issue acepta sus propios adjuntos —hasta 20 archivos, 10 MB cada uno— que viven con ese elemento y se eliminan con él. Así le pasas al Agente de Diagnóstico de issues una captura o un log para mostrar un problema, o adjuntas un archivo para confirmar un arreglo cuando sigues trabajando en una construcción. Los issues solo usan adjuntos; no recurren a la Base de conocimiento.

Cómo ve tus archivos una corrida

knowledge/ Obligatorio

Los archivos de la Base de conocimiento que elegiste, más cualquier adjunto de una sola vez. El agente lee cada archivo de aquí.

references/ Opcional

Tus documentos de planeación —resumen, investigación, plan, guías de marca y técnica— agregados automáticamente cuando existen. El agente los consulta según haga falta.

Antes de que empiece una corrida, Fragua prepara tus archivos en el directorio de trabajo del agente, en tu máquina: lectura obligatoria en knowledge/, contexto opcional en references/.

Míralo en una corrida

Las dos superficies que leen tus archivos empiezan desde una funcionalidad o un bug.