Agentes externos (Beta)

Última revisão: 2026-11-20

Um agente externo é um programa de IA de outro fabricante — um agente que você instalou no seu computador e no qual você mesmo fez login, com a sua própria assinatura ou chave. O Plainva pode iniciar um agente assim na pasta de um vault e mostrar a sessão dele na aba de IA. Isso faz parte das funções experimentais de IA e funciona só no desktop.

Um agente externo não é o assistente do Plainva. O Assistente de IA envia só o que o resumo dele mostrou a você, e nunca o que suas regras de privacidade retêm. Um agente lê e envia por conta própria. Esta página diz o que o Plainva controla numa sessão assim — e o que não controla.

O que o Plainva não controla

Inicie um agente só num vault cujo conteúdo possa chegar ao serviço do agente.

O que o Plainva controla

Adicionar um agente

  1. Instale o agente você mesmo, como o fabricante dele descreve, e faça login nele no programa dele.
  2. Abra Configurações → IA. No cartão Outros programas, em Agentes externos, Encontrado neste computador marca os agentes que o Plainva conhece pelo nome e encontra instalados; Adicionar adiciona um. Para qualquer outro programa que fale o Agent Client Protocol, escolha Adicionar agente… em Outro agente e preencha Nome, Programa e Argumentos, um por linha.
  3. Seu sistema mostra o comando inteiro mais uma vez antes de ele ser lembrado.

O Plainva não instala nenhum agente e não baixa nenhum. Ele inicia exatamente o programa que você confirmou, diretamente e sem shell. O comando é lembrado neste dispositivo, nunca no vault. Remover faz o Plainva esquecer como iniciar um agente; o programa em si e o login dele ficam como estão.

Começar uma sessão

Abra a aba de IA e escolha Agente. Antes de qualquer coisa iniciar, Antes de iniciar ⟨agente⟩ lista o que o agente faz por conta própria e o que o Plainva controla, e diz se as ferramentas do Plainva serão oferecidas. Começar a sessão inicia o programa do agente na pasta do vault. Na primeira vez que você inicia um agente num vault desde que o Plainva foi aberto, seu sistema pergunta mais uma vez e mostra a pasta e o comando inteiro.

Roda uma sessão por vez, e ela pertence ao vault em que foi iniciada: Encerrar a sessão para o programa do agente, e fechar o vault ou o Plainva também. Enquanto ela roda, a primeira linha da sessão diz quem é o agente e que suas regras de privacidade não valem para ele. Nenhum agente é iniciado dentro de um workspace criptografado.

Fazer login

Um agente que não fez login avisa, e a sessão mostra ⟨agente⟩ pede um login com as formas que o agente indica. Dependendo do agente, escolher uma abre uma janela de terminal com o programa do próprio agente, ou o agente leva você por conta própria ao login dele. O Plainva espera e, depois de um login em um terminal, inicia o agente de novo; onde o agente faz o login por conta própria, a sessão continua a mesma. Onde não dá para abrir um terminal, o Plainva mostra o comando para rodar num terminal seu; depois escolha Tentar de novo. O Plainva não vê nada do login.

Em uma sessão

Digite o que o agente deve fazer. A nota que você tem aberta é indicada ao agente — o nome dela e onde ela fica, não o texto dela —, a menos que você a retire acima do campo de entrada; uma nota que você mantém fora da nuvem ou da internet nunca é indicada. A sessão mostra o que o agente diz, o plano dele e cada um dos passos dele, com os arquivos do vault que ele cita.

Quando o agente quer a sua permissão para um passo, ⟨agente⟩ pergunta mostra isso. As palavras são do agente, e as opções também: os botões levam os nomes que o agente lhes dá — só onde ele não dá nenhum você vê Permitir, Permitir sempre, Recusar ou Recusar sempre. Sua resposta vai só para o agente: o que ele faz depois de um sim é com ele, e um “sempre” é uma promessa que o agente cumpre, não o Plainva.

