Skip to main content
Use esta receita quando um serviço de TypeScript ou JavaScript precisar combinar:
  • padrões de roteamento definidos por predefinição
  • a ferramenta gerenciada phaseo:web_search
  • análise estrita da resposta
  • metadados no nível da requisição para depuração

Objetivo

  • manter quem chama no SDK oficial
  • evitar reconstruir manualmente payloads brutos de compatibilidade
  • preservar metadados suficientes para depurar resultados de busca, roteamento e comportamento do plugin

1. Comece com um cliente compartilhado

2. Primeiro, coloque os padrões estáveis em uma predefinição

Crie uma predefinição quando vários chamadores precisarem compartilhar:
  • política de modelos
  • preferências de provedores
  • padrões de raciocínio
  • prompt do sistema
  • comportamento determinístico de cache
Depois, limite a requisição do SDK aos valores que variam naquela chamada.

3. Peça uma resposta fundamentada pela ferramenta de busca gerenciada

Isso oferece:
  • padrões de roteamento e prompt gerenciados pela predefinição
  • busca gerenciada pelo servidor, sem depender do suporte à busca nativa do provedor
  • saída estruturada para uma análise posterior previsível
  • os metadados necessários para depuração operacional

4. Analise a saída e mantenha os campos de depuração

Esses campos facilitam verificar:
  • qual provedor realmente atendeu à requisição
  • se a busca gerenciada foi executada
  • se a recuperação de resposta foi executada
  • qual requisição inspecionar no painel

5. Confira nos logs a requisição fundamentada

Abra a requisição em Gateway -> Uso e inspecione:
  • resultados de busca normalizados
  • citações
  • seleção do provedor
  • metadados de execução do plugin
Se o comportamento da busca ou a classificação estiver incorreto, ajuste a predefinição ou os parâmetros da ferramenta com base nos logs, em vez de adicionar substituições sem evidências.

6. Separe fluxos exploratórios dos determinísticos

Padrão recomendado:
  1. uma predefinição para resultados de pesquisa estruturados e determinísticos
  2. outra predefinição para requisições exploratórias ou com temperatura mais alta
Assim, você mantém:
  • o cache de respostas mais organizado
  • o comportamento de roteamento mais fácil de entender
  • fluxos com muitas buscas separados do tráfego geral de geração

Guias relacionados

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