Visão geral
Os modelos de aplicações são uma opção de configuração para espaços de trabalho geridos que precisam de uma versão de uma aplicação ou de um conector do ChatGPT específica para o seu espaço de trabalho. Os administradores e proprietários do espaço de trabalho podem encontrar modelos na interface de administração de Aplicações ou Plugins disponível, adicionar configurações específicas da organização e criar um rascunho da aplicação para revisão. Os modelos de aplicações geridas não aparecem em espaços de trabalho pessoais.
Os modelos são úteis quando a OpenAI pode fornecer o funcionamento comum da aplicação, mas cada espaço de trabalho tem de fornecer a configuração específica do fornecedor. Consoante o modelo, essa configuração pode incluir um nome de inquilino ou de host, credenciais de cliente OAuth, URLs de callback, âmbitos, detalhes de webhooks, URLs de servidores MCP geridos ou outras definições do fornecedor. Por exemplo, um modelo do GitHub Enterprise pode criar o conector específico do espaço de trabalho que o Codex utiliza para aceder ao host do GitHub Enterprise dessa organização.
Após a configuração, os membros não utilizam o modelo original. Utilizam a aplicação publicada no espaço de trabalho, criada a partir desse modelo. Os administradores podem então gerir essa aplicação como as restantes aplicações do ChatGPT. No ChatGPT Business, os proprietários e administradores ativam ou desativam a aplicação para o espaço de trabalho. No ChatGPT Enterprise/Edu, os proprietários e administradores podem utilizar o acesso a aplicações baseado em funções, quando suportado. Os administradores também podem gerir controlos de ações, permissões de aplicações e a autorização do fornecedor.
Os plugins podem incluir modelos de aplicações ou aplicações criadas a partir de modelos. Se um plugin incluir um modelo de aplicação, um administrador ou proprietário do espaço de trabalho tem de criar e publicar a aplicação específica do espaço de trabalho antes de os membros a poderem ligar no ChatGPT ou utilizar através do plugin. O plugin utiliza a instância da aplicação disponível nesse espaço de trabalho; os membros não configuram o modelo original.
Consulte este artigo para conhecer o processo geral de utilização dos modelos. Para obter instruções de configuração específicas de cada fornecedor, consulte:
Entre os motivos habituais para utilizar um modelo estão os seguintes:
O URL do fornecedor inclui um inquilino, uma conta, uma organização ou um nome de host do espaço de trabalho da empresa.
A organização precisa de utilizar o seu próprio cliente OAuth ou as suas próprias credenciais do fornecedor.
O fornecedor exige uma configuração do URL de callback específica de cada cliente.
A aplicação deve seguir o mesmo padrão de implementação, enquanto cada espaço de trabalho controla o acesso, as ações e as definições de segurança de forma independente.
Em que diferem os modelos das aplicações normais
Normalmente, uma aplicação pode ser ativada diretamente. Um modelo, por sua vez, inicia um processo de configuração a realizar pelo administrador do espaço de trabalho.
O processo habitual é o seguinte:
Um administrador encontra o modelo na área de administração de Aplicações ou Plugins do espaço de trabalho, consoante a interface disponível.
O administrador introduz a configuração necessária, específica do espaço de trabalho.
O ChatGPT cria um rascunho da aplicação para o espaço de trabalho.
O administrador revê e publica o rascunho.
O administrador configura as definições de acesso e de ações da aplicação publicada.
Os membros utilizam a aplicação publicada no espaço de trabalho, não o modelo original.
Encontrar e configurar um modelo de aplicação
Os procedimentos abaixo descrevem a interface de administração de Aplicações. Se o seu espaço de trabalho utilizar Administração > Plugins, abra o plugin ou modelo relevante e siga o respetivo processo de configuração. Para obter informações sobre a navegação no espaço de trabalho e os controlos de administração específicos de cada plano, consulte: Controlos de administração, segurança e conformidade para plugins e aplicações.
Aceda a Definições do espaço de trabalho > Aplicações.
Selecione Diretório.
Pesquise o nome do fornecedor ou da aplicação.
Procure entradas identificadas como modelos.
Selecione Ativar para iniciar o processo de configuração.
O processo de configuração solicita os dados necessários para criar a aplicação específica do espaço de trabalho. Os campos apresentados dependem do modelo.
Por exemplo, um modelo do GitHub Enterprise pode solicitar dados como:
Nome e descrição da aplicação.
Nome do host do GitHub Enterprise.
Configuração do URL de callback.
ID e segredo do cliente OAuth.
Chave privada da GitHub App.
Âmbitos solicitados.
Detalhes de configuração do webhook.
Reveja cada campo cuidadosamente antes de criar o rascunho. Se a sua organização gerir as credenciais OAuth ou do fornecedor de forma centralizada, articule este processo com a equipa responsável por essas credenciais.
Para obter instruções de configuração específicas de cada fornecedor, consulte: GitHub Enterprise, Snowflake e Databricks.
Configuração do cliente OAuth
Alguns modelos exigem que a sua organização utilize o seu próprio cliente OAuth. Quando tal for necessário, crie ou configure a aplicação OAuth na consola de administração do fornecedor externo e, em seguida, copie o URL de callback do ChatGPT para as definições de URL de redirecionamento ou de callback do fornecedor.
Introduza o ID e o segredo do cliente OAuth no ChatGPT apenas depois de confirmar que a configuração do fornecedor está de acordo com as instruções de configuração do modelo.
Se o modelo incluir âmbitos predefinidos, mantenha-os, a menos que a sua organização tenha revisto as permissões do fornecedor e tenha um motivo claro para os alterar.
Criar um rascunho
Depois de introduzir as informações necessárias, selecione Criar rascunho.
Criar um rascunho não disponibiliza automaticamente a aplicação aos membros. Reveja o rascunho, publique-o e configure as definições de acesso e de ações antes de pedir aos membros que utilizem a aplicação.
Publicar e gerir a aplicação resultante
Após a publicação, faça a gestão da aplicação específica do espaço de trabalho nas definições de Aplicações ou Plugins disponíveis no espaço de trabalho.
Verificações recomendadas após a publicação:
Confirme que a aplicação aparece em Aplicações ativadas.
No ChatGPT Business, ative ou desative a aplicação para o espaço de trabalho. No ChatGPT Enterprise/Edu, configure o Acesso por função para as funções que devem utilizar a aplicação, quando o acesso a aplicações baseado em funções for suportado.
Reveja as ações de leitura e escrita em Ações.
Reveja as Permissões da aplicação para escolher quando o ChatGPT pede autorização aos membros antes de utilizar a aplicação.
Peça a um utilizador de teste autorizado que aceda a Aplicações ou Plugins, consoante a opção disponível, e confirme que a aplicação publicada aparece.
Se a aplicação exigir autenticação junto do fornecedor, peça ao utilizador de teste que ligue a sua conta do fornecedor.
Execute um prompt de teste de baixo risco para confirmar que a aplicação funciona conforme esperado.
Estas permissões aplicam-se às conversas do ChatGPT. Os agentes do espaço de trabalho utilizam controlos 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 utilizado uma vez
Alguns modelos podem permitir criar apenas uma aplicação por espaço de trabalho. Se um modelo já tiver sido utilizado, o botão Ativar pode estar indisponível. Nesse caso, faça a gestão do rascunho existente ou da aplicação publicada, em vez de criar outra a partir do mesmo modelo.
O que os membros veem
Os membros veem a aplicação publicada que foi criada a partir do modelo. A possibilidade de um membro ver ou utilizar a aplicação depende das definições do espaço de trabalho e da autorização do fornecedor. Se a aplicação estiver incluída num plugin, os membros podem encontrá-la através desse plugin, mas continuam a aplicar-se os mesmos requisitos de acesso ao espaço de trabalho e de autorização do fornecedor.
Se um plugin exigir uma aplicação criada a partir de um modelo, pode indicar que é necessária uma configuração até que um administrador crie e publique a aplicação específica do espaço de trabalho, a ative para o espaço de trabalho no ChatGPT Business ou para a função relevante no ChatGPT Enterprise/Edu, quando o acesso a aplicações baseado em funções for suportado, e seja concluída qualquer autorização do fornecedor exigida ao utilizador ou ao administrador.
Verifique se:
A aplicação está publicada.
A aplicação está ativada para o espaço de trabalho.
No ChatGPT Enterprise/Edu, a função do membro no espaço de trabalho tem acesso, quando o acesso a aplicações baseado em funções for suportado.
O membro está no espaço de trabalho correto.
O membro tem as permissões necessárias no fornecedor externo.
As aplicações publicadas aparecem nas definições de Aplicações ou Plugins disponíveis no espaço de trabalho. Se a aplicação fizer parte de um plugin, também pode aparecer como aplicação obrigatória ou opcional na página de detalhes do plugin.
Resolver problemas com modelos de aplicações
Se a configuração falhar ou a aplicação não aparecer, confirme o seguinte:
O inquilino, a conta ou o nome do host do espaço de trabalho está correto.
O URL de callback foi copiado exatamente para a configuração do fornecedor.
O ID e o segredo do cliente OAuth estão corretos.
Os âmbitos solicitados correspondem ao que a aplicação OAuth do fornecedor permite.
Foi criado um rascunho.
O rascunho foi publicado.
No ChatGPT Business, a aplicação está ativada para o espaço de trabalho. No ChatGPT Enterprise/Edu, o acesso por função permite ao utilizador de teste ver a aplicação, quando o acesso a aplicações baseado em funções for suportado.
As permissões do lado do fornecedor permitem o acesso aos dados ou a execução da ação em teste.
Rever os requisitos de segurança
Trate os segredos de cliente OAuth e as credenciais do fornecedor como informações sensíveis.
Reveja os âmbitos solicitados antes de criar o rascunho.
Após a publicação, utilize Ações para limitar o que a aplicação pode fazer.
Utilize Permissões da aplicação para decidir quando o ChatGPT pede autorização aos membros antes de utilizar a aplicação.
Tenha em atenção que as permissões do fornecedor continuam a aplicar-se depois de a aplicação ser ativada no ChatGPT.