For the complete documentation index, see llms.txt. Markdown versions of documentation pages are available by appending .md to the page URL.
Navegação principal
Theme

Ferramentas do site

Use o WebMCP para que agentes de IA possam interagir diretamente com seu site

As ferramentas do site implementam no ChatGPT a proposta de padrão WebMCP. Com o WebMCP, um site pode oferecer ações úteis diretamente a um agente de IA, além da interface que as pessoas já usam. Você e o agente podem interagir com a mesma página em tempo real, na mesma sessão autenticada.

No navegador integrado do aplicativo ChatGPT para desktop, o ChatGPT Work e o Codex podem descobrir e usar essas ferramentas quando estiverem disponíveis.

Para usar as ferramentas do site, você precisa de um modelo compatível e de uma página que ofereça ferramentas. O acesso pode ser concedido pela sua conta ou pela política de navegador do seu espaço de trabalho gerenciado. As configurações do navegador e as permissões do site continuam em vigor.

Diferenças entre WebMCP e MCP

O Model Context Protocol (MCP) conecta um aplicativo de IA a um servidor local ou remoto. Suas ferramentas podem funcionar mesmo sem uma página aberta. Elas podem, por exemplo, fazer buscas em um serviço ou gerenciar registros por meio de uma API.

Com o WebMCP, um site pode disponibilizar seus recursos a um agente por meio de um conjunto de ferramentas predefinidas. O agente pode descobrir essas ferramentas ao visitar o site. Assim, quem quiser usar esses recursos não precisa instalar um servidor MCP separado nem configurar outra conexão.

Essa abordagem é útil quando você e o agente precisam ver o mesmo conteúdo, por exemplo, ao editar uma área de desenho ou explorar um painel. Um plugin com um servidor MCP pode oferecer uma integração que funciona mesmo sem uma página aberta. Um site pode oferecer as duas opções.

Como funciona no navegador

Abra um site no navegador integrado e peça ao ChatGPT Work ou ao Codex que ajude em uma tarefa. Se a página oferecer ferramentas do site, o agente poderá descobrir e usar as ações relevantes no site que você está visualizando. Um editor de documentos, por exemplo, pode permitir que o agente encontre uma seção ou deixe um comentário para você revisar.

Selecione Ferramentas do site na barra de endereço do navegador para ver o que o site oferece. Escolha Ferramentas do site disponíveis para examinar cada ferramenta. O navegador verifica cada solicitação antes que o site a execute, e o agente pode examinar a página para ver o que mudou. Quando houver atividade recente, escolha Usadas recentemente para abrir Fontes e revisar essas chamadas.

Neste exemplo, expanda Ferramentas do site disponíveis para examinar as ferramentas que o Margin oferece.

Site tools
Site tools help ChatGPT use this website to complete tasks more accurately and with fewer steps. Learn more

As ferramentas pertencem à página que as oferece. Se você fechar a página ou navegar para outra, as ferramentas podem ficar indisponíveis. Se não houver uma ferramenta adequada, o agente talvez ainda consiga usar os recursos habituais do navegador.

Exemplo de como explorar a documentação da OpenAI

O ChatGPT Learn e o OpenAI Developers oferecem ferramentas do site para buscar e ler a documentação. Selecione Abrir no ChatGPT no editor para abrir o Learn no navegador do aplicativo para desktop, ao lado de um novo chat com este prompt pronto para envio.

O agente pode usar estas ferramentas para buscar, ler e abrir a página relevante.

Ferramenta O que faz
search_openai_docs Faz buscas na documentação da OpenAI.
lookup_page Lê uma página da documentação a partir de um caminho ou URL.
lookup_context Lê a rota atual da documentação e o texto selecionado.
navigate_to_page Abre uma página correspondente à busca no site de documentação atual.
generate_custom_guide Inicia a criação de um guia personalizado de desenvolvimento ou aprendizado e retorna o status e o link do guia.

O Docs Agent gera o guia personalizado de forma assíncrona. Você pode receber o link antes que o guia esteja pronto.

Segurança e controles do usuário

Trate como conteúdo não confiável as definições e os resultados das ferramentas que o site oferece. Nem o nome de uma ferramenta nem a alegação de que ela apenas lê dados comprovam o que ela faz. As instruções do site não dão ao agente permissão para compartilhar informações alheias à tarefa ou realizar ações sensíveis.

No navegador integrado, cada chamada de ferramenta passa por uma revisão de segurança antes da execução. As políticas habituais de acesso a sites e de confirmação continuam em vigor, inclusive para ações com consequências importantes, como enviar mensagens, fazer compras, excluir dados ou alterar permissões. O navegador vincula cada chamada à página de origem e ao registro da ferramenta. Essas verificações reduzem o risco, mas não tornam o site nem seus resultados confiáveis.

Você pode desativar Habilitar ferramentas do site em Configurações > Navegador > Permissões. Antes de compartilhar informações sensíveis ou confiar em uma alteração, examine o site, a ação solicitada e o resultado.

Relate vulnerabilidades de segurança pelo programa de recompensas por vulnerabilidades de segurança da OpenAI. Para riscos relacionados à segurança da IA, consulte o programa de recompensas por falhas de segurança em IA. Observe o escopo de cada programa e siga as instruções para enviar relatos.

Limitações

No momento, as ferramentas do site funcionam apenas no navegador integrado do aplicativo ChatGPT para desktop.

Adicione o WebMCP ao seu site

Você pode pedir ao Codex que adicione suporte ao WebMCP ao aplicativo web ou Site que você está desenvolvendo. Descreva o que o agente deve ser capaz de fazer e peça ao Codex que reutilize a lógica e as permissões existentes no aplicativo.

Registre uma ferramenta com JavaScript ou adicione atributos do WebMCP a um formulário HTML. O navegador integrado pode descobrir ferramentas na página de nível superior e em iframes, tanto da mesma origem quanto de outra origem. Cada frame deve usar um contexto seguro. O navegador verifica o acesso para a origem que fornece a ferramenta. O agente pode descobrir a ferramenta mesmo que você omita exposedTo.

Comece com uma operação que seu aplicativo já permite realizar, como nos exemplos a seguir.

  • Um painel em que o agente pode definir um intervalo de datas e examinar os dados que compõem um gráfico.
  • Um editor de documentos em que o agente pode encontrar uma seção, sugerir uma alteração ou deixar um comentário para você revisar.
  • Um planejador de viagens em que o agente pode comparar opções e atualizar um itinerário enquanto você examina o mapa.

Você também pode escrever o código. No módulo JavaScript da página, verifique se o navegador oferece suporte ao recurso e registre uma ferramenta. Este exemplo somente leitura retorna o título da página atual.

if (typeof document.modelContext?.registerTool === "function") {
  await document.modelContext.registerTool({
    name: "get_page_title",
    description: "Read the title of the current page.",
    inputSchema: {
      type: "object",
      properties: {},
      additionalProperties: false,
    },
    annotations: { readOnlyHint: true },
    execute: async () => ({ title: document.title }),
  });
}

Um agente compatível pode descobrir get_page_title e receber o título atual da página. Se a ferramenta aceitar argumentos, descreva-os no schema de entrada e use-os na função execute para chamar a lógica existente no aplicativo.

Limite as entradas ao necessário, descreva os efeitos colaterais e retorne informações suficientes para verificar o resultado. Use os mecanismos de autenticação, autorização e validação de entradas já existentes no aplicativo. Mantenha a interface habitual para as pessoas e para os navegadores sem suporte ao WebMCP.

Para consultar detalhes da API e exemplos, veja a especificação do WebMCP e o guia do Chrome para desenvolvedores.