Pular para o conteúdo principal
Crie um agente em TypeScript que pesquisa na web pela Phaseo antes de responder e retorna um resumo de pesquisa como JSON estrito, com as fontes. Ao final, você terá um único script que imprime um objeto { topic, summary, sources } validado para qualquer tema que você informar. O script está pronto para produção em pesquisas de uma única chamada. Os resultados de busca são conteúdo da web não confiável: a verificação de esquema abaixo barra saídas malformadas, mas revise as fontes antes de agir com base nelas. Uma versão empacotada está em packages/sdk/agent-sdk-ts/examples/research-brief-agent.ts.

Crie o agente

1

Instale

2

Escreva o agente

research-agent.ts
3

Execute

Verifique se funcionou

O script imprime um resumo com pelo menos uma URL de fonte. Depois, abra a solicitação em Configurações → Uso → Registros e confira:
  • Web search observability mostra as buscas gerenciadas, os resultados e as citações.
  • O registro de plugins mostra response-healing como applied apenas quando o JSON precisou de reparo.
  • A resposta correspondeu ao esquema; uma divergência teria feito a execução falhar com um AgentSchemaValidationError.
Depurar solicitações de busca na web cobre os casos em que nenhuma busca foi executada.

Quando usar outra abordagem

Este padrão serve para pesquisas de uma única chamada em que o modelo deve se fundamentar e quem chama quer JSON tipado. Use phaseo:web_fetch quando você já conhece as URLs, um agente com ferramentas locais quando o trabalho depende mais dos seus próprios dados do que da web, e saída em texto simples quando o contrato é solto o bastante para que um esquema dê mais trabalho do que economiza.
Última modificação em 5 de novembro de 2026