Skip to main content
O ClickHouse Agents usa um modelo de permissões em camadas: as funções controlam quais funcionalidades os usuários podem usar, as listas de acesso em nível de recurso controlam quem pode usar um agente específico ou outro recurso, e as permissões de Admin controlam quem gerencia tudo.

​
Funções

Uma função é um conjunto de permissões por funcionalidade atribuído a um ou mais usuários. Os padrões são:
  • User - pode executar agentes e usar o chat. A possibilidade de criar agentes, criar skills, compartilhar recursos etc. depende das opções por funcionalidade definidas na função.
  • Admin - tudo o que o User pode fazer, além de controles no nível da organização: gerenciar usuários, configurar o marketplace e conceder permissões.
Admins podem criar funções personalizadas com suas próprias opções para um controle mais granular.

​
Compartilhamento de recursos

Agentes, prompts e skills têm, cada um, uma lista de acesso. Há três níveis de acesso por principal:
  • visualizador - pode usar o recurso, mas não pode modificá-lo.
  • Editor - pode alterar a configuração do recurso (instruções, ferramentas anexadas, modelo etc.).
  • proprietário - Editor, além da capacidade de excluir o recurso ou alterar seu compartilhamento.
Quando você cria um recurso, por padrão, é o proprietário dele. Tudo o que você não compartilhar explicitamente ficará privado para você.

​
Principais

Você pode conceder acesso a:
  • Usuários individuais - um usuário por vez.
  • Grupos - equipes ou unidades organizacionais. Se um usuário entrar ou sair do grupo depois, o acesso dele será atualizado automaticamente.
  • Toda a organização - todos na organização veem o recurso. Isso depende da opção no nível da função que permite esse acesso.
A visibilidade em toda a organização é o que torna um recurso localizável no marketplace.

​
Compartilhar um agente

Clique no ícone de compartilhar na parte inferior do Agent Builder. Um indicador no ícone mostra quantos usuários ou grupos têm acesso no momento. O modal Compartilhar é aberto. Procure um usuário ou grupo por nome ou e-mail, escolha o nível de acesso (Visualizador, Editor ou Proprietário) e clique em Salvar alterações. Para compartilhar com toda a organização, habilite a opção Compartilhar com todos no ClickHouse. O destinatário verá o agente na lista de agentes disponíveis na próxima vez que atualizar. Para revogar o acesso, remova a linha no mesmo modal. O destinatário perde o acesso imediatamente; as conversas em andamento terminam, mas não será possível iniciar novas.

​
Agente padrão

Você pode marcar um agente como padrão. Novas conversas são abertas com esse agente, a menos que você escolha outro. Admins também podem definir um padrão para toda a organização para os usuários que ainda não escolheram o seu.

​
Operações de Admin

As operações exclusivas de Admin incluem:
  • Criar e editar funções.
  • Configurar categorias do marketplace e selecionar agentes em destaque.
  • Habilitar ou desabilitar recursos no nível da organização (Memory, Web search, Code interpreter, marketplace etc.).
  • Conceder permissões de Admin a outros usuários.
No ClickHouse Cloud, o painel de administração está disponível para os admins da organização. Se você não conseguir vê-lo, entre em contato com o admin da sua organização ou com o suporte do ClickHouse Cloud para solicitar acesso.

​
Pontos de atenção

  • Excluir um agente interrompe todo o compartilhamento. Os destinatários perdem o acesso; as conversas salvas deles com o agente continuam legíveis, mas não podem ter continuidade.
  • Editar um agente compartilhado afeta todos que o usam. Use uma cópia se precisar fazer testes sem atrapalhar os outros.
  • Revogar a role de um usuário não exclui os recursos que ele criou. Os agentes, prompts e skills dele continuam nas listas de acesso; transfira a propriedade antes de concluir o desligamento.
Última modificação em 24 de julho de 2026