Artefactos de Investigación

Propósito

Cada misión de investigación produce un conjunto de archivos de salida tipados (artefactos) almacenados en un directorio de ejecución aislado. Esto hace que las misiones sean reproducibles, inspeccionables y más fáciles de depurar. La estructura de artefactos define un contrato claro entre fases y consumidores posteriores.

Dentro de OpenClaw, los artefactos son las salidas persistentes de una misión. El Agente de Investigación especializa este modelo en archivos por fase como candidatos, reseñas, transcripciones, síntesis e informe final.

Estado: Implementado (almacén de artefactos y convenciones de archivos operativos)

Ciclo de vida de los artefactos

Descripción de los artefactos

task.json

Creado al inicio de la misión. Contiene la definición original de la tarea tal como se proporcionó a la cola. Este archivo es la fuente de verdad sobre lo que se pidió hacer en la misión. Nunca se modifica después de su creación.

candidates.json

Producido por la fase F1 (Candidatos). Contiene la lista de elementos candidatos descubiertos mediante la búsqueda principal. Todas las fases de investigación posteriores leen de este archivo para acotar su trabajo.

reviews.jsonl

Producido por la fase F2 (Reseñas). Contiene una entrada JSON por línea, cada una representando datos de reseña y análisis para un único candidato. El formato JSONL permite escrituras en streaming e inspección incremental.

price_analysis.json

Producido por la fase F4 (Análisis de Precios). Contiene información de precios y disponibilidad para cada candidato en las plataformas consultadas.

youtube_transcripts.json

Producido por la fase Y2 (Extracción de Transcripciones). Contiene el contenido de las transcripciones de los vídeos de YouTube asociados a cada candidato.

synthesis.json

Producido por un paso de síntesis profunda opcional. No está presente en todas las misiones. Cuando está presente, contiene una síntesis de más alto nivel de los hallazgos entre candidatos. F6 lo incluye si está disponible.

final_report.md

Producido por la fase F6 (Informe Final). El entregable principal de una misión de investigación. Agrega los hallazgos de reviews.jsonl, price_analysis.json, youtube_transcripts.json y opcionalmente synthesis.json en un informe Markdown estructurado.

El informe incluye:

• Resumen de la misión
• Ranking o lista corta de candidatos
• Hallazgos clave por candidato
• Resumen de precios y disponibilidad
• Notas sobre fuentes e indicadores de confianza

state.json

Mantenido a lo largo del ciclo de vida de la misión. Rastrea:

• Fase actual
• Estado de finalización de las fases
• Mensajes de error para fases fallidas
• Marcas de tiempo de inicio y fin de misión

Proporciona la base para futuras capacidades de reanudación o reintento de misión.

Estructura del directorio de ejecución

missions/
└── {id-de-misión}/
    ├── task.json
    ├── candidates.json
    ├── reviews.jsonl
    ├── price_analysis.json
    ├── youtube_transcripts.json
    ├── synthesis.json          (opcional)
    ├── final_report.md
    └── state.json

Por qué esta estructura

• Reproducibilidad — dado el mismo input, el conjunto de artefactos es predecible y auditable
• Depurabilidad — los resultados de cada fase se pueden inspeccionar de forma independiente
• Aislamiento — múltiples misiones no interfieren entre sí
• Auditabilidad — la cadena de investigación completa se preserva, no solo el resultado final

Una limitación actual

Los archivos de artefactos se escriben actualmente como archivos planos sin validación de esquema en el momento de escritura. La verificación de tipos y la aplicación de esquemas están planificadas para una versión futura del pipeline.

Páginas relacionadas

→ Visión General del Framework OpenClaw — el modelo de artefactos que esta página especializa
→ DAG de Misión de Investigación — grafo de dependencias de fases y secuencia de producción de artefactos → Marco de Investigación — resumen completo del pipeline → Agente de Investigación — resumen del agente