phaseo:web_fetch e uma URL que você já conhece, e o Phaseo busca a página, corta o texto até um limite de tamanho e o devolve antes que o modelo extraia, resuma ou classifique o conteúdo. No fim, você tem uma solicitação que lê uma única página e retorna campos dela, e consegue confirmar no registro qual página ela realmente leu.
A solicitação está pronta para produção com o limite de domínio mostrado. As páginas buscadas são entrada não confiável: o modelo pode encontrar instruções nelas, então valide o que ele retorna. Use a busca na web quando não souber a URL.
Envie uma solicitação fundamentada
O guia de web fetch lista os demais, incluindo
blocked_domains e os mecanismos.
Confira o que ele leu
O resultado da ferramenta, que aparece no registro da solicitação, diz exatamente em qual página o modelo se baseou:final_url depois dos redirecionamentos e truncated antes de confiar que o modelo viu a página inteira. Cada busca soma 1 a usage.server_tool_use.web_fetch_requests.
Conheça os limites
Com o mecanismo padrãodirect, o próprio Phaseo busca a página e reduz o HTML a texto simples. Ele recusa localhost e endereços privados, segue no máximo 5 redirecionamentos e verifica cada redirecionamento com as suas listas de domínios; um redirecionamento fora delas retorna redirect_blocked_by_domain_policy ao modelo.
O web fetch serve para páginas HTML, texto simples e respostas JSON ou XML pequenas. Ele não serve para arquivos binários, para rastrear muitas páginas nem para conferir como uma página é renderizada com JavaScript; use um fluxo com navegador para isso. Se a página for muito grande, restrinja a tarefa de extração em vez de aumentar max_chars.
Comece com uma predefinição ou um endpoint, leia nos registros os detalhes da busca e o truncamento, e ajuste o prompt se o texto buscado for amplo demais antes de ampliar o uso.