# Cópias para IA

Fonte: https://wire.ia.br/documentation/api/copias-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 [#como-funciona]

<Steps>
  <Step>
    **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.
  </Step>

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

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

  <Step>
    **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.
  </Step>
</Steps>

## Para quem programa a IA [#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:

```bash
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 [#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](https://wire.ia.br/privacidade/).

## Diga isso à IA [#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](https://wire.ia.br/documentation/agents/raw.json).