A partir de 9 de julho de 2026, migramos o diretório de apps para o diretório de plugins. Os plugins são a principal forma de descobrir recursos de fluxo de trabalho no ChatGPT e no Codex. Um plugin pode incluir habilidades, apps e modelos de app — os apps continuam sendo as integrações que conectam o ChatGPT ou o Codex a dados e ações externos, enquanto os plugins facilitam a habilitação de fluxos de trabalho no ChatGPT. As conexões de apps existentes não são afetadas, e os usuários podem adicionar novos plugins pelo diretório de plugins, conectando e autenticando o app subjacente como antes. Admins de workspace gerenciam a instalação de plugins em Configurações do workspace > Plugins e podem gerenciar o acesso e as permissões de cada app subjacente dentro da configuração do plugin ou em Configurações do workspace > Apps.
Visão geral
Modelos de app são um caminho de configuração para workspaces gerenciados que precisam de uma versão específica do workspace de um app ou conector do ChatGPT. Admins e proprietários de workspace encontram modelos em Configurações do workspace > Apps > Diretório, adicionam a configuração específica da organização e criam um rascunho de app para revisão. Modelos de app gerenciados não aparecem em workspaces pessoais.
Os modelos são úteis quando a OpenAI pode fornecer o comportamento comum do app, mas cada workspace precisa fornecer a configuração específica do provedor. Dependendo do modelo, essa configuração pode incluir um tenant ou nome de host, credenciais de cliente OAuth, URLs de callback, escopos, detalhes de webhook, URLs de servidores MCP gerenciados ou outras configurações do provedor. Por exemplo, um modelo do GitHub Enterprise pode criar o conector específico do workspace que o Codex usa para acessar o host do GitHub Enterprise dessa organização.
Após a configuração, os membros não usam o modelo original. Eles usam o app do workspace publicado que foi criado a partir dele. Depois, os admins podem gerenciar esse app como outros apps do ChatGPT, incluindo acesso por função, controles de ação, permissões do app e autorização do provedor.
Plugins também podem incluir modelos de app ou apps criados a partir de modelos. Se um plugin incluir um modelo de app, um admin ou proprietário do workspace ainda precisará criar e publicar o app específico do workspace para que os membros possam conectá-lo no ChatGPT ou usá-lo por meio desse plugin. Quando o plugin é executado, ele usa a instância do app disponível nesse workspace, em vez de pedir que os membros configurem o modelo original por conta própria. Se o modelo obrigatório ainda não tiver sido configurado, os membros talvez precisem que um admin conclua a configuração primeiro. O plugin não consegue usar um modelo de app por conta própria.
Use este artigo para entender o fluxo geral de modelos. Para configuração específica do provedor, consulte:
Os modelos são úteis quando o mesmo padrão de app pode funcionar em muitas organizações, mas cada organização precisa da própria configuração.
Exemplos comuns incluem:
A URL do provedor inclui um tenant, uma conta, uma organização ou um nome de host do workspace da empresa.
A organização precisa trazer seu próprio cliente OAuth ou suas próprias credenciais do provedor.
O provedor exige a configuração de uma URL de callback específica do cliente.
O app deve usar o mesmo padrão de implementação, enquanto cada workspace controla acesso, ações e configurações de segurança separadamente.
Como os modelos diferem dosapps comuns
Um app comum geralmente pode ser habilitado diretamente. Já um modelo inicia um fluxo de configuração para admin do workspace.
O fluxo normal é:
Um admin encontra um modelo em Configurações do workspace > Apps > Diretório.
O admin insere a configuração obrigatória específica do workspace.
O ChatGPT cria um rascunho de app para o workspace.
O admin revisa e publica o rascunho.
O admin configura o acesso e as configurações de ação para o app publicado.
Os membros usam o app do workspace publicado, não o modelo original.
Encontrar e configurar um modelo de app
Abra Configurações do workspace > Apps.
Selecione Diretório.
Pesquise pelo nome do provedor ou do app.
Procure entradas marcadas como modelos.
Selecione Habilitar para iniciar o fluxo de configuração.
O fluxo de configuração solicita os detalhes necessários para criar o app específico do workspace. Os campos exatos dependem do modelo.
Por exemplo, um modelo do GitHub Enterprise pode solicitar detalhes como:
Nome e descrição do app.
Nome do host do GitHub Enterprise.
Configuração da URL de callback.
ID do cliente OAuth e segredo do cliente.
Chave privada do app do GitHub.
Escopos solicitados.
Detalhes de configuração do webhook.
Revise cada campo com cuidado antes de criar o rascunho. Se sua organização gerencia OAuth ou credenciais de provedor de forma centralizada, coordene com a equipe responsável por essas credenciais.
Consulte as instruções específicas do app:GitHub,Snowflake eDatabricks.
Configuração do cliente OAuth
Alguns modelos exigem que sua organização traga seu próprio cliente OAuth. Quando isso for necessário, crie ou configure o app OAuth no console de administração do provedor externo e copie a URL de callback do ChatGPT para as configurações de URL de redirecionamento ou callback do provedor.
Insira o ID e o segredo do cliente OAuth no ChatGPT somente depois de confirmar que a configuração do provedor corresponde às instruções de configuração do modelo.
Se o modelo incluir escopos padrão, mantenha-os, a menos que sua organização tenha revisado as permissões do provedor e tenha um motivo claro para alterá-los.
Criar um rascunho
Depois de inserir as informações obrigatórias, selecione Criar rascunho.
Criar um rascunho não disponibiliza o app automaticamente para os membros. Revise o rascunho, publique-o e configure o acesso e as ações antes de pedir que os membros o usem.
Publicar e gerenciar o app resultante
Após a publicação, gerencie o app específico do workspace em Configurações do workspace > Apps > Habilitados.
Verificações recomendadas após a publicação:
Confirme se o app aparece em Apps habilitados.
Defina Acesso do usuário para as funções que devem usar o app.
Revise Controle de ações para ações de leitura e gravação.
Revise Permissões do app para escolher quando o ChatGPT deve perguntar aos membros antes de usar o app.
Peça a um usuário de teste permitido que abra Apps no ChatGPT e confirme se o app aparece.
Se o app exigir autenticação do provedor, peça ao usuário de teste que conecte sua conta do provedor.
Execute um prompt de teste de baixo risco para confirmar que o app funciona como esperado.
Essas permissões do app se aplicam a conversas do ChatGPT. Agentes do Workspace usam controles por agente definidos pelo criador do agente para determinar quais ações do app estão disponíveis e quando os usuários finais devem aprová-las. Para comportamento de agente, consulte:Agentes do ChatGPT Workspace para Enterprise e Business.
Se um modelo só puder ser usado uma vez
Alguns modelos podem criar apenas um app por workspace. Se um modelo já tiver sido usado, o botão Habilitar poderá estar indisponível. Nesse caso, gerencie o rascunho existente ou o app publicado em vez de criar outro a partir do mesmo modelo.
O que os membros veem
Os membros veem o app publicado criado a partir do modelo. A possibilidade de um membro vê-lo ou usá-lo depende das configurações do workspace e da autorização do provedor. Se o app estiver incluído em um plugin, os membros poderão encontrá-lo por meio desse plugin, mas os mesmos requisitos de acesso ao workspace e autorização do provedor continuarão valendo.
Se um plugin exigir um app criado a partir de um modelo, ele poderá indicar que a configuração é necessária até que um admin crie e publique o app específico do workspace, habilite-o para a função relevante e conclua qualquer autorização obrigatória do usuário ou do admin no provedor.
Verifique se:
O app está publicado.
O app está habilitado para o workspace.
A função do membro no workspace tem acesso.
O membro está no workspace correto.
O membro tem as permissões necessárias no provedor externo.
Apps publicados aparecem em Configurações do workspace > Apps > Habilitados. Se o app fizer parte de um plugin, ele também poderá aparecer como app obrigatório ou opcional na página de detalhes do plugin.
Solução de problemas
Se a configuração falhar ou o app não aparecer, confirme o seguinte:
O tenant, a conta ou o nome do host do workspace está correto.
A URL de callback foi copiada exatamente para a configuração do provedor.
O ID do cliente OAuth e o segredo do cliente estão corretos.
Os escopos solicitados correspondem ao que o app OAuth do provedor permite.
Um rascunho foi criado.
O rascunho foi publicado.
O acesso por função permite que o usuário de teste veja o app.
As permissões do lado do provedor permitem os dados ou a ação que estão sendo testados.
Notas de segurança
Trate os segredos do cliente OAuth e as credenciais do provedor como informações confidenciais.
Revise os escopos solicitados antes de criar o rascunho.
Use Controle de ações depois da publicação para limitar o que o app pode fazer.
Use Permissões do app para decidir quando o ChatGPT deve perguntar aos membros antes de usar o app.
Observe que as permissões do provedor continuam valendo depois que o app é habilitado no ChatGPT.