Com uma conexão do espaço de trabalho, uma tarefa de equipe ou interface do @ChatGPT compatível pode usar uma conta de aplicativo gerenciada pela empresa sem que cada participante precise conectar sua conta pessoal.
Para saber mais, veja como funcionam as permissões dos plugins e o compartilhamento de dados.
Os administradores do espaço de trabalho autorizam contas de aplicativos compatíveis, gerenciam as conexões salvas e controlam quem pode encontrá-las e usá-las. O provedor controla quais dados cada conta pode acessar e quais ações pode executar.
Para autorizar contas, consulte Como conectar e gerenciar contas de aplicativos. Para tarefas recorrentes, consulte Como criar e gerenciar tarefas de equipe no ChatGPT.
Como funciona
Use conexões com o @ChatGPT ou em tarefas de equipe que precisem de contas gerenciadas pela empresa. Os administradores aprovam o acesso. Os responsáveis pelas equipes selecionam as conexões disponíveis quando têm permissão. A mesma conexão pode ser usada por várias equipes e em vários fluxos de trabalho compatíveis.
Uma conexão permite que um aplicativo se autentique em uma conta.
Configurar uma conexão
Antes de começar
Confirme se o aplicativo e o método de autenticação estão disponíveis no espaço de trabalho. Em seguida, distribua as responsabilidades:
Administrador do espaço de trabalho: Com permissão para gerenciar plugins (como proprietário ou administrador do espaço de trabalho), crie e autorize a conexão e defina quem pode encontrá-la, usá-la e gerenciá-la.
Administrador do provedor: Crie as contas e aprove o acesso ao serviço de origem. No caso do Notion e do Linear, envolva o administrador do provedor. A conta desse administrador pode ser diferente da usada para autenticar a conexão.
Os requisitos variam conforme o provedor. O Gmail pode exigir uma conta de usuário separada. O acesso ao Drive deve ser configurado no Google. No lançamento, o GitHub usa login com conta de usuário.
Conta da conexão: Use uma conta ou identidade de serviço aprovada com acesso apenas aos recursos necessários. Siga o método de autenticação compatível e evite depender da conta pessoal de um funcionário. Consulte Como conectar e gerenciar contas de aplicativos no ChatGPT.
Responsável pela conexão: Mantenha a autorização válida, coordene as alterações de permissões e restabeleça o acesso em caso de falha. Antes de compartilhar a conexão, confira quais recursos ela abrange, quais são as permissões de leitura e gravação e como revogar o acesso.
Responsável pela equipe ou pelo fluxo de trabalho: Defina com o administrador quais recursos e ações são necessários. Em seguida, selecione e teste a conexão na tarefa ou na interface do @ChatGPT.
Criar uma conexão do espaço de trabalho
-
No Console de administração, selecione o espaço de trabalho e abra Conexões do espaço de trabalho > +. Escolha o aplicativo.
-
Siga as instruções do aplicativo para o método de autenticação oferecido. Se solicitado, habilite o acesso ao aplicativo em tempo real.
-
Autentique a conta designada ou conclua a instalação do aplicativo. Confira a conta ou a instalação e as permissões solicitadas.
-
Dê à conexão salva um apelido que descreva o tipo de acesso, como “Relatórios do projeto: acesso de leitura”.
-
Conceda acesso aos usuários, equipes ou contas de serviço aprovados. Confira separadamente as permissões de uso e de gerenciamento. Em seguida, peça ao responsável pela equipe ou pelo fluxo de trabalho que selecione e teste a conexão.
Configurar cada aplicativo
Use o método oferecido para o aplicativo, configure o acesso e teste a conexão no fluxo de trabalho em que ela será usada.
Google Drive
Autorizar uma conta
Use uma Conta do Google aprovada que tenha acesso aos arquivos ou drives compartilhados necessários.
-
Escolha a opção de login com o Google, selecione a conta que deseja conectar e confira o acesso solicitado antes de aprová-lo.
-
Confirme a Conta do Google e dê um nome à conexão no ChatGPT. Se o fluxo de trabalho criar arquivos, teste o destino e verifique se os destinatários conseguem acessá-los.
Usar uma conta de serviço
Se houver a opção de autenticação direta com conta de serviço, prepare uma conta de serviço aprovada do Google Cloud e a respectiva chave JSON. Esse método usa as permissões de acesso da conta de serviço aos recursos, sem delegação em todo o domínio.
-
Conceda acesso aos arquivos, pastas ou drives compartilhados necessários usando o endereço de e-mail da conta de serviço. Confira separadamente as permissões de leitura e de gravação.
-
Insira a chave JSON completa no campo protegido de credenciais. Não inclua a chave em capturas de tela nem em mensagens de suporte.
-
Salve a conexão e tente ler um arquivo compartilhado com a conta de serviço.
Use um drive compartilhado para criar arquivos. A conta de serviço precisa de permissão de gravação nesse drive. Ela não pode ser proprietária de arquivos no Meu Drive de uma conta pessoal.
Se algum arquivo não aparecer, verifique se ele foi compartilhado com o e-mail da conta de serviço e confira as ações permitidas para o aplicativo no ChatGPT. Compartilhar uma pasta não concede acesso a todo o domínio do Google Workspace.
Se o Drive oferecer delegação em todo o domínio, siga o procedimento de acesso delegado abaixo.
Gmail
Autorizar uma caixa de e-mail
Se houver a opção de usar OAuth, autorize a caixa de e-mail designada do Gmail. Solicite uma conta de usuário separada à equipe de TI se o fluxo de trabalho precisar de uma caixa de e-mail própria.
-
Escolha a opção de login com o Google, selecione a caixa de e-mail e confira o acesso solicitado antes de aprová-lo.
-
Confira a conexão salva e leia uma mensagem de teste aprovada. Se precisar enviar mensagens, faça um teste com um destinatário aprovado e confira o remetente e a mensagem entregue.
Os grupos do Google não são caixas de e-mail. Uma caixa de e-mail conectada e inscrita em um grupo pode receber as mensagens dele, mas também pode expor outros e-mails. Antes de compartilhar a conexão, confira o conteúdo da caixa e as ações permitidas.
Configurar a delegação em todo o domínio
A delegação exige que o funcionário que faz a solicitação tenha a identidade verificada e usa as permissões delegadas desse funcionário no Google. Antes de executar tarefas sem supervisão, confirme se a interface usada consegue verificar a identidade do solicitante. O acesso direto ao Drive com uma conta de serviço funciona de outra forma.
Use a delegação somente onde essa opção estiver disponível. Ela exige a aprovação de um superadministrador do Google Workspace e uma conta de serviço aprovada do Google Cloud, com o ID numérico do cliente OAuth e a chave JSON completa.
-
Selecione os aplicativos e as ações, identifique exatamente quais escopos eles exigem e peça ao administrador do Google Workspace que aprove esses escopos.
-
No Google Admin, abra Segurança > Controle de acesso e dados > Controles de API > Gerenciar a delegação em todo o domínio. Autorize o ID numérico do cliente e os escopos aprovados. Confira a autorização salva.
-
Insira a chave JSON no ChatGPT sem expô-la a outras pessoas. Teste a conexão na interface em que ela será usada, com um solicitante cuja identidade tenha sido verificada e um recurso ao qual ele tenha acesso.
Se uma solicitação for negada, confira a identidade do solicitante, os escopos aprovados e o acesso ao recurso. Não amplie os escopos apenas para eliminar um erro.
GitHub
Autorizar uma conta de usuário
Use uma conta de usuário do GitHub aprovada pela organização, de preferência dedicada a essa configuração, com acesso aos repositórios necessários.
O login com um aplicativo do GitHub não está disponível neste lançamento.
-
Escolha a opção de login com uma conta de usuário do GitHub e autentique a conta designada.
-
Confira a conta e o acesso solicitado antes de aprovar a conexão.
-
Salve a conexão e teste o acesso a um recurso conhecido do repositório no fluxo de trabalho em que ela será usada. Teste separadamente as ações de gravação necessárias.
Se um repositório não aparecer, confira as permissões da conta designada no GitHub e as ações permitidas para o aplicativo no ChatGPT.
O Codex Security na nuvem usa uma conexão pessoal com o GitHub. Consulte Configuração na nuvem.
Notion
Preparar uma conta dedicada do Notion
Peça ao administrador do Notion que crie uma conta dedicada aprovada e conceda acesso apenas aos recursos necessários. Confirme se a conta faz parte do espaço de trabalho. A conexão usa as permissões dessa conta.
Configurar a conexão do espaço de trabalho
Em Console de administração > Conexões do espaço de trabalho, adicione o plugin do Notion. Use o MCP do Notion para entrar com a conta designada, selecione o espaço de trabalho e dê à conexão um nome que identifique o espaço de trabalho e a conta.
Salve a conexão e teste o acesso a uma página conhecida do Notion na tarefa ou interface em que ela será usada. Teste separadamente as operações de gravação necessárias e confira o resultado.
Linear
Preparar uma conta dedicada do Linear
Peça a um administrador do Linear que convide a conta designada com a função de convidado e limite o acesso às equipes necessárias:
-
Abra Configurações → Administração → Membros → Convidar.
-
Insira o endereço de e-mail da conta designada.
-
Em Convidar como…, escolha Convidado.
-
Selecione apenas as equipes do Linear às quais a conta deve ter acesso.
-
Envie o convite e aceite-o usando a conta designada.
Consulte as instruções do Linear para convidar membros.
Se a conta designada já tiver a função de membro, peça a um administrador do Linear que altere a função:
-
Abra Configurações → Administração → Membros.
-
Encontre a conta e clique em ⋯ → Alterar função… → Convidado.
-
Limite a participação da conta às equipes previstas. Nessas equipes, os convidados podem realizar as mesmas ações que os membros comuns. Consulte as funções do Linear.
Configurar a conexão do espaço de trabalho
-
Em Console de administração → Conexões do espaço de trabalho, adicione o plugin do Linear.
-
Entre com a conta designada, selecione o espaço de trabalho e confira as permissões.
A conexão usa as permissões dessa conta no Linear. Na tarefa ou interface em que a conexão será usada, confirme se ela consegue ler uma issue de uma das equipes previstas. Teste separadamente as ações de gravação necessárias.
Slack
Configurar a conexão do espaço de trabalho
Confirme o espaço de trabalho e os canais necessários no Slack, a instalação do aplicativo e a aprovação do administrador. Use a conexão compartilhada do ChatGPT no Slack dessa interface. As conexões pessoais do Slack e a conexão dos dots pela opção “Adicionar ao Slack” são independentes.
Faça uma publicação de teste em um canal aprovado e confira o espaço de trabalho e o remetente. Teste a leitura e a pesquisa separadamente. Uma publicação bem-sucedida não confirma nenhuma dessas duas permissões.
Responsáveis por equipes e fluxos de trabalho
Selecionar e testar
Configurar o acesso e selecionar a conexão
Administrador do espaço de trabalho: Configure o acesso por função e a disponibilidade da conexão. Confira separadamente as permissões de uso e de gerenciamento. Informe ao responsável pelo fluxo de trabalho o apelido da conexão, a conta, os recursos e as ações aprovados e os dados de contato do responsável pela conexão.
Responsável pela equipe ou pelo fluxo de trabalho: Onde tiver permissão, selecione a conexão disponível, salve a seleção e teste a conexão no fluxo de trabalho em que ela será usada. Se a conexão não aparecer, peça ao administrador do espaço de trabalho que confira o acesso e a disponibilidade.
O que cada configuração controla
Ao habilitar o @ChatGPT no Slack ou no Microsoft Teams para uma conexão, você também habilita as opções de acesso a essa conexão para equipes e contas de serviço. Enquanto o @ChatGPT estiver habilitado para essa conexão, não será possível desabilitar essas opções de forma independente.
| Configuração ou permissão | O que verificar |
|---|---|
| Conta externa | A conta ou a instalação designada consegue acessar os recursos e executar as ações necessárias? |
| Acesso por função | A pessoa ou a conta de serviço aprovada pode usar a conexão? Confira separadamente as permissões de gerenciamento. |
| Disponibilidade | Os usuários, equipes ou contas de serviço previstos conseguem encontrar a conexão? Confira para qual público ela está disponível. |
| Seleção para a equipe ou o fluxo de trabalho | A conexão foi selecionada e salva para a equipe ou o fluxo de trabalho que vai usá-la? |
Conexões para equipes e fluxos de trabalho
Revisar as conexões de uma equipe
Para cada plugin, confira com o responsável pela conexão o apelido, a conta usada e os recursos aos quais ela tem acesso.
Escolher uma conexão para um fluxo de trabalho
Para o @ChatGPT, abra as configurações de plugins da interface e selecione a conexão. Salve e reabra as configurações para conferir a seleção.
Para uma tarefa de equipe, confirme a conexão selecionada para cada aplicativo. A conta de serviço da equipe executa a tarefa. O método de autenticação de cada aplicativo determina qual conta externa ele usa. Confirme se esse método é compatível com o tipo de execução da tarefa, especialmente se o método exigir a verificação da identidade de um funcionário.
Testar a conexão no seu fluxo de trabalho
-
Use o fluxo de trabalho previsto para ler uma fonte conhecida. Confira a identidade usada e o recurso acessado.
-
Teste operações de gravação ou envio em um destino aprovado e abra o arquivo, registro ou mensagem resultante.
-
Verifique se um usuário aprovado consegue usar a conexão e se o acesso é negado a um usuário não autorizado. Confira se os destinatários têm acesso aos arquivos gerados.
Usuários da conexão
Usar conexões do espaço de trabalho
Entender as permissões da conta conectada
As ações usam as permissões da conta conectada, que podem ser mais amplas que as suas permissões pessoais. O OAuth usa a conta autorizada. O acesso direto com conta de serviço usa a identidade dessa conta. Alguns métodos exigem a verificação da identidade do solicitante. Consulte Delegação no Google Workspace.
Usar uma conexão disponível no espaço de trabalho
- Se houver essa opção, escolha a conexão designada. Para interfaces gerenciadas do @ChatGPT ou tarefas de equipe, confirme a seleção com o responsável.
Você não precisa inserir novamente as credenciais da conta designada a cada uso. Se o sistema solicitar que você faça login, confira a conexão e a conta que está autorizando.
Uma conexão do espaço de trabalho pode ler fontes que você não consegue abrir. Os links para as fontes não concedem acesso. Os arquivos gerados podem ser acessíveis apenas à conta conectada. Por isso, confira o acesso dos destinatários antes de compartilhá-los.
Responsáveis pelas conexões e usuários
Gerenciar conexões e resolver problemas
Gerenciar alterações e remover o acesso
Confira o apelido da conexão, sua disponibilidade e as funções configuradas.
Se a autorização ou as permissões no provedor mudarem, peça ao responsável pela conexão que restabeleça o acesso e ao responsável pelo fluxo de trabalho que faça um novo teste. Alterar o nome da conexão não muda as permissões externas.
Antes de desabilitar uma conexão, identifique os fluxos de trabalho afetados com a ajuda dos respectivos responsáveis. Após a remoção, verifique se esses usuários e fluxos de trabalho já não conseguem usar a conexão.
Revogue a autorização no provedor separadamente. Desabilitar a conexão no ChatGPT não substitui essa etapa.
Resolver problemas de acesso
Se uma conexão não aparecer, confira o espaço de trabalho e consulte a tabela de solução de problemas de acesso para saber quem pode verificar o acesso por função e o público da conexão.
| O que acontece | Quem pode ajudar |
|---|---|
| A conexão não aparece | O administrador do espaço de trabalho pode conferir sua função e para qual público a conexão está disponível. |
| A conexão está disponível, mas a tarefa não a usa | O responsável pela interface ou pela equipe pode verificar qual conexão do espaço de trabalho está configurada para o aplicativo usado no fluxo de trabalho. |
| O acesso a uma fonte ou a execução de uma ação falha | O responsável pela conexão pode verificar qual identidade ela usa e se essa identidade tem permissão para acessar o recurso ou executar a ação. |
| Você consegue ler um resumo, mas não consegue abrir a fonte | O responsável pela fonte pode verificar se você tem acesso à página ou ao arquivo original. |
| Um destinatário não consegue abrir um arquivo gerado | O proprietário do arquivo pode conferir as configurações de compartilhamento. |
Antes de repetir uma operação de gravação ou envio que falhou, confira o destino. A ação pode ter sido concluída apesar do erro, e uma nova tentativa pode gerar duplicatas.