Visão geral
Os modelos de app são um caminho de configuração para workspaces Business e Enterprise que precisam de uma versão específica do workspace de um app ou conector do ChatGPT. Em vez de habilitar um app compartilhado do diretório, um administrador ou proprietário do workspace começa com um modelo fornecido pela OpenAI, adiciona os detalhes exclusivos da organização e cria um app em rascunho para revisão.
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 locatário ou nome de host, credenciais de cliente OAuth, URLs de callback, escopos, detalhes de webhook, URLs de servidor MCP gerenciado 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 publicado do workspace criado a partir dele. Os administradores podem então 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 do Codex também podem incluir modelos de app ou apps criados a partir de modelos. Se um plugin incluir um modelo de app, um administrador ou proprietário do workspace ainda precisará criar e publicar o app específico do workspace antes que os membros possam conectá-lo no ChatGPT e 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 necessário ainda não tiver sido configurado, os membros talvez precisem que um administrador conclua a configuração primeiro. O plugin não pode usar um modelo de app por si só.
Use este artigo para 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 de sua própria configuração.
Exemplos comuns incluem:
A URL do provedor inclui um locatário, conta, organização ou nome de host do workspace da empresa.
A organização precisa usar 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 dos apps comuns
Um app comum geralmente pode ser habilitado diretamente pelo diretório de apps. Em vez disso, um modelo inicia um fluxo de configuração.
O fluxo usual é:
Um administrador encontra um modelo no diretório de apps.
O administrador insere a configuração necessária específica do workspace.
O ChatGPT cria um app em rascunho para o workspace.
O administrador revisa e publica o rascunho.
O administrador define as configurações de acesso e ação para o app publicado.
Os membros usam o app publicado do workspace, 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 GitHub App.
Escopos solicitados.
Detalhes de configuração do webhook.
Revise cada campo com cuidado antes de criar o rascunho. Se sua organização gerencia credenciais de OAuth ou do provedor centralmente, coordene com a equipe responsável por essas credenciais.
Veja as instruções específicas do app: GitHub, Snowflake e Databricks.
Configuração do cliente OAuth
Alguns modelos exigem que sua organização use 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 padrões, a menos que sua organização tenha revisado as permissões do provedor e tenha um motivo claro para alterá-las.
Criar um rascunho
Depois de inserir as informações necessárias, selecione Criar rascunho.
Criar um rascunho não disponibiliza automaticamente o app para os membros. Revise o rascunho, publique-o e defina as configurações de acesso e ação 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 que 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 pergunta aos membros antes de usar o app.
Peça que um usuário de teste autorizado abra Apps no ChatGPT e confirme que o app aparece.
Se o app exigir autenticação do provedor, peça que o usuário de teste conecte sua conta do provedor.
Execute um prompt de teste de baixo risco para confirmar que o app funciona conforme esperado.
Essas permissões de app se aplicam às conversas do ChatGPT. Os agentes do workspace usam controles por agente definidos pelo criador do agente para determinar quais ações de app estão disponíveis e quando os usuários finais devem aprová-las. Para o comportamento do agente, consulte: Agentes de workspace do ChatGPT 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 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 criado a partir do modelo. Se um membro pode 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 ainda se aplicam.
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.
Os apps publicados aparecerão no diretório de apps do ChatGPT, na seção específica do workspace.
Solução de problemas
Se a configuração falhar ou o app não aparecer, confirme o seguinte:
O locatário, 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á sendo testada.
Observações 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 Controle de 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 pergunta aos membros antes de usar o app.
Observe que as permissões do provedor ainda se aplicam depois que o app é habilitado no ChatGPT.