Visão geral
Plugins ajudam o Codex a concluir trabalhos repetíveis ao empacotar os recursos necessários para um fluxo de trabalho específico. Um plugin pode incluir orientações de fluxo de trabalho, como habilidades, e também depender de apps aprovados que conectam o Codex a ferramentas, dados ou ações.
Para workspaces Business, Enterprise e Edu, a disponibilidade de plugins pode depender das configurações do workspace, do acesso ao recurso e dos apps que um administrador habilitou. Um plugin não concede novo acesso a dados por si só. Os usuários só podem usar recursos baseados em apps quando o app conectado está disponível para eles e eles já têm acesso ao sistema de origem subjacente.
Este artigo é para administradores, proprietários e usuários de workspace que precisam entender como os plugins funcionam e o que precisa ser habilitado antes que um plugin possa ser usado.
O que é um plugin?
Um plugin é um recurso empacotado para um fluxo de trabalho. Dependendo do plugin, ele pode incluir:
Habilidades, que fornecem instruções, prompts e padrões de fluxo de trabalho reutilizáveis que ajudam o Codex a concluir uma tarefa.
Apps, que conectam o Codex a sistemas, dados e ações aprovados para seu workspace.
Modelos de app, que ajudam um administrador a criar ou configurar o app de que o plugin precisa.
Alguns plugins são amplos, enquanto outros são criados para uma linha de negócios específica, como vendas, análise de dados ou operações internas. Um plugin de linha de negócios pode reunir vários recursos para que os usuários concluam um trabalho sem alternar manualmente entre ferramentas separadas.
Um único plugin pode ter várias habilidades e apps, permitindo que os usuários realizem uma grande variedade de tarefas. Administradores e proprietários podem habilitar alguns ou todos os apps dentro de um plugin, dependendo da política organizacional. Por exemplo, um plugin focado em vendas pode incluir vários recursos baseados em apps que dão suporte a um fluxo de trabalho de vendas.
Como os plugins usam apps
Muitos plugins dependem de apps para acessar sistemas externos. Por exemplo, um plugin pode precisar de acesso a um app aprovado pelo workspace que se conecta a um repositório, data warehouse, CRM, armazenamento de documentos ou ferramenta de mensagens.
Administradores e proprietários controlam quem pode usar esses apps no ChatGPT ou no Codex. Dependendo do app, administradores e proprietários também podem controlar:
Quais usuários, grupos ou funções podem acessá-lo (somente Enterprise/Edu)
Se ele pode apenas ler dados ou também executar ações
Se os usuários precisam confirmar ações antes que elas sejam executadas
Se sincronização, restrições de domínio, limites de fonte ou outras configurações específicas do app se aplicam.
Aprovar um app no ChatGPT não substitui as permissões no sistema de origem. Se um usuário não consegue acessar um arquivo, repositório, registro, workspace ou canal no sistema conectado, o plugin não deve dar acesso a isso por meio do Codex.
Plugins que incluem modelos de app
Alguns plugins podem incluir um modelo de app ou depender de um app criado a partir de um modelo. Modelos de app não são o mesmo que um app pronto para uso. Um administrador ou proprietário do workspace pode precisar inserir uma configuração específica da organização, criar um app em rascunho, publicá-lo e atribuir acesso antes que os membros possam usar o plugin.
Se um plugin depende de um modelo de app que ainda não foi configurado, os membros podem precisar que um administrador conclua a configuração primeiro. O plugin não pode usar o modelo de app sozinho.
Para saber mais sobre a configuração de modelos, consulte modelos de app do ChatGPT.
Configurando um plugin
Plugins podem precisar ser adicionados no Codex antes de estarem prontos para uso. Antes de pedir que os membros usem um plugin, verifique os requisitos do plugin, adicione ou instale o plugin se o Codex mostrar um botão Adicionar plugin ou Instalar, e configure quaisquer apps subjacentes necessários. As etapas gerais estão incluídas abaixo — continue lendo para ver mais detalhes.
Abra Administração > Plugins e encontre o plugin que você quer configurar.
Se o plugin ainda não tiver sido adicionado, selecione Adicionar plugin ou Instalar.
Abra Configurações do workspace > Apps.
Encontre o app ou modelo de app exigido pelo plugin.
Revise a qual sistema ele se conecta, quais dados pode acessar e quais ações pode executar.
Atribua acesso aos usuários, grupos ou funções que devem usar o plugin (somente Enterprise/Edu).
Revise os controles de ações e as configurações de confirmação de ação.
Se o app exigir autenticação do provedor, peça a um usuário de teste para conectar a conta.
Execute um prompt de baixo risco para confirmar que o plugin funciona conforme esperado.
Encontre e revise o app ou modelo de app relevante
Se você sabe qual plugin quer configurar, abra Administração > Plugins, encontre o plugin e selecione Gerenciar app no plugin ou Gerenciar apps no plugin para abrir a lista de apps no escopo desse plugin. A partir daí, revise cada app ou modelo de app incluído.
Você também pode ir diretamente para Configurações do workspace > Apps quando já souber o nome do app ou modelo. Comece em Diretório se estiver habilitando um novo app ou verifique Habilitados se o app já tiver sido aprovado. Para planos Business, a maioria dos apps é habilitada por padrão. Use Rascunhos quando estiver revisando um app personalizado que está aguardando publicação.
Clique no menu de reticências (...) ao lado do app que você tem interesse em configurar para revisar o app. Clique em Ver detalhes e confirme:
A qual sistema o app se conecta
Quais informações ele pode pesquisar ou buscar
Se ele pode sincronizar dados com o ChatGPT
Em seguida, revise todas as ações que o app pode executar, especialmente qualquer coisa que possa criar, atualizar ou enviar informações.
Se o app se conecta a sistemas sensíveis ou dados regulamentados, faça uma pausa para a revisão adequada de fornecedor, jurídica, de segurança ou de residência de dados. Para apps MCP personalizados, inclua o servidor MCP, o modelo de autenticação, as ferramentas expostas e o comportamento de ações de gravação nessa revisão antes de publicar.
Atribua acesso ao app e defina limites de ações e dados
Administradores e proprietários Enterprise/Edu podem decidir quais membros do seu workspace podem usar o app, atribuindo apps a usuários, grupos ou funções.
Você pode usar RBAC ou controles de acesso a apps para atribuir o app apenas a esse grupo e expandir depois que o fluxo de trabalho for validado.
Observe que a atribuição de apps nas configurações do seu workspace controla quem pode acessar o app no ChatGPT. Ela não substitui as permissões existentes do usuário no sistema de origem conectado. Os usuários ainda precisam ter as permissões adequadas de OAuth e outras permissões para usar o sistema conectado que alimenta o app.
Administradores e proprietários também podem revisar o que o app tem permissão para fazer:
Mantenha a primeira versão como somente leitura quando possível.
Permita ações de gravação ou modificação somente quando a equipe precisar delas.
Exija revisão do administrador para ações recém-adicionadas quando apropriado.
Use restrições de domínio para manter os usuários em contas de trabalho aprovadas.
Limite a sincronização a pastas, drives, repositórios, espaços ou canais aprovados quando disponível.
Publique e valide
Quando as configurações do app estiverem corretas, selecione Publicar.
Se o plugin foi importado de um marketplace, use Atualizar no plugin do workspace quando quiser obter a versão mais recente da fonte original.
Após o lançamento, revise periodicamente o acesso, os controles de ações, as configurações de sincronização, as perguntas de suporte, as análises e as necessidades de conformidade.
Considerações de segurança e permissões
Ao revisar um plugin, use o mesmo processo de revisão usado para apps no ChatGPT.
Confirme de qual sistema externo o plugin depende. Confirme se o plugin pode usar ações somente leitura, ações de gravação ou ambas. Confirme se a confirmação de ação é obrigatória para ações sensíveis. Mantenha a primeira implantação limitada a um grupo piloto quando possível. Revise se é necessária aprovação jurídica, de segurança, privacidade, residência de dados ou fornecedor antes de ampliar o acesso. Revise periodicamente o acesso após a implantação.
Os apps podem ter seus próprios termos, políticas de privacidade e compromissos de residência de dados. Revise esses termos antes de habilitar o acesso para fluxos de trabalho sensíveis ou regulamentados.
Perguntas frequentes
Por que não consigo encontrar o plugin?
A disponibilidade do plugin pode depender do seu plano, das configurações do workspace, do status de implantação e do acesso ao recurso. Se você esperava ver um plugin e não o vê, peça ao administrador ou proprietário do workspace para confirmar se o plugin está habilitado para seu workspace.
Por que o plugin diz que um app precisa de configuração?
Peça a um administrador ou proprietário do workspace para revisar o app necessário. O administrador pode precisar habilitá-lo, criá-lo a partir de um modelo, publicar um rascunho ou atribuir acesso antes que os membros possam usar o plugin.
Por que o plugin não consegue acessar os dados esperados?
Verifique tanto o acesso ao workspace do ChatGPT quanto o sistema de origem. O usuário deve ter acesso ao app no ChatGPT e também permissão para o conteúdo subjacente no sistema conectado.
Por que o plugin não consegue executar uma ação?
Um administrador pode ter limitado o app ao acesso somente leitura, ou a ação pode exigir confirmação. Peça ao administrador para revisar os controles de ações, as configurações de confirmação de ação e quaisquer permissões do sistema de origem necessárias para a ação.
Por que o plugin relacionado ainda aparece no Codex depois que desabilitei um app no ChatGPT?
Plugins podem incluir recursos baseados em apps e habilidades. Desativar um app ou uma ação impede que o plugin use esse recurso baseado em app, mas o plugin ainda pode aparecer no Codex quando outras partes do plugin, como habilidades ou orientações de fluxo de trabalho, ainda estiverem disponíveis. Se um plugin visível não funcionar após um app ser desabilitado ou informar que a configuração é necessária, peça a um administrador ou proprietário do workspace para revisar o app, a habilidade e as configurações de disponibilidade do plugin subjacentes.
Por que não tenho acesso às habilidades?
Alguns comportamentos do plugin podem depender da disponibilidade do workspace ou do recurso. Se um plugin estiver visível, mas não funcionar como esperado, peça ao administrador ou proprietário do workspace para confirmar se o plugin, a habilidade e os recursos de app necessários estão disponíveis para seu workspace.