Descrição geral
Os modelos de aplicações são um percurso de configuração para espaços de trabalho Business e Enterprise que precisam de uma versão específica do espaço de trabalho de uma aplicação ou conector do ChatGPT. Em vez de ativar uma aplicação partilhada a partir do diretório, um administrador ou proprietário do espaço de trabalho começa a partir de um modelo fornecido pela OpenAI, adiciona os detalhes exclusivos da sua organização e cria uma aplicação em rascunho para revisão.
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 a configuração específica do fornecedor. Consoante o modelo, essa configuração pode incluir um tenant ou nome de anfitrião, credenciais de cliente OAuth, URLs de callback, âmbitos, detalhes de webhook, 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 criada a partir dele. Os administradores podem então gerir essa aplicação como outras aplicações do ChatGPT, incluindo acesso por função, controlos de ações, permissões da aplicação e autorização do fornecedor.
Os plugins do Codex também 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 continua a ter de criar e publicar a aplicação específica do espaço de trabalho antes de os membros a poderem ligar no ChatGPT e utilizá-la através desse plugin. Quando o plugin é executado, utiliza a instância da aplicação disponível nesse espaço de trabalho, em vez de pedir aos membros que configurem eles próprios o modelo original. Se o modelo necessário ainda não tiver sido configurado, os membros poderão precisar que um administrador conclua primeiro a configuração. O plugin não consegue utilizar um modelo de aplicação por si só.
Utilize este artigo para o fluxo geral de modelos. Para a configuração específica do fornecedor, consulte:
Os modelos são úteis quando o mesmo padrão de aplicação pode funcionar em muitas organizações, mas cada organização precisa da sua própria configuração.
Exemplos comuns incluem:
A URL do fornecedor inclui um tenant, conta, organização ou nome de anfitrião do espaço de trabalho da empresa.
A organização precisa de trazer o seu próprio cliente OAuth ou as suas próprias credenciais do fornecedor.
O fornecedor exige a configuração de uma URL de callback específica do cliente.
A aplicação deve utilizar 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.
Como os modelos diferem das aplicações normais
Normalmente, uma aplicação normal pode ser ativada diretamente a partir do diretório de aplicações. Em vez disso, um modelo inicia um fluxo de configuração.
O fluxo habitual é:
Um administrador encontra um modelo no diretório de aplicações.
O administrador introduz a configuração necessária específica do espaço de trabalho.
O ChatGPT cria uma aplicação em rascunho para o espaço de trabalho.
O administrador revê e publica o rascunho.
O administrador configura o acesso e as definições 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
Abra Definições do espaço de trabalho > Aplicações.
Selecione Diretório.
Pesquise o fornecedor ou o nome da aplicação.
Procure entradas marcadas como modelos.
Selecione Ativar para iniciar o fluxo de configuração.
O fluxo de configuração pede os detalhes 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 pedir detalhes como:
Nome e descrição da aplicação.
Nome de anfitrião do GitHub Enterprise.
Configuração da URL de callback.
ID de cliente OAuth e segredo de cliente.
Chave privada da aplicação GitHub.
Âmbitos pedidos.
Detalhes de configuração do webhook.
Reveja cuidadosamente cada campo antes de criar o rascunho. Se a sua organização gerir OAuth ou credenciais de fornecedor centralmente, coordene-se com a equipa responsável por essas credenciais.
Consulte as instruções específicas da aplicação: GitHub, Snowflake e Databricks.
Configuração do cliente OAuth
Alguns modelos exigem que a sua organização traga o seu próprio cliente OAuth. Quando isto for necessário, crie ou configure a aplicação OAuth na consola de administração do fornecedor externo e, em seguida, copie a 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.
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 o utilizem.
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 em Definições do espaço de trabalho > Aplicações > Ativadas.
Verificações recomendadas após a publicação:
Confirme que a aplicação aparece em Aplicações ativadas.
Defina Acesso de utilizador para as funções que devem utilizar a aplicação.
Reveja Controlo de ações para ações de leitura e escrita.
Reveja 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 abra Aplicações no ChatGPT e confirme que a aplicação aparece.
Se a aplicação exigir autenticação 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 como esperado.
Estas permissões da aplicação aplicam-se às conversas do ChatGPT. Os Agentes do espaço de trabalho utilizam controlos por agente definidos pelo criador do agente para determinar que ações da aplicação estão disponíveis e quando é pedido aos utilizadores finais que as aprovem. Para o comportamento do agente, consulte: Agentes de 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á 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 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.
Verifique que:
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 aparecerão no diretório de aplicações do ChatGPT, na secção específica do espaço de trabalho.
Resolução de problemas
Se a configuração falhar ou a aplicação não aparecer, confirme o seguinte:
O tenant, a conta ou o nome de anfitrião do espaço de trabalho está correto.
A URL de callback foi copiada exatamente para a configuração do fornecedor.
O ID de cliente OAuth e o segredo de cliente estão corretos.
Os âmbitos pedidos correspondem ao que a aplicação OAuth do fornecedor permite.
Foi criado um rascunho.
O rascunho foi publicado.
O acesso por função permite ao utilizador de teste ver a aplicação.
As permissões do lado do fornecedor permitem os dados ou a ação que está a ser testada.
Notas de segurança
Trate os segredos de cliente OAuth e as credenciais do fornecedor como informações sensíveis.
Reveja os âmbitos pedidos antes de criar o rascunho.
Utilize Controlo de ações após a publicação 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 atenção que as permissões do fornecedor continuam a aplicar-se depois de a aplicação ser ativada no ChatGPT.