orq:web_fetch recupera texto de uma URL escolhida pelo modelo. O AI Gateway verifica a URL antes de buscá-la e retorna o conteúdo extraído ao modelo.
Início rápido
Os exemplos usam a configuração de cliente da Visão geral das ferramentas de servidor.Configuração
As entradas de domínio devem ser hostnames simples, como
example.com. Uma entrada com esquema, caminho ou curinga *. retorna 400. Os subdomínios correspondem por sufixo, então example.com também abrange docs.example.com.
Restrições de URL
A ferramenta aceita URLs públicashttp e https. Ela rejeita localhost, hostnames terminados em .localhost, .local ou .internal e qualquer endereço de loopback, link-local, privado, multicast, não especificado ou que, por outro motivo, não seja roteável globalmente. O hostname deve resolver para um endereço público, e os endereços resolvidos também são verificados. As regras de domínio são verificadas antes da busca.
Quando uma URL é rejeitada, o modelo recebe o motivo e pode escolher outra URL. URLs rejeitadas não consomem uma vaga de max_uses.
Uso
As buscas que passam pela validação de URL e pelo limite de uso aparecem emusage.server_tool_use.web_fetch_requests. Não há cobrança separada de ferramenta de servidor para web fetch nesta versão.
orq:web_scraper continua aceito como alias legado. O alias não oferece suporte aos campos de configuração acima.
Use Web search quando a URL não for conhecida com antecedência.
