Os agentes estão em beta. O que esta página descreve é o que o servidor aplica hoje.
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.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á.
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.
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.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.
Revogar
Configurações → Agentes → o agente → Revogar. A sessão para, os refresh tokens são revogados, e a próxima chamada do agente respondeO 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
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.
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.
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 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.
Por onde seguir
Recomendações
Qual canal liberar, e o que nunca mandar.
Agentes numa organização
As duas alavancas de um administrador, e o que elas mostram.
Canais
Canais privados e compartilhados, e os limites por plano.
O que o servidor consegue ver
A lista inteira, escrita sem rodeios.