Disponibilidade geral da ferramenta de contexto de URL para a API Gemini

18 DE AGOSTO DE 2025
Alisa Fortin Product Manager

A partir de hoje, a ferramenta de contexto de URL está pronta para uso em produção em escala e repleta de recursos novos. A ferramenta permite que os desenvolvedores forneçam contexto adicional aos modelos na forma de URLs, em vez de carregar manualmente o conteúdo, desbloqueando aplicativos de IA generativa mais poderosos e contextuais.

Por padrão, os modelos Gemini têm uma base de conhecimento estática e nenhum acesso direto à Internet. O Embasamento com a Pesquisa Google os conecta à Web para uma descoberta ampla em tempo real. Para uma análise mais profunda, a ferramenta de contexto de URL vai além dos snippets de pesquisa, permitindo que o modelo faça a ingestão e raciocine sobre o conteúdo completo de uma página da Web específica. Essa combinação poderosa, que usa a Pesquisa para a descoberta e o contexto de URL para a análise, é a base para tarefas sofisticadas com várias etapas.


Mais versatilidade com o suporte expandido a conteúdo

Com este lançamento, a ferramenta de contexto de URL expande significativamente os tipos de conteúdo nos quais você pode embasar seus prompts, o que a torna mais versátil para uma gama mais ampla de aplicativos. O suporte agora inclui:

  • Suporte a PDFs: agora, você pode fornecer links diretos para PDFs, permitindo que o Gemini não só extraia texto, mas também entenda tabelas e a estrutura geral dentro delas, o que torna relatórios, artigos e manuais totalmente acessíveis para embasamento.

  • Suporte a imagens: agora, a ferramenta pode processar e analisar imagens, incluindo os formatos PNG, JPEG, BMP e WebP. Isso aproveita os recursos multimodais do Gemini para a compreensão de informações visuais, abrindo portas para a análise de gráficos, diagramas e muito mais.

  • Arquivos da Web e de dados: suporte robusto contínuo a páginas da Web padrão (HTML), dados estruturados (JSON, XML, CSV) e arquivos de texto (texto simples, RTF, CSS, JavaScript).


Pronta para a escala de produção

Para garantir que você possa usar esses recursos expandidos em seus aplicativos, a ferramenta de contexto de URL agora está pronta para uso em produção em escala, com limites e preços atualizados. Os limites de taxa agora são baseados no modelo Gemini específico que você escolher, permitindo uma escala muito maior. A cobrança é feita pelos tokens de entrada adicionados ao contexto, com base na taxa padrão do modelo. Isso torna os custos claros e previsíveis.


Desbloqueio de novos casos de uso

A ferramenta de contexto de URL abre uma ampla gama de fluxos de trabalho agênticos para desenvolvedores. Estes são apenas alguns dos casos de uso que você pode criar:

  • Personalização de interações com clientes: faça o embasamento de agentes de chat de IA com as páginas da Web dos clientes, permitindo que eles forneçam respostas precisas e relevantes a consultas.

  • Comparação de documentos: analise vários relatórios, artigos ou PDFs para identificar diferenças e acompanhar tendências.

  • Sintetização e criação de conteúdo: combine informações de vários URLs de origem para gerar resumos, postagens de blog ou relatórios precisos.

  • Análise de código e documentos: aponte para um repositório do GitHub ou para uma documentação técnica para explicar o código, gerar instruções de configuração ou responder a perguntas técnicas.


Contexto de URL em ação

Já estamos vendo desenvolvedores criarem coisas incríveis com a ferramenta de contexto de URL. Estes são alguns exemplos do mundo real:

CLI do Gemini: a CLI do Gemini, um agente de IA de código aberto que fornece acesso ao Gemini diretamente no terminal, usa a ferramenta de contexto de URL para seu comando web-fetch a fim de permitir que os desenvolvedores interajam de forma rápida e simples com o conteúdo da Web para casos de uso como resumo de páginas da web, extração de informações importantes ou até mesmo traduções para outro idioma.

Web fetch tool in Gemini CLI
Ferramenta de busca na Web na CLI do Gemini

Gladly.ai: a Gladly, uma plataforma de atendimento ao cliente, usa a ferramenta de contexto de URL para criar experiências altamente personalizadas para clientes. Com o fornecimento de links para os sites dos clientes, os agentes criados na plataforma de IA da Gladly podem acessar e entender as informações mais recentes sobre produtos, promoções e artigos de suporte, permitindo respostas mais precisas e relevantes às consultas dos clientes.


Comece a usar hoje

Quer começar a criar com a ferramenta de contexto de URL? Veja um exemplo para começar:

from google import genai
from google.genai.types import Tool, GenerateContentConfig
client = genai.Client()
 
model_id = "gemini-2.5-flash"
tools = [
     {"url_context": {}},
 ]
 
 
response = client.models.generate_content(
    model=model_id,
    contents="What are the top 3 recent announcements from the Gemini API according to https://ai.google.dev/gemini-api/docs/changelog",
    config=GenerateContentConfig(
        tools=tools,
    )
)
for each in response.candidates[0].content.parts:
   print(each.text)
Python

Acesse a documentação sobre contexto de URL para saber mais e ver exemplos de código. Veja a ferramenta em ação por meio de nosso miniapp de demonstração ou encontre a opção de contexto de URL em "Tools" no Google AI Studio para experimentar.

Mal podemos esperar para ver o que você vai criar!