Voltar para a documentaçãoConceitos principais

Permissões

Entenda contas conectadas, autorização, permissões nomeadas, duração da aprovação e as diferenças entre My Okou e Legacy Agents.

Última atualização em 13 de novembro de 2026 · 5 min read

Conectar uma conta e permitir que o Okou a use são decisões separadas. Compartilhar um fluxo de trabalho ou um resultado não compartilha suas contas, instruções pessoais, chats privados ou concessões de permissão.

Conexão, autorização e permissão

CamadaO que ela controla
ConexãoQual conta de serviço salva ou credencial você conectou.
AutorizaçãoSe essa conexão fica disponível para o Okou no contexto aplicável. Os Legacy Agents podem exigir uma autorização de agente.
Concessão de permissãoQuais operações nomeadas do conector são permitidas e por quanto tempo. Revise o escopo mostrado na solicitação.

Cada membro conecta e autoriza suas próprias contas. Um fluxo de trabalho da equipe não pode usar a caixa de entrada pessoal ou o token do autor. Integrações instaladas no espaço de trabalho podem exigir vinculação separada por membro.

My Okou

Use Conectores ou siga a solicitação de conexão no seu chat. Escolha a conta pretendida, conclua o fluxo de conexão do próprio serviço e revise quaisquer permissões nomeadas solicitadas. Você não precisa criar um agente especialista para conectar um serviço.

Algumas contas têm controles adicionais de contas de conector de chat. Quando esses controles estiverem disponíveis, revise quais contas estão habilitadas para este chat e qual está selecionada. Uma conexão salva não é automaticamente permissão para usá-la em todo chat, e a seleção de uma conta não é concessão de toda operação do conector. O My Okou, por si só, não habilita esses controles; se eles não estiverem presentes, use o fluxo de conexão e autorização mostrado para você.

O escopo da permissão é definido pela solicitação do produto e pela política do conector. Não presuma que uma concessão esteja isolada a um único Chat ou a uma única conta salva apenas porque você a aprovou ali. Revise a permissão nomeada e a duração exibida antes de aprovar.

Agentes legados

Se a sua interface ainda tiver agentes, selecione o agente pretendido e abra suas configurações de Autorização. Uma conexão pode autorizar agentes específicos. O agente selecionado usa as contas conectadas e as concessões do membro que o executa, não a conta da pessoa que o publicou. Remover a autorização de um agente deixa os outros agentes autorizados inalterados.

Conceder e revogar acesso

Quando o Okou precisar de permissão que não possui, revise o conector, a operação, o motivo e qualquer conta ou escopo mostrados. Escolha Permitir ou Negar, e a duração oferecida por essa solicitação. O acesso por tempo limitado precisa ser renovado após expirar. Negar uma permissão não desconecta a conta nem remove concessões não relacionadas.

Revise o acesso atual em Conectores e nos controles de permissão fornecidos pelo produto. Em Legacy Agents, revise também as configurações de Autorização do agente selecionado. Remover acesso ao chat, revogar uma operação e desconectar uma conta salva são ações diferentes. Verifique o impacto exibido antes de escolher uma delas.

Tratamento de credenciais

Tokens OAuth e segredos inseridos manualmente são armazenados na plataforma. Para solicitações de conector, o firewall injeta a credencial na borda da rede; o segredo não é exposto ao código do agente como uma variável de ambiente.

Não cole senhas, chaves de API, tokens OAuth ou segredos de cliente em um chat, instruções pessoais (Instructions), fluxo de trabalho ou arquivo anexado. Use o fluxo de conexão do conector. Desconectar uma conta salva remove essa conexão de execuções futuras; isso é mais abrangente do que desativar seu uso em um único chat.

Limites de aprovação

O limite aplicável é a concessão de permissão nomeada do conector. Uma instrução pessoal ou uma instrução de fluxo de trabalho não amplia o acesso, e uma categoria genérica como “ação sensível” não garante que toda gravação externa fará pausa da mesma maneira.

Para trabalhos que precisam permanecer revisados por humanos:

  1. Conceda acesso de leitura ou de rascunho e negue acesso final de gravação ou envio quando o conector os expuser separadamente.
  2. Declare a exigência de revisão em instruções pessoais ou no fluxo de trabalho.
  3. Mantenha a ação final com o humano, por exemplo preparando um rascunho de e-mail ou uma alteração proposta.

Use também controles do serviço upstream: chaves de API com escopo, escopos OAuth de privilégio mínimo, permissões de repositório e credenciais de produção separadas. A aprovação de compra permanece separada da conexão de uma conta.

Chats, registros e visibilidade de administradores

Os membros acessam seus próprios tópicos de chat. Publicar um fluxo de trabalho, ou um agente na experiência legada, não publica os chats privados ou as credenciais de um membro. Compartilhe conversas e artefatos apenas por meio dos controles explícitos de compartilhamento.

Administradores do espaço de trabalho podem ver agregados de uso no nível do membro para faturamento e gerenciamento de capacidade. Isso não expõe automaticamente o conteúdo de chats privados. Dentro do seu próprio chat, inspecione o registro de atividade para ver qual ação do conector foi executada e se teve êxito.

Lista de verificação de revisão

  • A conta de serviço pretendida está conectada e disponível para esta tarefa?
  • Em Legacy Agents, o agente pretendido está autorizado?
  • Onde os controles de conta do chat estão presentes, a conta pretendida está permitida e selecionada?
  • Apenas as operações nomeadas necessárias estão permitidas, pela duração apropriada?
  • A tarefa mantém as ações externas finais em uma etapa revisável?

Veja Conectores, Fluxos de trabalho e Para equipes.