# O alcance de gravação da IA

> O alcance de um cartão de confirmação: quais objetos ele edita, como valida e como grava as alterações.

Source: https://loomworld.ai/pt-br/docs/ai-writes

## O que um cartão de confirmação pode fazer

Toda gravação executada pelo agente passa pelo mesmo cartão: 1 a 8 operações atômicas, confirmadas de uma só vez, aplicadas de uma só vez e desfeitas de uma só vez. Agrupadas por tipo de objeto:

- Personagens: criar, editar campos (nome, apelidos, gênero, idade, ocupação/papel, arco de personagem, descrição visual, estado de fase, nível de importância, facções) e excluir.
- Relações entre personagens: criar (um rótulo mútuo ou dois rótulos direcionais com uma observação) e excluir.
- Locais / objetos / mundo / prenúncios / linha do tempo: criar, editar campos e excluir em cada um deles; o mundo também suporta a substituição de uma descrição inteira; a linha do tempo abrange o nome da linha de enredo, cor, modo e intervalo do eixo.
- Manuscrito: alterações pontuais no texto (preservando a identidade das linhas) e campos de estrutura de capítulos, cenas e tempos e lugares—criar, editar e excluir.

Fora dos limites: quadros-chave por capítulo, estados de relacionamentos por capítulo, pontuações de ranking, desenhos manuais e marcações em mapas, o fluxo de manutenção em segundo plano e posições livres em painéis. Esses campos não estão na lista permitida, portanto o agente não pode propô-los nem alterá-los.

## O que ele verifica antes de você confirmar

- Todos os capítulos, cenas, tempos e lugares e blocos de conteúdo referenciados devem existir e estar no nível hierárquico correto; as âncoras de prenúncio e de linha do tempo obedecem à mesma regra.
- Um intervalo temporal deve ter seu término posterior ao início; campos enumerados só podem aceitar níveis já estabelecidos (importância, peso narrativo, técnica e importância do prenúncio, categoria de mundo, entre outros).
- Exclusões calculam seu impacto prévio e exibem as contagens no cartão: aparições, relacionamentos, subárvores de locais filhos, vínculos de entrada, eventos dentro da linha e âncoras no manuscrito. Remover um capítulo ou cena também limpa as âncoras de prenúncio e de linha do tempo apontadas para eles, evitando qualquer referência órfã.
- Quando houver facções envolvidas, o cartão informará tanto “quais cartões de facção serão criados” quanto “a quais facções este personagem passará a pertencer”. Um nome ambíguo ou um cartão que tenha sido modificado no intervalo invalida o cartão inteiro—a lista de membros nunca é esvaziada em silêncio.

## E se o projeto mudar enquanto você decide

O cartão traz uma impressão digital do conteúdo a partir do qual foi gerado. No momento da confirmação, o sistema recalcula e compara essa assinatura alvo por alvo: se o alvo tiver desaparecido, o cartão é recusado como “não encontrado”; se o conteúdo tiver mudado, é recusado da mesma forma. Não há nenhuma situação em que uma alteração seja calculada com base em um rascunho antigo e gravada por cima do seu trabalho mais recente. Um cartão deixado aberto por muito tempo exibirá “Proposta expirada”; clique em “Atualizar e continuar” para reler e gerar uma nova proposta.

## Como ele grava após a confirmação

- **Bloqueio de edição**Aviso “Aplicando alterações da IA” surge na tela; edições comuns feitas durante essa janela não são gravadas, impedindo que duas versões disputem a verdade.

- **Esvaziamento prévio de edições antigas**Salvamentos comuns pendentes são concluídos antes que o bloqueio verifique novamente a identidade e as impressões digitais.

- **Gravação única**Todas as operações são aplicadas em ordem e o lote inteiro é gravado no armazenamento principal de uma só vez; somente após o sucesso dessa etapa é que a visualização em memória, as versões e os arquivos derivados são atualizados.

- **Um caminho de volta**O snapshot completo anterior à gravação é enviado para a pilha de desfazer do projeto—um único desfazer devolve tudo ao estado anterior à confirmação. Em caso de falha temporária, o conteúdo da proposta nunca entra no projeto e o cartão continua disponível para nova tentativa.

## Imagens não entram neste cartão

Retratos de personagens e imagens de objetos e locais seguem outro fluxo: o agente elabora uma sugestão de comando a partir da ficha, você ajusta a descrição, a imagem é gerada e apenas a ação de “utilizar” a insere no registro. O caminho Direto pula o rascunho e gera a imagem com base exclusivamente na sua descrição, sem aplicar o estilo visual padrão do projeto. Os resultados retornam como referências para depois serem integrados ao projeto; os dados brutos da imagem nunca entram no histórico da conversa. O estilo visual do projeto fica salvo nas configurações e serve apenas como base padrão para a geração de imagens.

## Limites e solução de problemas

- Um único cartão não pode ao mesmo tempo “criar uma linha de enredo” e “vincular um novo evento a essa nova linha”: o identificador da linha só existe após a primeira gravação, portanto faça isso em duas etapas.
- Chamadas de ferramentas com parâmetros incorretos são tentadas pelo modelo no máximo duas vezes; falhas de permissão, cancelamentos ou inconsistências de versão interrompem o processo imediatamente com o motivo informado.
- Imagens já geradas com sucesso não são canceladas se uma etapa posterior falhar.
- Toda gravação de IA é debitada da sua conta; o histórico de chamadas e créditos pode ser conferido em Conta.

Para entender o funcionamento completo: [Visão geral da colaboração com IA](https://loomworld.ai/pt-br/docs/ai-overview).