Docs
AgenteInvestigaciones

Investigaciones autónomas

Crea planes de estudio con objetivos y dejá que el agente autónomo los complete.

¿Qué es una investigación?

Una investigación es un plan de estudio supervisado por el agente de MatHub. Definís un tema y un conjunto de objetivos, y el agente se encarga de generar notas, recopilar ideas y organizar el contenido del repositorio para alcanzarlos. Vos mantenés el control total: podés aprobar o rechazar cada propuesta antes de que el agente la aplique.

Las investigaciones son útiles cuando querés explorar un tema nuevo sin tener que estructurar todo desde cero, o cuando necesitás que el agente rellene vacíos en un repositorio ya existente.

Crear una investigación

Desde cualquier repositorio, abrí el panel lateral y seleccioná Investigaciones → Nueva investigación. Vas a elegir entre dos modos de creación:

Modo guiado

El agente te hace preguntas sobre el tema, el nivel de profundidad y los objetivos deseados, y genera el plan automáticamente. Ideal para explorar temas desconocidos.

Modo abierto

Escribís vos el enunciado de la investigación y los objetivos directamente. Más flexible, pensado para quienes ya saben qué quieren lograr.

Definir objetivos

Cada investigación tiene uno o más objetivos. Un objetivo describe un resultado concreto que el agente debe alcanzar, por ejemplo: "Explicar los conceptos fundamentales de álgebra lineal con ejemplos" o "Crear una nota resumen de los teoremas de Gödel".

Tips para escribir buenos objetivos:

  • Usá verbos de acción: explicar, comparar, listar, resumir, demostrar.
  • Especificá el alcance: "en máximo 3 notas" o "con al menos 2 ejemplos por sección".
  • Evitá objetivos demasiado vagos como "entender matemática" — cuanto más específico, mejor resultado.

Iniciar el agente

Una vez guardada la investigación, aparece el botón Iniciar agente. Al activarlo, el agente empieza a trabajar en segundo plano: lee las notas existentes del repositorio, analiza los objetivos y genera propuestas de contenido nuevo o modificaciones a notas existentes.

El agente trabaja en ciclos. En cada ciclo propone un conjunto de cambios (llamados artifacts) y espera tu aprobación antes de continuar con el siguiente.

Revisar propuestas del agente

Cada vez que el agente termina un ciclo, recibís una notificación y podés revisar sus propuestas en la pantalla de la investigación. Para cada propuesta vas a ver:

Aprobar

El agente aplica los cambios al repositorio: crea notas nuevas, actualiza contenido existente o reorganiza secciones según la propuesta.

Rechazar

El agente descarta esa propuesta y puede volver a intentarlo con un enfoque distinto en el siguiente ciclo. Opcionalmente podés dejarle un comentario explicando qué no te convenció.

Vista previa

Antes de aprobar podés ver exactamente qué notas se crearían o modificarían, con un diff del contenido anterior versus el propuesto.

Monitorear el progreso

La pantalla de investigación muestra el progreso general: cuántos objetivos están completados, cuántos ciclos ejecutó el agente y cuántas notas generó. El indicador de convergencia te muestra si el agente está cerca de cumplir todos los objetivos o si todavía tiene trabajo por hacer.

Podés pausar o reanudar el agente en cualquier momento desde el panel de la investigación. Si el agente queda bloqueado (por ejemplo, si un objetivo es ambiguo o hay conflicto con notas existentes), te va a alertar para que ajustes los parámetros.

Revertir notas del agente

Todas las notas creadas o modificadas por el agente quedan marcadas con el ícono de agente. Si querés deshacer un cambio específico, entrá a la nota y usá el botón Revertir versión en el historial. Podés volver a cualquier estado anterior a la intervención del agente.

Consejo: si querés revertir todos los cambios de una investigación completa de una sola vez, usá la opción Deshacer investigación en el menú de la investigación. Esto revierte todas las notas al estado que tenían antes de iniciar el agente.

Próximos pasos

Una vez que la investigación está completa, el contenido generado queda como parte normal del repositorio. Podés seguir editando las notas manualmente, crear quizzes a partir de ellas o compartir el repositorio con colaboradores.