Histórico de alterações da interface de plugins

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

Os aplicativos que usam documentos de metadados de ID de cliente (CIMD) também podem usar https://chatgpt.com/oauth/client.json como ID de cliente estável. Nos servidores sem suporte à identificação do emissor, os callbacks continuam funcionando como antes. Saiba mais.

O campo _meta["openai/visibility"] foi marcado como obsoleto porque o valor private oculta a ferramenta do modelo sem indicar se ela fica visível para o aplicativo. Isso pode gerar dúvidas sobre a quem a ferramenta se destina. Use _meta.ui.visibility para definir se a ferramenta fica disponível para o modelo, para o aplicativo ou para ambos.

Os usuários do ChatGPT agora podem escolher quando os aplicativos conectados devem pedir permissão: sempre, antes de fazer qualquer alteração ou apenas antes de fazer alterações importantes. Quem usa uma conta pessoal pode definir preferências globais e por aplicativo. Nos planos Business e Enterprise, os administradores controlam as configurações padrão do espaço de trabalho e de cada aplicativo.

Durante a inicialização, o ChatGPT agora fornece as variáveis CSS padronizadas do host para MCP Apps por meio de hostContext.styles.variables. Quando o tema do host muda, o ChatGPT atualiza essas variáveis por meio de ui/notifications/host-context-changed. Isso ajuda os aplicativos a acompanhar os temas claro e escuro do ChatGPT sem precisar definir no código cores específicas do host.

window.openai.toolResponseMetadata agora preserva a estrutura canônica do resultado da ferramenta MCP, incluindo o campo oculto _meta, quando o ChatGPT inicia widgets.

Para ferramentas que exigem aprovação do usuário, o ChatGPT agora envia os dados de entrada da ferramenta ao widget pela notificação de ciclo de vida ui/notifications/tool-input do MCP Apps após a aprovação, em vez de pré-carregar esses dados nas variáveis globais do widget durante a inicialização.

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

A documentação sobre a interface do plugin e o servidor MCP agora mostra outputSchema nos exemplos de ferramentas e recomenda declarar um schema de saída para ferramentas que retornam conteúdo estruturado.

As integrações aprovadas do Apps SDK podiam ser distribuídas como plugins do Codex. No lançamento, os plugins estavam disponíveis apenas no Codex.

Quando a biblioteca de arquivos do usuário no ChatGPT está disponível, os widgets podem usar window.openai.selectFiles() para selecionar arquivos que já estão nela.

Quando a biblioteca de arquivos do usuário no ChatGPT está disponível, os widgets podem usar window.openai.uploadFile(file, { library: true }) para salvar nela os arquivos enviados.

window.openai.uploadFile agora aceita outros tipos de arquivo além de imagens.

O ChatGPT agora é totalmente compatível com a especificação MCP Apps.

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

window.openai.setOpenInAppUrl({ href }) é o método que a API oferece para alterar o destino da opção “Abrir em ” no modo de tela cheia. Se você não chamar esse método, o ChatGPT continuará abrindo o caminho atual do iframe do widget.

openai/widgetDescription, quando presente, tem prioridade sobre resource.description na criação do recurso.

window.openai.sendFollowUpMessage aceita o parâmetro scrollToBottom. O valor padrão é true. Passe false para desativar a rolagem automática até o fim.

Adicionamos orientações sobre compatibilidade com o conhecimento da empresa no ChatGPT para as ferramentas search e fetch. Saiba mais.

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

Com window.openai.requestModal({ template }), agora você pode abrir outro modelo de interface registrado passando o URI usado em registerResource para registrar esse modelo.

Publicamos orientações sobre como preservar o estado na interface do plugin.

Adicionamos a opção de copiar cada trecho de código.

Lançamos um registro de alterações unificado para desenvolvedores.