Saltar al contenido principal
Crea un agente de TypeScript que busca en la web a través de Phaseo antes de responder y devuelve un informe de investigación como JSON estricto con sus fuentes. Al terminar tendrás un script que imprime un objeto { topic, summary, sources } validado para cualquier tema que le des. El script está listo para producción en investigaciones de una sola llamada. Los resultados de búsqueda son contenido web no fiable: la comprobación de esquema de abajo detiene la salida mal formada, pero revisa las fuentes antes de actuar en función de ellas. Hay una versión empaquetada en packages/sdk/agent-sdk-ts/examples/research-brief-agent.ts.

Créalo

1

Instala

2

Escribe el agente

research-agent.ts
3

Ejecútalo

Comprueba que funciona

El script imprime un informe con al menos una URL de fuente. Después abre la solicitud en Ajustes → Uso → Registros y comprueba que:
  • Supervisión de la búsqueda web muestra las búsquedas gestionadas, los resultados y las citas.
  • El registro de plugins muestra response-healing como applied solo cuando el JSON necesitó reparación.
  • La respuesta coincidió con el esquema; si no, la ejecución habría fallado con un AgentSchemaValidationError.
Depurar la búsqueda web cubre los casos en los que no se ejecutó ninguna búsqueda.

Cuándo usar otra cosa

Este patrón encaja en investigaciones de una sola llamada en las que el modelo debe fundamentarse por sí mismo y quien llama quiere JSON tipado. Usa phaseo:web_fetch cuando ya conozcas las URL, un agente con herramientas locales cuando el trabajo necesite tus propios datos más que la web, y salida de texto simple cuando el contrato sea tan flexible que un esquema añada más trabajo del que ahorra.
Última modificación el 5 de noviembre de 2026