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

Registro de alterações da interface de plug-ins

Atualizações mais recentes das APIs de compatibilidade da interface de plug-ins e das extensões do ChatGPT.

agosto de 2026

  • Callbacks OAuth e IDs de cliente CIMD estáveis

    Correções e melhorias

    • Os aplicativos do ChatGPT podem usar o callback OAuth estável https://chatgpt.com/connector_platform_oauth_redirect quando seu recurso protegido e seus metadados OAuth identificam o mesmo servidor de autorização e esse servidor oferece suporte à identificação do emissor definida no RFC 9207.

    • Aplicativos que usam Client ID Metadata Documents (CIMD) também podem usar https://chatgpt.com/oauth/client.json como um ID de cliente estável. Servidores sem suporte à identificação do emissor mantêm o comportamento atual de seus callbacks. Saiba mais.

julho de 2026

  • Metadados legados de visibilidade de ferramentas marcados como obsoletos

    Correções e melhorias

    • _meta["openai/visibility"] foi marcado como obsoleto porque seu valor private oculta uma ferramenta do modelo sem especificar sua visibilidade para o aplicativo, o que pode deixar o público-alvo pouco claro. Use _meta.ui.visibility para escolher se uma ferramenta fica disponível para o modelo, para o aplicativo ou para ambos.

junho de 2026

  • Controles de permissão de aplicativos no ChatGPT

    Correções e melhorias

    • Agora, os usuários do ChatGPT podem escolher quando os aplicativos conectados devem pedir permissão: sempre, antes de fazer alterações ou apenas antes de alterações importantes. Contas pessoais podem definir preferências globais e por aplicativo, enquanto administradores dos planos Business e Empresas controlam as configurações padrão do workspace e de cada aplicativo.

maio de 2026

  • Variáveis de estilo do host para MCP Apps

    Correções e melhorias

    • O ChatGPT agora fornece variáveis CSS padronizadas do host para MCP Apps por meio de hostContext.styles.variables durante a inicialização e as atualiza por meio de ui/notifications/host-context-changed quando o tema do host muda, ajudando os aplicativos a acompanhar a aparência do ChatGPT nos modos claro e escuro sem definir cores específicas do host diretamente no código.

  • Atualizações no ciclo de vida das ferramentas do MCP Apps

    Correções e melhorias

    • window.openai.toolResponseMetadata agora preserva o envelope canônico do resultado da ferramenta MCP, incluindo o campo oculto _meta, quando o ChatGPT inicia widgets.

    • Para ferramentas que precisam de aprovação do usuário, o ChatGPT agora fornece os dados de entrada da ferramenta do widget por meio do ciclo de vida ui/notifications/tool-input do MCP Apps após a aprovação, em vez de pré-carregá-los nas variáveis globais iniciais do widget.

  • Instruções do servidor MCP

    Correções e melhorias

    • O ChatGPT agora lê as instruções do servidor MCP retornadas durante a inicialização e as usa junto com os metadados das ferramentas para entender fluxos de trabalho que envolvem várias ferramentas, restrições e orientações aplicáveis a todo o servidor.

  • Exemplos de esquemas de saída

    Correções e melhorias

    • A documentação da interface de plug-ins e de servidores MCP agora mostra outputSchema nos exemplos de ferramentas e recomenda declarar um esquema para ferramentas que retornam conteúdo estruturado.

março de 2026

  • Orientações para distribuição de plug-ins

    Correções e melhorias

    • Integrações aprovadas do Apps SDK podiam ser distribuídas como plug-ins do Codex. No lançamento, os plug-ins estavam disponíveis apenas no Codex.

  • Funções auxiliares para a biblioteca de arquivos em window.openai

    Correções e melhorias

    • window.openai.selectFiles() permite que widgets selecionem arquivos existentes na biblioteca de arquivos do usuário no ChatGPT, quando essa biblioteca estiver disponível.

    • window.openai.uploadFile(file, { library: true }) permite que widgets salvem os arquivos enviados na biblioteca de arquivos do usuário no ChatGPT, quando essa biblioteca estiver disponível.

  • Envio de arquivos que não são imagens

    Correções e melhorias

    • window.openai.uploadFile agora oferece suporte a tipos de arquivo que não são imagens.

fevereiro de 2026

  • Compatibilidade com MCP Apps

  • Atualizações na interface de plug-ins para redirecionamentos, descrições de widgets e rolagem em mensagens de acompanhamento

    Correções e melhorias

    • window.openai.openExternal({ href, redirectUrl }) aceita redirectUrl: false, o que impede que o host acrescente ?redirectUrl=... aos links externos.

    • window.openai.setOpenInAppUrl({ href }) é a forma suportada de alterar o destino de “Abrir em ” em tela cheia; se você não chamar esse método, o ChatGPT continuará abrindo o caminho atual do iframe do widget.

    • openai/widgetDescription é considerado durante a criação do recurso e, quando presente, tem precedência sobre resource.description.

    • window.openai.sendFollowUpMessage aceita o parâmetro scrollToBottom; o valor padrão é true, e você pode passar false para desativar esse comportamento.

janeiro de 2026

  • Orientações de compatibilidade com o conhecimento da empresa

  • Metadados de sessão para chamadas de ferramentas e troca de modelos de interface no requestModal

    Correções e melhorias

    • As chamadas de ferramentas agora incluem _meta["openai/session"], um identificador de conversa anonimizado que você pode usar para correlacionar solicitações dentro de uma sessão do ChatGPT.

    • window.openai.requestModal({ template }) agora permite abrir outro modelo de interface registrado, passando o URI do modelo de registerResource.

novembro de 2025