- 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
3. Peça uma resposta fundamentada pela ferramenta de busca gerenciada
- 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
- 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
6. Separe fluxos exploratórios dos determinísticos
Padrão recomendado:- uma predefinição para resultados de pesquisa estruturados e determinísticos
- outra predefinição para requisições exploratórias ou com temperatura mais alta
- 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