- 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
UseparseOutput 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:responseFormatdeixa explícito o esquema da saídapluginshabilita a recuperação de respostas quase válidas em JSONgatewayToolsdisponibiliza a busca na web gerenciada para o modelotoolChoiceforç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-healingsomente 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
- o fluxo já souber as URLs exatas e
phaseo:web_fetchfor 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