Descrição geral
Os modelos de aplicações são uma opção de configuração para espaços de trabalho geridos que necessitam de uma versão específica de uma aplicação ou conector do ChatGPT. Os administradores e proprietários de espaços de trabalho podem encontrar modelos na experiência de administração disponível em Aplicações ou Plugins, adicionar uma configuração específica da organização e criar um rascunho de 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 comportamento comum da aplicação, mas cada espaço de trabalho tem de fornecer uma configuração específica do fornecedor. Consoante o modelo, essa configuração pode incluir um inquilino ou nome de anfitrião, credenciais de cliente OAuth, URLs de chamada de retorno, â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 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 do espaço de trabalho que foi criada a partir dele. Os administradores podem então gerir essa aplicação como as restantes aplicações do ChatGPT, incluindo o acesso por função, 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. 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 desse espaço antes de os membros poderem ligá-la no ChatGPT ou utilizá-la 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.
Utilize este artigo para conhecer o fluxo geral dos modelos. Para a configuração específica de cada fornecedor, consulte:
Entre os motivos habituais para utilizar um modelo estão:
O URL do fornecedor inclui o nome de anfitrião de um inquilino, uma conta, uma organização ou um espaço de trabalho da empresa.
A organização tem de fornecer o seu próprio cliente OAuth ou as suas próprias credenciais do fornecedor.
O fornecedor exige uma configuração do URL de chamada de retorno específica do cliente.
A aplicação deve utilizar o mesmo padrão de implementação, mas cada espaço de trabalho controla separadamente o acesso, as ações e as definições de segurança.
Diferenças entre modelos e aplicações normais
Normalmente, uma aplicação comum pode ser ativada diretamente. Um modelo inicia, em alternativa, um fluxo de configuração pelo administrador do espaço de trabalho.
O fluxo habitual é o seguinte:
Um administrador encontra o modelo na experiência 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 do 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 fluxo de configuração. Para saber como navegar no espaço de trabalho, 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 fluxo de configuração.
O fluxo de configuração solicita os dados necessários para criar a aplicação específica do espaço de trabalho. Os campos exatos 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 chamada de retorno.
ID e segredo do cliente OAuth.
Chave privada da aplicação GitHub.
Âmbitos solicitados.
Detalhes da configuração do webhook.
Reveja cuidadosamente cada campo antes de criar o rascunho. Se a sua organização gerir centralmente o OAuth ou as credenciais do fornecedor, coordene o processo com a equipa responsável por essas credenciais.
Para a configuração específica de cada fornecedor, consulte: GitHub Enterprise, Snowflake e Databricks.
Configuração do cliente OAuth
Alguns modelos exigem que a sua organização forneça o respetivo 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 chamada de retorno do ChatGPT para as definições de URL de redirecionamento ou de chamada de retorno 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 disponha de 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 e publique o rascunho 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 disponíveis de Aplicações ou Plugins.
Verificações recomendadas após a publicação:
Confirme que a aplicação aparece em Aplicações ativadas.
Defina o Acesso por função para as funções que devem utilizar a aplicação.
Reveja as Ações de leitura e escrita.
Reveja as Permissões da aplicação para escolher quando o ChatGPT pede confirmação aos membros antes de utilizar a aplicação.
Peça a um utilizador de teste autorizado que aceda a Aplicações ou Plugins, conforme 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 respetiva conta do 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 pelo criador do agente. Para obter mais informações, 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 criar apenas uma aplicação por espaço de trabalho. Se um modelo já tiver sido utilizado, o botão Ativar poderá não estar disponí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 a ver ou utilizar 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 poderão 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, poderá indicar que é necessária uma configuração até um administrador criar e publicar a aplicação específica do espaço de trabalho, a ativar para a função relevante e serem concluídas todas as autorizações necessárias do fornecedor pelo utilizador ou administrador.
Verifique se:
A aplicação está publicada.
A aplicação está ativada para o espaço de trabalho.
A função do membro no espaço de trabalho tem acesso.
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 disponíveis de Aplicações ou Plugins do espaço de trabalho. Se a aplicação fizer parte de um plugin, também poderá 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 chamada de retorno 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.
O acesso por função permite que o utilizador de teste veja a aplicação.
As permissões do fornecedor permitem os dados ou a ação em teste.
Rever os requisitos de segurança
Trate os segredos dos clientes OAuth e as credenciais dos fornecedores como informações confidenciais.
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 confirmação aos membros antes de utilizar a aplicação.
Tenha em conta que as permissões do fornecedor continuam a aplicar-se depois de a aplicação ser ativada no ChatGPT.