Marco de Investigación
El pipeline multifase estructurado del Agente de Investigación — componentes principales, flujo de misión, adaptadores de búsqueda y limitaciones actuales.
Propósito
El Marco de Investigación es el pipeline estructurado que rige cómo el Agente de Investigación ejecuta las misiones. Define cómo se recibe una tarea, cómo se ejecutan las fases en orden de dependencia, cómo se almacenan los datos intermedios y cómo se produce un informe final.
Esta página documenta el pipeline concreto del Agente de Investigación sobre OpenClaw. El framework OpenClaw proporciona el runtime general de misión y el modelo de artefactos; este marco de investigación define las fases específicas de dominio utilizadas para la recopilación estructurada de información y la generación de informes.
Estado: Implementado (pipeline, DAG de fases, almacén de artefactos y generación de informe final operativos)
Componentes principales
| Componente | Responsabilidad |
|---|---|
| Capa de Tareas | Recibe definiciones de tareas desde la cola basada en archivos |
| Mission Runner | Crea el directorio de ejecución, gestiona el ciclo de vida, orquesta las fases |
| DAG de Fases | Define el orden de ejecución y las dependencias entre fases |
| Adaptadores de Búsqueda | Interfaz con fuentes de búsqueda externas |
| Almacén de Artefactos | Almacena salidas intermedias tipadas por ejecución de misión |
| State Store | Rastrea el progreso de la misión, estado de las fases y errores |
| Informe Final | Agrega todos los artefactos en final_report.md |
Flujo de misión
- Una definición de tarea se escribe en el directorio de cola como un archivo JSON.
- El Mission Runner detecta la tarea y crea un directorio de ejecución aislado.
- Las fases se ejecutan en el orden definido por el DAG, respetando las dependencias.
- Cada fase lee de artefactos anteriores y escribe su salida en el directorio de ejecución.
- La fase final (F6) agrega todos los artefactos disponibles en
final_report.md. - El archivo de estado se actualiza para reflejar la finalización o cualquier error.
Resumen del DAG de fases
F2, F4 e Y1 son independientes entre sí y pueden tratarse como un grupo paralelo después de producirse los candidatos. Consulta DAG de Misión de Investigación para más detalles.
Artefactos producidos
| Archivo | Contenido |
|---|---|
task.json | Definición original de la tarea |
candidates.json | Elementos candidatos descubiertos |
reviews.jsonl | Entradas de reseña y análisis por candidato |
price_analysis.json | Datos de precio y disponibilidad |
youtube_transcripts.json | Contenido de transcripciones de video |
synthesis.json | Síntesis profunda (opcional) |
final_report.md | Informe Markdown agregado |
state.json | Seguimiento del progreso y errores de la misión |
Consulta Artefactos de Investigación para la descripción completa del ciclo de vida.
Adaptadores de búsqueda
La implementación actual incluye adaptadores para:
- Búsqueda web (API de búsqueda externa)
- Consultas de plataformas multimedia (integración de catálogo de streaming)
- Extracción de transcripciones de YouTube
Se planifican adaptadores adicionales para otros dominios de investigación.
Una limitación actual
El framework gestiona bien la investigación estructurada dentro de sus dominios diseñados (descubrimiento, reseñas, precios, transcripciones). El soporte para dominios de investigación más amplios — artículos académicos, documentación técnica, bases de datos estructuradas — está planificado pero aún no implementado.
Páginas relacionadas
→ Visión General del Framework OpenClaw — el modelo de runtime sobre el que se ejecuta este pipeline
→ DAG de Misión de Investigación — grafo de dependencias de fases detallado
→ Artefactos de Investigación — archivos de artefactos y ciclo de vida
→ Agente de Investigación — resumen del agente