Notas del Lab

Agente de Investigación

El rol del Agente de Investigación en la ejecución de misiones de investigación estructuradas en segundo plano — cola de tareas, mission runner, DAG de fases y pipeline de artefactos.

Rol

El Agente de Investigación es responsable de ejecutar misiones de investigación estructuradas en segundo plano. Utiliza una cola de tareas basada en archivos para recibir trabajo, ejecuta un pipeline de investigación multifase (el DAG de Misión), almacena artefactos intermedios tipados en cada fase y produce un informe Markdown final.

Estado: Implementado (cola de tareas, mission runner, DAG de fases y pipeline de artefactos operativos)

Nota de arquitectura

Algunas capacidades del Agente de Investigación fueron inicialmente prototipadas en un runtime compartido con el Agente Multimedia. La arquitectura los modela como agentes lógicos separados porque sus responsabilidades, herramientas y perfiles de riesgo son diferentes. El Agente de Investigación está enfocado en la recopilación y síntesis estructurada de información; el Agente Multimedia está enfocado en la automatización del entretenimiento y el control de medios.

Por qué el Agente de Investigación es independiente

El Agente de Investigación opera de forma independiente del Agente de Orquestación por dos razones:

Separación de recursos. Las misiones de investigación son intensivas en recursos y potencialmente de larga duración. Mantener el Agente de Investigación separado garantiza que una misión en ejecución no compita con el trabajo de desarrollo activo ni lo bloquee.

Separación de alcance. La ejecución de misiones de investigación es un flujo de trabajo bien definido y repetible con sus propias herramientas, artefactos y estado. Mantenerlo separado refuerza límites claros y hace que cada componente sea más fácil de razonar y depurar.

Responsabilidades

ComponenteResponsabilidadEstado
Cola de TareasEntrada basada en archivos para tareas de investigaciónImplementado
Mission RunnerRecoge tareas, crea directorio de ejecución, gestiona ciclo de vidaImplementado
DAG de FasesEjecución de fases ordenada por dependenciasImplementado
Adaptadores de BúsquedaIntegración con fuentes de búsqueda externasImplementado
Almacén de ArtefactosDirectorio de salida estructurado por misiónImplementado
State StoreSeguimiento del progreso y errores de la misiónImplementado

Flujo de misión (resumen)

  1. Se escribe una definición de tarea en el directorio de cola como archivo JSON.
  2. El Mission Runner detecta la tarea y crea un directorio de ejecución aislado.
  3. Las fases se ejecutan en el orden definido por el DAG, respetando las dependencias.
  4. Cada fase lee de artefactos anteriores y escribe su salida en el directorio de ejecución.
  5. La fase final agrega todos los artefactos disponibles en final_report.md.
  6. El archivo de estado se actualiza para reflejar la finalización o cualquier error.

Relación con el Agente de Orquestación

El Agente de Orquestación puede iniciar misiones de investigación escribiendo archivos de tareas en la cola del Agente de Investigación. Los informes están luego disponibles para el Agente de Orquestación o el usuario. Los agentes no comparten sesión, memoria ni contexto de cómputo.

Relación con OpenClaw

El Agente de Investigación es una implementación basada en OpenClaw de una misión de investigación estructurada en segundo plano. OpenClaw proporciona el límite de misión, el modelo de runtime, el seguimiento de estado y las convenciones de artefactos; el Agente de Investigación define el pipeline concreto de investigación, el DAG de fases, los adaptadores de búsqueda y el comportamiento de generación de informes.

Para el modelo de ejecución a nivel de framework, consulta Visión General del Framework OpenClaw.

Una limitación actual

El pipeline de investigación actual gestiona bien los dominios de investigación estructurados y repetibles (descubrimiento, reseñas, precios, transcripciones). El soporte para dominios de investigación más amplios — literatura académica, documentación técnica, razonamiento multi-salto — está planificado pero aún no implementado.

Páginas relacionadas

→ Arquitectura Agéntica — contexto más amplio para investigación, tooling, memoria y auditorías → Visión General del Framework OpenClaw — el modelo de runtime compartido
→ Marco de Investigación — componentes del pipeline y detalles del flujo de misión → DAG de Misión de Investigación — grafo de dependencias de fases → Artefactos de Investigación — archivos de salida y ciclo de vida → Agente Multimedia — agente separado para automatización de entretenimiento → Resumen del Sistema — el Agente de Investigación en la arquitectura completa