Configurações e comandos. Quando o agente as oferece, o rodapé da sessão mostra as configurações dele: o modo e o modelo como botões — ⟨configuração⟩: ⟨valor⟩ —, o resto atrás do botão de controles deslizantes Mais configurações de ⟨agente⟩. Cada um desses menus começa com o título do próprio Plainva — ⟨configuração⟩ de ⟨agente⟩ ou Mais configurações de ⟨agente⟩ —; abaixo dele, nomes, valores e descrições são do agente, na ordem dele: o valor atual com uma marca, uma opção liga/desliga como um item marcado ou não. Onde as palavras do agente aparecem num título ou numa frase do Plainva, ficam destacadas em itálico discreto, nunca nas maiúsculas do título. Cada sessão começa com os padrões do agente. Uma configuração muda como o agente trabalha, não o que o Plainva deixa passar: ler e escrever pelo Plainva seguem as mesmas regras em qualquer modo, e um modo em que o agente não pergunta mais nada não dispensa nenhum dos passos do próprio Plainva. O que o agente faz com as próprias ferramentas fica fora do Plainva em qualquer modo. Quando o agente muda uma configuração por conta própria, a sessão diz isso: O agente mudou “⟨configuração⟩” para “⟨valor⟩” por conta própria. O que ele muda junto com uma mudança sua, a sessão diz como tal — Junto com isso, o agente mudou “⟨configuração⟩” para “⟨valor⟩”. —, e também uma mudança que ele não fez: O agente não mudou “⟨configuração⟩”. Enquanto uma mudança espera pelo agente, um indicador gira ao lado das configurações, e elas não aceitam nada até ele responder. Uma / no começo de uma mensagem lista em Comandos de ⟨agente⟩ os comandos do próprio agente com o que, segundo ele, eles fazem: as setas percorrem a lista, Enter ou Tab escolhem um comando e Esc fecha a lista. Um comando é uma mensagem que começa com o nome dele; quando o agente diz o que vem depois, isso aparece abaixo do campo até você continuar digitando. O que um comando faz é com o agente.

Parar encerra a resposta em que o agente está trabalhando.

O que o agente escreve

Pelo Plainva. Uma alteração que o agente entrega ao Plainva nunca é escrita na nota. Quando a resposta do agente termina, cada nota que ele alterou traz uma rodada de sugestões, assinada ⟨nome⟩ (agente externo): em Sugestões você aceita ou recusa cada alteração ou a rodada inteira, como na rodada de uma pessoa. Uma propriedade que o texto do agente altera aparece nessa rodada como valor proposto, como os que a IA do próprio Plainva propõe. Uma nota que ainda não existe espera como rascunho — um cartão Rascunho · Nota na sessão, e o mesmo cartão na lista A decidir da aba de IA, onde continua depois que a sessão termina. Criar a escreve exatamente no lugar que o agente indicou — marcada com generated, com o agente como autor —, e Descartar a descarta. Os endereços da web que o agente trouxe são escritos de modo que nada os abra nem os carregue (https[://]…).

O Plainva não aceita tudo: só notas Markdown; nem regras de IA, nem campos de confiança, nem propriedades próprias do Plainva; nenhum valor de propriedade que não seja texto, número, sim ou não, ou uma lista deles; nada que seja mantido fora da nuvem ou da internet; não mais de 150 alterações numa nota por vez; e nenhuma outra nota nova enquanto houver rascunhos demais esperando. O que ele não aceitou, a sessão diz, e o agente fica sabendo.

Por conta própria. Um agente também pode escrever arquivos por conta própria, como qualquer programa. Quando ele informa uma alteração assim, a sessão diz O agente alterou ⟨nota⟩ por conta própria: está no vault sem sugestão. Que caminho um agente toma, o Plainva não pode prometer: depende do agente e de como ele está configurado. Nas configurações, cada agente mostra o que foi visto pela última vez neste computador — quantas alterações vieram pelo Plainva e quantas ele escreveu por conta própria.

O que o Plainva guarda

Se o programa do agente terminar sozinho, a sessão avisa, e Mostrar as últimas linhas dele mostra o fim do que o programa escreveu.

Limites