Visão geral
Os modelos de apps permitem configurar um app do ChatGPT para sua conta ou seu espaço de trabalho.
Espaços de trabalho gerenciados: administradores e proprietários podem:
Acessar o Console de administração, selecionar o espaço de trabalho desejado do ChatGPT e abrir Plugins.
Usar Gerenciar apps legados para os fluxos compatíveis com modelos legados.
Adicionar configurações específicas da organização e criar um rascunho do app para revisão.
Contas pessoais: usuários dos planos Plus e Pro podem configurar o Databricks e o Snowflake em Configurações > Plugins.
Os modelos são úteis quando a OpenAI pode fornecer o funcionamento padrão do app, mas cada espaço de trabalho precisa fornecer configurações específicas do provedor. Dependendo do modelo, essas configurações podem incluir um nome de tenant ou 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 app específico do espaço de trabalho que o Codex usa para acessar o host do GitHub Enterprise da organização.
Após a configuração, os membros não usam o modelo original. Eles usam o app do espaço de trabalho criado a partir dele e publicado. Os administradores podem então gerenciar esse app como os outros apps do ChatGPT. No ChatGPT Business, proprietários e administradores ativam ou desativam o app para o espaço de trabalho. No ChatGPT Enterprise/Edu, proprietários e administradores podem usar os controles disponíveis de acesso ao app baseado em funções. Os administradores também podem gerenciar os controles de ações, as permissões do app e a autorização do provedor.
Os plugins podem incluir modelos de apps ou apps criados a partir de modelos.
Para configurar o app no espaço de trabalho, um administrador ou proprietário precisa criá-lo e publicá-lo antes que os membros possam conectá-lo no ChatGPT ou usá-lo pelo plugin. O plugin usa esse app publicado no espaço de trabalho; os membros não configuram o modelo por conta própria.
Consulte este artigo para entender o fluxo geral de uso dos modelos. Para ver as configurações específicas de cada provedor, consulte:
Alguns motivos comuns para usar um modelo são:
A URL do provedor inclui o nome de host de um tenant, conta, organização ou espaço de trabalho da empresa.
A organização precisa fornecer 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 para cada cliente.
O app deve usar o mesmo padrão de implementação, enquanto cada espaço de trabalho controla separadamente o acesso, as ações e as configurações de segurança.
Como os modelos diferem dos apps comuns
Os apps comuns geralmente podem ser ativados diretamente; já os modelos para espaços de trabalho gerenciados exigem que um administrador crie primeiro um app específico para o espaço de trabalho.
O fluxo habitual é:
Um administrador encontra o modelo na área de administração de Apps ou Plugins do espaço de trabalho, dependendo da interface disponível.
O administrador insere as configurações específicas exigidas para o espaço de trabalho.
O ChatGPT cria um rascunho do app para o espaço de trabalho.
O administrador revisa e publica o rascunho.
O administrador define as configurações de acesso e de ações do app publicado.
Os membros usam o app publicado no espaço de trabalho, não o modelo original.
Encontrar e configurar um modelo de app
Os procedimentos abaixo descrevem a interface de administração de Apps. Se o plugin ou modelo em questão oferecer a opção de configuração em Plugins no Console de administração, siga esse fluxo de configuração. Use a interface de Apps que continua disponível para os procedimentos abaixo. Para saber mais sobre a navegação no espaço de trabalho e os controles de administração específicos de cada plano, consulte: Controles de administração, segurança e conformidade para plugins e apps.
Acesse Configurações do espaço de trabalho > Apps. Você também pode acessar o Console de administração, selecionar o espaço de trabalho desejado do ChatGPT e abrir Plugins. Selecione Gerenciar apps legados para abrir a página Apps.
Selecione Diretório.
Pesquise pelo nome do provedor ou do app.
Procure itens identificados 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 espaço de trabalho. Os campos variam de acordo com o modelo.
Por exemplo, um modelo do GitHub Enterprise pode solicitar detalhes como:
Nome e descrição do app.
Nome de host do GitHub Enterprise.
Configuração da URL de callback.
ID e segredo do cliente OAuth.
Chave privada do GitHub App.
Escopos solicitados.
Detalhes da configuração do webhook.
Revise cada campo com atenção antes de criar o rascunho. Se sua organização gerencia as credenciais de OAuth ou do provedor de forma centralizada, alinhe a configuração com a equipe responsável por essas credenciais.
Para configurações específicas de cada provedor, consulte: GitHub Enterprise, Snowflake e Databricks.
Configuração do cliente OAuth
Alguns modelos exigem que sua organização forneça 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 de callback do provedor.
Insira o ID e o segredo do cliente OAuth no ChatGPT somente após confirmar que a configuração do provedor está de acordo com as 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
Após inserir as informações necessárias, selecione Criar rascunho.
Criar um rascunho não disponibiliza o app automaticamente para os membros. Revise o rascunho, publique-o e defina as configurações de acesso e ações antes de pedir aos membros que usem o app.
Publicar e gerenciar o app resultante
Após a publicação, gerencie o app em Plugins. Para isso, acesse o Console de administração, escolha Plugins e selecione o plugin correspondente ao seu app. Você também pode gerenciar o app em Configurações do espaço de trabalho > Apps. Para saber mais sobre a navegação no espaço de trabalho e o acesso a apps legados, consulte: Controles de administração, segurança e conformidade para plugins e apps.
Verificações recomendadas após a publicação:
Confirme se o app aparece em Apps habilitados.
No ChatGPT Business, habilite ou desabilite o app para o espaço de trabalho. No ChatGPT Enterprise/Edu, configure o Acesso por função para as funções que devem usar o app, quando houver suporte ao acesso a apps baseado em funções.
Revise as ações de leitura e gravação em Ações.
Revise as Permissões do app para escolher quando o ChatGPT deve pedir confirmação aos membros antes de usar o app.
Peça a um usuário de teste autorizado que acesse Apps ou Plugins, conforme a opção disponível, e confirme se o app publicado aparece.
Se o app exigir autenticação no provedor, peça ao usuário de teste que conecte sua conta do provedor.
Execute um prompt de teste de baixo risco para confirmar se o app funciona conforme o esperado.
Essas permissões se aplicam às conversas do ChatGPT. Os agentes do espaço de trabalho usam controles separados, definidos pelo criador do agente. Para mais detalhes, consulte: Agentes do espaço de trabalho do ChatGPT para Enterprise e Business.
Se um modelo só puder ser usado uma vez
Alguns modelos podem permitir a criação de apenas um app por espaço de trabalho. Se um modelo já tiver sido usado, o botão Habilitar poderá estar indisponível. Nesse caso, gerencie o rascunho ou app publicado existente, em vez de criar outro a partir do mesmo modelo.
O que os membros veem
Os membros veem o app publicado que foi criado a partir do modelo. A possibilidade de um membro ver ou usar o app depende das configurações do espaço de trabalho e da autorização no 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 espaço de trabalho e de autorização no provedor continuarão se aplicando.
Se um plugin exigir um app criado a partir de um modelo, ele poderá indicar que é necessário configurá-lo até que um administrador crie e publique o app específico do espaço de trabalho, habilite-o para o espaço de trabalho no ChatGPT Business ou para a função relevante no ChatGPT Enterprise/Edu, quando houver suporte ao acesso a apps baseado em funções, e que todas as autorizações necessárias no provedor sejam concluídas pelo usuário ou administrador.
Verifique se:
O app está publicado.
O app está habilitado para o espaço de trabalho.
No ChatGPT Enterprise/Edu, a função do membro no espaço de trabalho tem acesso ao app, quando houver suporte ao acesso a apps baseado em funções.
O membro está no espaço de trabalho correto.
O membro tem as permissões necessárias no provedor externo.
Os apps publicados aparecem nas configurações de Apps disponíveis no espaço de trabalho ou na página Plugins do console de administração. 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.
Solucionar problemas com modelos de apps
Se a configuração falhar ou o app não aparecer, confirme o seguinte:
O nome de host do locatário, da conta ou do espaço de trabalho está correto.
A URL de callback foi copiada exatamente para a configuração do provedor.
O ID e o segredo do cliente OAuth estão corretos.
Os escopos solicitados correspondem ao que o app OAuth do provedor permite.
Um rascunho foi criado.
O rascunho foi publicado.
No ChatGPT Business, o app está habilitado para o espaço de trabalho. No ChatGPT Enterprise/Edu, o acesso por função permite que o usuário de teste veja o app, quando houver suporte ao acesso a apps baseado em funções.
As permissões no provedor permitem o acesso aos dados ou a execução da ação em teste.
Revisar os requisitos de segurança
Trate os segredos de cliente OAuth e as credenciais do provedor como informações confidenciais.
Revise os escopos solicitados antes de criar o rascunho.
Use Ações após a publicação para limitar o que o app pode fazer.
Use Permissões do app para decidir quando o ChatGPT deve pedir confirmação aos membros antes de usar o app.
Observe que as permissões do provedor continuam se aplicando após o app ser habilitado no ChatGPT.