Pular para o conteúdo principal
A ferramenta 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.
O modelo escreve a consulta de pesquisa. A configuração na entrada da ferramenta controla o mecanismo, a quantidade de resultados, a quantidade de chamadas e os domínios.

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 em usage.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ção engine. 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. 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.