> ## Documentation Index
> Fetch the complete documentation index at: https://clickhouse.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Compartilhamento e controle de acesso

> Modelo de permissões e controle de acesso do ClickHouse Agents

[Recurso beta](https://clickhouse.com/docs/reference/settings/beta-and-experimental-features.md#beta-features)

O 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](https://clickhouse.com/docs/pt-BR/agents/marketplace.md).

## 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.

![Parte inferior do painel do Agent Builder com o ícone de compartilhar destacado e um indicador mostrando um principal com quem foi compartilhado](https://mintcdn.com/private-7c7dfe99/i3Gw7HRb0YxPr7dq/images/cloud/agent-builder/sharing/sharing.webp?fit=max\&auto=format\&n=i3Gw7HRb0YxPr7dq\&q=85\&s=f181e1ae813ac0990bf8cc01024ae91d)

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**.

![Modal Compartilhar com a seção Permissões de usuário e grupo, um campo de busca, um usuário existente com a função de Proprietário, uma opção Compartilhar com todos no ClickHouse e os botões Cancelar e Salvar alterações](https://mintcdn.com/private-7c7dfe99/i3Gw7HRb0YxPr7dq/images/cloud/agent-builder/sharing/share-agent-modal.webp?fit=max\&auto=format\&n=i3Gw7HRb0YxPr7dq\&q=85\&s=483d3eb9d915d7c467c50d4b6e517ae4)

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.
