orq:web_search permite que um modelo pesquise na web pública durante uma resposta. O AI Gateway executa cada pesquisa e retorna os resultados ao modelo, que decide como usá-los na resposta.
Início rápido
Os exemplos usam a configuração de cliente da Visão geral das ferramentas de servidor.Configuração
max_results é um limite máximo. Se o modelo solicitar menos resultados, o valor menor é usado.
Custo e uso
Cada pesquisa na web do Toqan Router que inicia a execução custa US$ 0,005. A cobrança é incluída no custo da resposta quando os dados de faturamento estão disponíveis. O número de pesquisas aparece emusage.server_tool_use.web_search_requests. Uma chamada rejeitada por max_uses não incrementa esse contador; o modelo recebe uma mensagem de limite de uso como resultado da ferramenta, e a tentativa ainda é contabilizada em usage.server_tool_use_details.tool_calls_requested.
orq:google_search continua aceito como alias legado. O alias não oferece suporte aos campos de configuração acima.
Tratamento de dados
O Toqan Router executa cada pesquisa pelo Serper, o provedor por trás da configuraçãoengine.
Cada pesquisa envia a consulta escrita pelo modelo, além das opções de pesquisa definidas por ele: quantidade de resultados, localização, país, idioma, correção automática e filtro de tempo. O prompt e a conversa permanecem com o provedor de modelo escolhido para a resposta.
A consulta e os resultados aparecem em Traces com o restante da resposta. A forma como o Serper armazena e retém a consulta segue a política de privacidade do Serper; para retenção e mascaramento na plataforma, consulte Conformidade de dados.
Ferramentas relacionadas
Use Web fetch quando um prompt já contiver a URL a ser lida. O web search encontra páginas; o web fetch recupera uma página específica. Para web search nativo do provedor em/responses, use Web search na Responses API com os tipos de ferramenta web_search / web_search_preview.
