- 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
UsaparseOutput 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:responseFormatmantiene explícito el esquema de salidapluginsactiva la reparación de respuestas para JSON casi válidogatewayToolspone la búsqueda web gestionada a disposición del modelotoolChoiceobliga 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-healingsolo 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
- el flujo ya conozca las URL exactas y
phaseo:web_fetchsea 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