Visão geral
Os modelos de aplicações permitem configurar uma aplicação do ChatGPT para a sua conta ou espaço de trabalho.
Espaços de trabalho geridos: os administradores e proprietários podem:
Aceder à Consola de administração, selecionar o espaço de trabalho do ChatGPT pretendido e abrir Plugins.
Utilizar Gerir aplicações legadas para os fluxos de trabalho de modelos legados compatíveis.
Adicionar configurações específicas da organização e criar um rascunho da aplicação para revisão.
Contas pessoais: os utilizadores Plus e Pro podem configurar o Databricks e o Snowflake em Definições > Plugins.
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 anfitrião, 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 a aplicação específica do espaço de trabalho que o Codex utiliza para aceder ao anfitrião 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 depois 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 as opções disponíveis de acesso a aplicações baseado em funções. Os administradores também podem gerir os controlos de ações, as permissões da aplicação e a autorização do fornecedor.
Os plugins podem incluir modelos de aplicações ou aplicações criadas a partir de modelos.
Para configurar a aplicação no espaço de trabalho, um administrador ou proprietário tem de a criar e publicar antes de os membros a poderem ligar ao ChatGPT ou utilizar através do plugin. O plugin utiliza essa aplicação publicada no espaço de trabalho; os membros não configuram o modelo.
Consulte este artigo para conhecer o processo geral de utilização de modelos. Para saber como configurar cada fornecedor, consulte:
Os motivos mais comuns para utilizar um modelo incluem:
O URL do fornecedor inclui um nome de anfitrião associado ao inquilino, à conta, à organização ou ao espaço de trabalho da empresa.
A organização precisa de fornecer o seu próprio cliente OAuth ou as suas próprias credenciais do fornecedor.
O fornecedor exige a configuração de um URL de callback específico do cliente.
A aplicação deve seguir o mesmo padrão de implementação, enquanto cada espaço de trabalho controla separadamente o acesso, as ações e as definições de segurança.
Diferenças entre os modelos e as aplicações comuns
As aplicações comuns podem, geralmente, ser ativadas diretamente; os modelos para espaços de trabalho geridos exigem que um administrador crie primeiro uma aplicação específica para o 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 plugin ou modelo em questão permitir a configuração em Plugins na Consola de administração, siga esse processo de configuração. Para os procedimentos abaixo, utilize a interface de Aplicações que continua disponível. Para saber mais 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 de plugins e aplicações.
Aceda a Definições do espaço de trabalho > Aplicações. Também pode aceder à Consola de administração, selecionar o espaço de trabalho pretendido do ChatGPT e abrir Plugins. Selecione Gerir aplicações legadas para abrir a página 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 de anfitrião do GitHub Enterprise.
Configuração do URL de callback.
ID e segredo do cliente OAuth.
Chave privada da aplicação GitHub.
Âmbitos solicitados.
Detalhes de configuração do webhook.
Reveja cuidadosamente cada campo antes de criar o rascunho. Se a sua organização gerir as credenciais OAuth ou do fornecedor de forma centralizada, coordene a configuração com a equipa responsável por essas credenciais.
Para obter instruções de configuração específicas do fornecedor, consulte: GitHub Enterprise, Snowflake e Databricks.
Configuração do cliente OAuth
Alguns modelos exigem que a sua organização forneça 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 corresponde às 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.
A criação de 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 em Plugins. Para isso, aceda à Consola de administração, escolha Plugins e selecione o plugin correspondente à sua aplicação. Também pode gerir a aplicação em Definições do espaço de trabalho > Aplicações. Para saber mais sobre a navegação no espaço de trabalho e o acesso a aplicações legadas, consulte: Controlos de administração, segurança e conformidade de plugins e aplicações.
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 desse fornecedor.
Execute um prompt de teste de baixo risco para confirmar que a aplicação funciona como esperado.
Estas permissões aplicam-se às conversas do ChatGPT. Os agentes do espaço de trabalho utilizam controlos separados, definidos por quem cria o 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 ou da aplicação publicada existente, em vez de criar outra aplicação a partir do mesmo modelo.
O que os membros veem
Os membros veem a aplicação publicada 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 junto 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 junto do fornecedor.
Se um plugin exigir uma aplicação criada a partir de um modelo, pode indicar que é necessário configurá-la 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 necessária junto do fornecedor por parte do utilizador ou do 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 é 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 na secção Aplicações das definições do espaço de trabalho, quando disponível, ou na página Plugins da consola de administração. 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 nome de anfitrião do inquilino, da conta ou 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 aos permitidos pela aplicação OAuth do fornecedor.
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 é suportado.
As permissões 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 após a ativação da aplicação no ChatGPT.