Skip to main content
Use esta receita quando um fluxo de agente precisar:
  • rodar pelo TypeScript Agent SDK
  • usar busca na web gerenciada
  • retornar JSON estruturado estrito
  • recuperar JSON malformado quase válido de forma determinística

1. Instale os SDKs

2. Defina um contrato de saída restrito

Mantenha pequeno o primeiro resultado da pesquisa para que os operadores consigam inspecioná-lo facilmente nos logs.

3. Crie o agente

Use parseOutput para que o runtime retorne dados tipados, em vez de texto bruto.

4. Configure uma vez o adaptador conectado ao gateway

Esta é a parte importante:
  • responseFormat deixa explícito o esquema da saída
  • plugins habilita a recuperação de respostas quase válidas em JSON
  • gatewayTools disponibiliza a busca na web gerenciada para o modelo
  • toolChoice força a ferramenta de busca quando o fluxo sempre precisa se basear em fontes

5. Execute o fluxo de trabalho

6. O que verificar nos logs

Depois de uma execução bem-sucedida, inspecione os detalhes da requisição e confirme:
  • as ferramentas de busca na web nativas solicitadas ou a atividade de busca gerenciada aparecem nos logs
  • os resultados da busca e as citações foram salvos
  • a execução do plugin mostra response-healing somente quando a recuperação foi necessária
  • a saída final corresponde ao esquema JSON solicitado

7. Quando usar esse padrão

Use esta receita quando:
  • o fluxo for principalmente uma pesquisa pontual, e não um ciclo profundo de ferramentas locais
  • o modelo precisar se basear em fontes antes de responder
  • os chamadores posteriores precisarem de JSON tipado em vez de prosa
Não use este padrão quando:
  • o fluxo já souber as URLs exatas e phaseo:web_fetch for suficiente
  • o agente precisar mais de ferramentas locais avançadas do que de ferramentas nativas do provedor
  • o contrato de saída for flexível o bastante para que JSON estrito gere mais trabalho do que benefício

Guias relacionados

Última modificação em 2 de outubro de 2026