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

# Liberações: quais canais um agente pode usar

> Uma liberação é um canal que o agente pode usar, com dois botões: mandar e ler. Mude ou revogue quando quiser, e o agente sente no próximo pedido.

<Note>
  Os agentes estão em **beta**. O que esta página descreve é o que o servidor aplica hoje.
</Note>

Um agente chega a um canal só por uma **liberação**. Sem liberação, sem chave, sem acesso.

## O que é uma liberação

Uma liberação é um canal, mais dois botões, mais a chave daquele canal selada para a chave pública do agente.

| Botão      | O que permite                                                          |
| ---------- | ---------------------------------------------------------------------- |
| **Mandar** | `zas_send_file`, `zas_send_note` e `zas_send_direct` naquele canal.    |
| **Ler**    | `zas_list_items`, `zas_get_item` e `zas_receive_direct` naquele canal. |

`zas_edit_item` e `zas_replace_file` precisam dos dois botões: eles leem o item primeiro e depois escrevem por cima.

Mandar vem ligado quando você aprova um pareamento. Ler é um botão separado, e fica desligado até você ligar.

Os dois são independentes. Um agente que só manda é o caso comum: ele solta um build ou um print num canal e nunca olha o que mais está lá.

<Note>
  Receber uma transferência pelo Direto usa o botão **ler**, não o de mandar. Ela escreve um arquivo na máquina onde o agente roda, e isso é uma leitura do canal, seja qual for a direção dos bytes.
</Note>

## Onde você muda isso

**Configurações → Agentes.** Cada agente mostra o nome, o harness, o host e o último envio, e depois uma linha por canal com os dois botões e um link para tirar. **Adicionar um canal** abre a mesma lista que a página de pareamento usa.

Todo canal que tem agente também carrega uma faixa acima dos itens, com cada agente e os botões dele. Você pode tirar um agente de um canal ali mesmo.

<Note>
  Uma mudança vale na **requisição seguinte** do agente. O servidor lê a liberação ao vivo toda vez, então não há cache para esperar.
</Note>

## Revogar

**Configurações → Agentes → o agente → Revogar.**

A sessão para, os refresh tokens são revogados, e a próxima chamada do agente responde `O dono revogou este agente`.

O que ele já mandou fica onde está. Os itens do agente são seus itens: expiram no relógio normal, e você apaga como apaga qualquer outro.

Para estreitar em vez de revogar, tire um canal só e mantenha o resto.

## Os números

|                   | Sem conta | Plano grátis |
| ----------------- | --------- | ------------ |
| Agentes           | Nenhum    | 5            |
| Canais por agente | —         | 5            |

Numa organização, um administrador define quantos agentes cada pessoa tem, e não há teto de canais por agente. Veja [Agentes numa organização](/pt-BR/agents/enterprise).

<Warning>
  Duas regras surpreendem, então vale dizer com todas as letras.

  **Um agente revogado continua ocupando a vaga.** A conta inclui os revogados. Apague um para liberar a vaga.

  **Tirar um canal não libera uma vaga de canal.** O alcance conta todo canal que o agente já teve, não os que ele tem agora. Um agente que usou os cinco canais precisa ser apagado e pareado de novo para apontar para outros.
</Warning>

## Canais de organização

Um canal que uma organização administra só pode ser liberado quando essa organização ligou os agentes. O botão é **Permissões → Agentes em canais da organização**, vem desligado, e é de um administrador.

Duas coisas vêm de onde a checagem acontece:

* **O botão é lido em toda chamada, não na hora da liberação.** Desligar fecha na hora todas as liberações nesses canais. Uma liberação é só uma chave; a porta é conferida toda vez.
* **O seu próprio lugar no canal é o teto.** Sair do canal, ou sair da organização, fecha o acesso do seu agente a ele, diga o que disser o botão.

Enquanto o botão está desligado, os canais de uma organização ficam fora do alcance de todo agente, e a lista não os oferece.

## O que uma liberação nunca cobre

* **Um canal em que você só entrou.** As liberações existem em canais que a sua própria conta possui, e em canais administrados por uma organização que a organização abriu.
* **O seu [canal Privado](/pt-BR/using-zas/channels)** pode ser liberado como qualquer canal seu, mas pense antes. É o único lugar onde nada é compartilhado.
* **Um canal em somente leitura.**

## O que o servidor confere de qualquer jeito

Os botões da interface não são a única linha. Atrás deles:

* A API responde a um agente numa **lista fixa de rotas** e recusa todas as outras. Somar uma rota ao Zas nunca alarga por acidente o que um agente pode fazer.
* As regras do banco recusam a um agente o documento da sua conta, os seus aparelhos e qualquer canal sem liberação de leitura ativa.
* Os limites de taxa correm em baldes próprios, e a derivação de chaves é cobrada da sua conta, então dez agentes não são dez vezes a sua cota.
* O servidor nunca vê a chave de um canal, o nome de um canal nem o conteúdo de um item. Isso não muda porque quem manda é um agente. Veja [Criptografia](/pt-BR/concepts/encryption).

## Por onde seguir

<CardGroup cols={2}>
  <Card title="Recomendações" icon="lightbulb" href="/pt-BR/agents/recommendations">
    Qual canal liberar, e o que nunca mandar.
  </Card>

  <Card title="Agentes numa organização" icon="building" href="/pt-BR/agents/enterprise">
    As duas alavancas de um administrador, e o que elas mostram.
  </Card>

  <Card title="Canais" icon="hashtag" href="/pt-BR/using-zas/channels">
    Canais privados e compartilhados, e os limites por plano.
  </Card>

  <Card title="O que o servidor consegue ver" icon="shield" href="/pt-BR/concepts/privacy">
    A lista inteira, escrita sem rodeios.
  </Card>
</CardGroup>
