Paper documentação
API pessoal

Cópias para IA

Como funciona o token seguro, a cópia isolada de um cofre e a revisão das mudanças.

O token seguro existe para você entregar um cofre a uma IA sem arriscar o original. A IA trabalha numa cópia; você decide o que volta.

Como funciona

Você cria o token seguro em Configurações → Desenvolvedor e escolhe um cofre. O app manda uma cópia do texto das páginas desse cofre para o servidor. Páginas protegidas por senha ficam de fora.

A IA usa a API normalmente. GET /vaults mostra um único cofre, com id copia- e 16 caracteres. Ela lista, lê, busca, cria, edita e apaga páginas nessa cópia.

Você revisa. Em Cópias para IA, o app mostra quantas mudanças estão esperando. Revisar mudanças lista cada página nova, editada ou apagada, com o texto que a IA deixou.

Você escolhe o que trazer. Com o cofre original aberto no app, marque as mudanças que quer e toque em Trazer para o cofre. Elas entram no seu aparelho e sobem para o Drive na sincronização seguinte. Ctrl Z desfaz. Descartar selecionadas tira as mudanças da lista sem mexer no seu cofre.

Para quem programa a IA

Nada muda na forma de chamar a API. Use o id da cópia onde iria o id do cofre:

COFRE=$(curl -s https://wire.ia.br/api/v1/vaults \
  -H "Authorization: Bearer $PAPER_TOKEN" | jq -r '.[0].id')

curl "https://wire.ia.br/api/v1/vaults/$COFRE/pages" \
  -H "Authorization: Bearer $PAPER_TOKEN"

Diferenças em relação ao token normal:

  • A busca devolve um trecho do texto junto com cada resultado.
  • Não envia arquivos nem mexe na agenda (403 ou 400).
  • A cópia aceita até 6000 páginas. O cofre original precisa ter até 20 MB de texto para ser copiado.
  • Mudanças que a pessoa faz no cofre original depois da cópia não aparecem para a IA. Para dar a versão nova, a pessoa cria outro token seguro.

O que fica guardado

A cópia fica no servidor do Paper, em texto aberto, enquanto o token existir. Ela é apagada quando a pessoa revoga o token ou desliga o modo desenvolvedor. Revisar não apaga a cópia: a IA pode continuar trabalhando nela. Isso está na política de privacidade.

Diga isso à IA

Se a IA sabe que trabalha numa cópia, ela fica mais à vontade para reorganizar e você fica com a palavra final. O botão Copiar instruções para a IA, que aparece quando você cria o token, já monta um texto com o token, o ID da conta, a base da API e o link do mapa da documentação.

Nesta página