Skip to main content
Usa esta receta cuando un flujo de agente deba:
  • ejecutarse mediante el SDK de agentes de TypeScript
  • usar búsqueda web gestionada
  • devolver JSON estructurado estricto
  • recuperar de forma determinista JSON mal formado pero casi válido

1. Instala los SDK

2. Define un contrato de salida acotado

Mantén el primer resultado de investigación lo bastante pequeño como para que los operadores lo inspeccionen fácilmente en los registros.

3. Crea el agente

Usa parseOutput para que el entorno de ejecución devuelva datos tipados en lugar de texto sin procesar.

4. Configura una vez el adaptador respaldado por el gateway

Esta es la parte importante:
  • responseFormat mantiene explícito el esquema de salida
  • plugins activa la reparación de respuestas para JSON casi válido
  • gatewayTools pone la búsqueda web gestionada a disposición del modelo
  • toolChoice obliga a usar la herramienta de búsqueda cuando el flujo siempre deba basarse en fuentes

5. Ejecuta el flujo de trabajo

6. Qué comprobar en los registros

Después de una ejecución correcta, abre la vista de detalles de la solicitud y confirma que:
  • aparezcan las herramientas de búsqueda web nativas solicitadas o actividad de búsqueda gestionada
  • se hayan guardado los resultados de búsqueda y las citas
  • la ejecución del plugin muestre response-healing solo cuando se haya necesitado reparar una respuesta
  • el resultado final coincida con el esquema JSON solicitado

7. Cuándo usar este patrón

Usa esta receta cuando:
  • el flujo de trabajo sea principalmente una investigación puntual y no un ciclo profundo de herramientas locales
  • el modelo deba consultar fuentes antes de responder
  • los clientes posteriores necesiten JSON tipado en vez de prosa
No uses este patrón cuando:
  • el flujo ya conozca las URL exactas y phaseo:web_fetch sea suficiente
  • el agente necesite más herramientas locales avanzadas que herramientas nativas del proveedor
  • el contrato de salida sea tan flexible que el JSON estricto cueste más de lo que aporta

Guías relacionadas

Última modificación el 2 de octubre de 2026