Use este guia para entender como o plugin Admin ajuda nas tarefas administrativas do dia a dia, preparar uma solicitação e experimentar prompts para os principais casos de uso com as aprovações e o contexto necessários.
1. Entenda para que serve o plugin Admin
O plugin Admin ajuda a gerenciar configurações, permissões e controles diretamente no ChatGPT Work. Você descreve o objetivo com suas próprias palavras. O plugin reúne as informações necessárias, consulta o estado atual, explica o que encontrou e orienta você sobre a próxima etapa que ele pode executar.
O que você pode fazer com o plugin Admin
- Transformar uma solicitação administrativa em um fluxo de trabalho claro sem precisar escrever uma requisição de API.
- Consultar o estado atual do espaço de trabalho antes de tomar uma decisão ou aprovar uma alteração.
- Ver quais fontes autorizadas e quais campos fundamentam a resposta e o que o plugin não conseguiu verificar.
- Revisar uma alteração que o plugin pode executar antes que ele prossiga e, depois, confirmar o resultado com uma nova consulta ao registro.
O plugin usa APIs de administração selecionadas e fontes de dados conectadas e aprovadas. Ele não reúne todos os sistemas administrativos, não amplia suas permissões nem disponibiliza todas as ações das APIs no ChatGPT. O sistema responsável pelos dados continua controlando o que o plugin pode ler ou alterar.
Para que servem as APIs de administração
Uma API de administração oferece aos sistemas uma forma estruturada de solicitar dados ou a execução de uma ação compatível. As organizações podem usar essas APIs para criar processos internos ou ferramentas externas. Exemplos comuns incluem relatórios agendados, tarefas repetidas em vários registros e conexões com sistemas aprovados. Esses fluxos de trabalho geralmente exigem revisão pelas equipes de engenharia, segurança e governança.
Você não precisa criar um fluxo de trabalho com APIs para usar este guia. As próximas seções se concentram no plugin Admin. A administração do espaço de trabalho do ChatGPT e a da Plataforma de API da OpenAI são independentes. Cada uma tem permissões e requisitos de autenticação próprios.
Proteja suas credenciais
Use apenas as conexões e os sistemas de armazenamento de segredos aprovados pela sua organização. Nunca cole uma chave real de API de administração no ChatGPT, no Codex, em um documento ou em um arquivo de código-fonte.
2. Prepare-se para usar o plugin Admin
Use o plugin Admin quando quiser descrever com suas próprias palavras uma tarefa pontual que ele possa executar. Descreva o objetivo e forneça os IDs estáveis ou o contexto aprovado para o relatório. Antes de você decidir se quer continuar, o plugin mostra o que encontrou ou o que pretende alterar.
O plugin usa somente as fontes, as credenciais e as ações autorizadas para aquela tarefa. Ele não reúne todos os sistemas administrativos nem concede permissões adicionais. O sistema de origem continua sendo a referência oficial para os dados.
Antes de começar
- Identifique a área de administração que contém os registros.
- Reúna as informações necessárias e obtenha a aprovação exigida.
- Comece com uma solicitação somente leitura.
- Pergunte ao plugin quais fontes e campos ele usou e o que não conseguiu verificar.
- Se o plugin puder fazer a alteração, revise o plano antes de aprová-lo. Depois, peça ao plugin que consulte o registro novamente e confirme o resultado.
Confirme se o plugin está disponível no seu espaço de trabalho e se você tem as permissões necessárias. Os casos de uso de funções e acesso descritos a seguir refletem os recursos documentados atualmente. O plugin pode consultar funções, permissões de uso de recursos e atribuições de funções a usuários ou grupos. Com a sua confirmação, ele também pode atribuir uma função existente a um grupo existente.
O plugin não pode criar funções, alterar as permissões de uma função nem confirmar o acesso a um conector específico.
Os casos de uso de análise exigem acesso a fontes de dados conectadas e aprovadas. A análise do retorno sobre o investimento (ROI) também exige dados aprovados sobre resultados de negócios ou de engenharia. Os registros de uso, por si só, são insuficientes.
3. Explore os principais casos de uso do plugin Admin
Escolha um caso de uso, substitua cada marcador pelo valor correspondente da solicitação aprovada e siga as etapas na ordem indicada. Comece com uma solicitação somente leitura, a menos que a tarefa seja uma alteração que o plugin possa executar e que já tenha sido aprovada.
Consulte Migrar GPTs personalizados em massa para fazer um inventário dos GPTs, migrar os lotes elegíveis e coordenar os testes com os responsáveis pelos GPTs e as verificações de acesso.
Listar as funções do espaço de trabalho
Prompt sugerido
Liste as funções do espaço de trabalho {workspace_id}. Separe as funções predefinidas das personalizadas. Para cada função, explique a quais recursos ela dá acesso e mostre a quais usuários ou grupos ela foi atribuída. Não faça alterações.Etapas
- Preparação: Confirme o ID do espaço de trabalho e verifique se você tem permissão para consultar essas informações.
- Execução: Peça a lista de funções em uma consulta somente leitura.
- Revisão: Confira os tipos de função, os recursos aos quais elas dão acesso e a quem foram atribuídas.
- Verificação: Investigue qualquer resultado inesperado sem fazer alterações.
Revisar uma função
Prompt sugerido
Revise a função {role_id}. Explique as permissões dela em linguagem simples, mostre a quem ela foi atribuída e destaque qualquer acesso que pareça mais amplo do que o esperado. Não edite a função.Etapas
- Preparação: Confirme o ID da função e o espaço de trabalho.
- Execução: Solicite uma revisão somente leitura da função.
- Revisão: Confira se as permissões e as atribuições são coerentes com a finalidade da função.
- Verificação: Anote as dúvidas para quem é responsável pela função. Lembre-se de que o plugin não pode criar a função nem editar suas permissões.
Entender o acesso de um usuário ou grupo
Prompt sugerido
Ajude-me a entender o acesso do usuário {user_id} ou do grupo {group_id}. Mostre quais funções foram atribuídas ao usuário ou ao grupo, explique que acesso elas concedem e aponte eventuais sobreposições ou lacunas. Deixe claro o que você não consegue verificar.Etapas
- Preparação: Use o ID estável do usuário ou grupo.
- Execução: Peça ao plugin que explique o acesso.
- Revisão: Confira quais funções foram atribuídas e que acesso elas concedem. Anote eventuais sobreposições ou lacunas.
- Verificação: Se o plugin não conseguir consultar alguma informação, registre-a como desconhecida. Evite suposições.
Atribuir uma função existente a um grupo
Prompt sugerido
Antes de fazer qualquer alteração, mostre as funções atuais do grupo {group_id} e explique que acesso a função {role_id} acrescentaria. Confirme quem consta no registro como responsável pela aprovação e aguarde minha aprovação explícita. Após a atribuição, verifique a lista atualizada de funções do grupo.Etapas
- Preparação: Confirme os IDs do grupo e da função. Confira a solicitação aprovada e quem consta no registro como responsável pela aprovação.
- Execução: Peça ao plugin que mostre as funções atuais e explique o que mudaria.
- Revisão: Aprove o plano somente se ele corresponder à solicitação aprovada.
- Verificação: Após a atribuição, consulte o grupo novamente para confirmar que a função existente foi adicionada conforme a solicitação aprovada.
Verificar a permissão geral de acesso a conectores
Prompt sugerido
Verifique se as funções atribuídas ao usuário {user_id} concedem acesso geral a conectores. Peça ao plugin que mostre quais permissões fundamentam a resposta. Se o plugin não conseguir verificar o acesso a um conector específico, peça que ele deixe isso claro.Etapas
- Preparação: Confirme o ID do usuário e verifique se você tem permissão para consultar o acesso dele.
- Execução: Solicite a verificação da permissão geral.
- Revisão: Confira a função atribuída e a permissão que fundamentou a resposta.
- Verificação: Use o resultado apenas como verificação geral. Ele não comprova o acesso a um conector específico nem a um item conectado.
Diagnosticar problemas em uma alteração aprovada
Prompt sugerido
Revise a alteração aprovada {change_record_id}. Compare o resultado solicitado com o estado atual do espaço de trabalho. Se a alteração falhou, verifique primeiro o espaço de trabalho e a função. Em seguida, confirme quem é responsável pelo registro, explique o problema e sugira a próxima etapa mais segura.Etapas
- Preparação: Confirme o registro da alteração aprovada e o resultado esperado.
- Execução: Peça ao plugin que compare a solicitação com o estado atual do espaço de trabalho.
- Revisão: Confira o espaço de trabalho e a função. Em seguida, verifique quem é responsável pelo registro.
- Verificação: Use o estado atual do espaço de trabalho como referência oficial antes de decidir o que fazer em seguida.
Otimizar os custos e a combinação de modelos
Prompt sugerido
Para o período {date_range} no espaço de trabalho {workspace_id}, agrupe os dados verificados de consumo de tokens e de custo por caso de uso. Compare os modelos e os modos de raciocínio com base nas informações disponíveis sobre velocidade e qualidade. Destaque os fluxos de trabalho de alto custo quando os dados mostrarem poucos indícios de que geram valor. Indique onde seria possível reduzir gastos ou redirecionar recursos para atividades com melhores resultados de produtividade ou custo. Inclua os indicadores de receita ou qualidade aprovados que estiverem disponíveis. Estime a economia possível, explique as vantagens e desvantagens de cada opção e diferencie o que foi verificado das suposições e das informações que faltam. Faça a análise em modo somente leitura.Etapas
- Preparação: Confirme o espaço de trabalho e o intervalo de datas. Verifique se os dados de custo cobrem todo o período e quais campos aprovados de desempenho ou resultados estão disponíveis.
- Execução: Solicite a comparação de custos e modelos.
- Revisão: Diferencie o que os dados mostram das suposições, das informações que faltam e das vantagens e desvantagens de cada opção.
- Verificação: Antes de agir, valide a economia estimada com a equipe financeira e com os responsáveis pelos fluxos de trabalho.
Analisar o uso e a adoção
Prompt sugerido
Analise o espaço de trabalho {workspace_id} durante o período {date_range}. Mostre as tarefas e o consumo de tokens por equipe e por área de negócio. Agrupe os custos por caso de uso. Resuma o que as equipes fazem com o ChatGPT e o Codex. Inclua exemplos das áreas de Jurídico, Marketing e Vendas. Compare os dados disponíveis sobre o uso de habilidades e plugins. Só inclua chamadas de ferramentas, aplicativos conectados e fluxos de trabalho que usam várias ferramentas se os respectivos campos estiverem disponíveis. Mostre onde as equipes usam fluxos de trabalho mais avançados e onde pode haver oportunidades de ampliar o uso. Classifique os {5_or_10} principais casos de uso e mostre se um pequeno grupo de usuários muito ativos responde pela maior parte do uso. Não faça suposições sobre atividades que não constem nos dados.Etapas
- Preparação: Confira o espaço de trabalho, o intervalo de datas e o mapeamento das equipes. Confirme se há aprovação para gerar relatórios por usuário.
- Execução: Solicite a análise de uso e adoção.
- Revisão: Confira quais dos campos solicitados estão disponíveis. Omita as atividades para as quais não há dados, sem fazer suposições.
- Verificação: Um volume de uso elevado não comprova uso avançado, valor para o negócio nem desempenho individual.
Medir o valor para o negócio e o ROI
Prompt sugerido
Para o espaço de trabalho {workspace_id}, combine os dados verificados de uso e custo do período {date_range} com os resultados aprovados. Estime o valor gerado por equipe e por caso de uso. Inclua as métricas aprovadas da área de Vendas para produtividade, receita e qualidade. Compare as equipes e os modelos, além dos fluxos de trabalho e dos segmentos de usuários. Classifique os retornos em relação aos custos. Mostre as fontes e a fórmula utilizada. Indique claramente as premissas, as limitações e as informações que faltam. Não afirme que o ChatGPT causou os resultados. Faça a análise em modo somente leitura.Etapas
- Preparação: Confira o espaço de trabalho e o intervalo de datas. Em seguida, confirme os resultados aprovados. Revise a fórmula e as regras de privacidade.
- Execução: Solicite a análise de ROI.
- Revisão: Confira cada fonte e cada premissa. Anote todas as limitações e os dados que faltam.
- Verificação: Os dados de uso, por si só, não comprovam ROI nem causalidade. Revise o resultado com a equipe financeira e com os responsáveis pelas áreas de negócio.
Avaliar o ROI do Codex
Prompt sugerido
Para o espaço de trabalho {workspace_id}, combine os dados verificados de uso e custo do Codex no período {date_range} com os resultados de engenharia aprovados. Estime o ROI por equipe, repositório e fluxo de trabalho. Compare a produtividade e a velocidade de entrega com a qualidade do código e os custos de engenharia. Identifique os fluxos de trabalho que apresentam alto valor ou consomem muitos recursos. Recomende alterações no modelo, no modo de raciocínio ou no fluxo de trabalho. Explique as vantagens e desvantagens de cada opção e as incertezas envolvidas. Descreva os padrões observados nos dados disponíveis sem apresentá-los como prova de que o Codex causou o resultado. Apresente apenas as conclusões. Não faça alterações.Etapas
- Preparação: Confirme o espaço de trabalho e o período do relatório. Revise o mapeamento das equipes e dos repositórios, além dos dados de referência aprovados.
- Execução: Solicite a análise do ROI do Codex.
- Revisão: Diferencie os padrões observados das suposições. Proteja os dados dos usuários e dos repositórios.
- Verificação: Revise com a equipe de engenharia as recomendações e os valores de referência usados para avaliar os resultados.
4. Quando usar um fluxo de trabalho com APIs
Algumas organizações usam as APIs para criar processos administrativos próprios ou ferramentas externas. Essa abordagem permite executar tarefas agendadas ou contínuas. Também pode ser útil quando um processo envolve muitos registros ou precisa se conectar a um sistema interno aprovado. Esses processos são independentes do fluxo guiado pelo plugin Admin.
Comece com uma tarefa administrativa bem definida. Identifique as informações e permissões necessárias, as etapas que exigem revisão, o resultado esperado e como ele será registrado. Se a organização automatizar a tarefa, envolva as equipes responsáveis por engenharia, segurança e governança, mantenha as credenciais em um sistema aprovado de armazenamento de segredos e teste o fluxo de trabalho antes da implantação.