Nível 4 · Maestria

Trabalhando com a sua IA

O Rayzia não vende créditos de IA. Você conecta uma conta que já é sua, a chave fica no seu navegador e o assistente controla o editor de verdade: ferramentas reais, comandos reais, desfazer real. Esta lição cobre como conectar, o que ele realmente consegue fazer e como escrever prompts para que ele faça o trabalho em vez de uma aproximação grosseira dele.

Conectando sua conta

O Assistente de IA é uma aba no dock direito. Ao abri-la você vê um painel de chat com um compositor na parte de baixo e, se ainda não conectou nada, um aviso em âmbar pedindo uma chave.

  1. Abra as configurações do Assistente de IA Clique no ícone de engrenagem no cabeçalho do painel. Ele também abre sozinho na primeira vez que você tenta enviar uma mensagem sem chave configurada.
  2. Escolha um provedor A navegação à esquerda lista Anthropic (Claude), Google Gemini, OpenAI e Claude Code (local), além de uma entrada separada de Geração de imagens.
  3. Cole sua chave Cada painel de provedor aceita sua própria chave de API, opcionalmente um id de modelo e, para os provedores compatíveis com OpenAI, uma URL base. O padrão da Anthropic é claude-opus-4-8, do Gemini é gemini-2.0-flash e da OpenAI é gpt-4o.
  4. Salve e use esse provedor O subtítulo do cabeçalho muda para um Pronto em verde assim que uma chave é configurada. Âmbar significa que ele ainda está esperando uma.

Não existe backend. A chave fica no armazenamento local do seu navegador e as chamadas vão da página direto para o provedor. O Rayzia nunca a vê, e não há chave compartilhada para acabar. A contrapartida é que a conta é sua e os limites de uso também.

Se você roda o Claude Code localmente, há um quarto caminho sem chave de API nenhuma. O painel Claude Code (local) oferece uma porta de bridge, um botão Conectar e um SKILL.md que você copia. Ele conversa com um servidor MCP local apenas em loopback, com um token de capacidade gerado por navegador e embutido na cópia do SKILL.md que você entrega.

O que ele realmente consegue fazer

O assistente trabalha por meio de uma camada de verbos semânticos, quarenta e um deles, executados contra o engine real. Agrupados aproximadamente:

  • Desenhar e selecionar: select, useTool, createShape, drawPath, freehand, spray, group, clearCanvas.
  • Texto: createText, setText, areaText, textOnPath, touchType, listFonts, loadFont.
  • Pintura: setPaint, addGradient, widthProfile.
  • Efeitos: applyEffect, applyPathEffect, applyFilter, applyBlend, transformEffect, applyEnvelopeWarp.
  • Imagens: generateImage, placeImage, placeImageFromUrl, searchImages.
  • Recursos: saveAsset, listAssets, applyAsset, generateAsset, validateAsset, além das operações de pastas.
  • Organização: setLocked, setHidden, batch, runCommand.

Ele não se limita a essa lista. Pode enumerar as ferramentas e comandos do editor e acioná-los: useTool ativa qualquer ferramenta da barra e runCommand alcança comandos do engine diretamente. Também pode ler o documento, pedir uma renderização do canvas e olhá-la, e enumerar os efeitos disponíveis — por isso um pedido como deixe isso menos chapado recebe uma resposta pensada em vez de um chute.

Tudo que a IA faz entra no histórico. Cada verbo chamado é um passo de desfazer, rotulado com o que foi feito. Um batch com muitas operações vira um único desfazer. Traços à mão livre e no estilo caneta são reproduzidos pelas ferramentas reais, então podem virar mais de um passo. De um jeito ou de outro, Ctrl+Z te leva de volta.

Escrevendo bons prompts

O assistente é competente e literal. A maioria dos resultados decepcionantes vem de um prompt vago justamente no ponto que importava.

  • Selecione primeiro, depois fale. Se algo está selecionado, diga recolorir a seleção com uma paleta quente e ele opera exatamente sobre isso. Um recolorir isso sem seleção o obriga a adivinhar.
  • Dê números quando os tiver. Três retângulos, 120 por 40, empilhados com espaços de 16px é uma tarefa. Umas caixas é um convite ao improviso.
  • Nomeie o resultado, não a técnica. Ele consegue enumerar as próprias ferramentas. Faça a borda do emblema parecer desenhada a nanquim dá espaço para escolher o efeito certo; aplicar Roughen em 2 também serve quando você sabe exatamente o que quer.
  • Itere em passos pequenos. Peça o layout, olhe, depois peça a cor. Uma instrução longa é mais difícil de desfazer de forma limpa do que quatro curtas.
  • Peça para usar batch. Cinquenta formas parecidas em um batch são um passo de desfazer e uma única ida e volta. Também sai mais barato para a sua chave.

Há um limite de dezesseis passos por mensagem. Se ele for atingido, você verá uma mensagem avisando. Normalmente é sinal de que o pedido deveria ter sido dois pedidos.

TeclasFaz
EnterEnviar o prompt
Shift+EnterNova linha no compositor
Ctrl+ZDesfazer o que ele acabou de fazer
Ctrl+YRefazer

O que ele não vai fazer

A fronteira da IA carrega uma lista de bloqueio, e ela não é negociável pelo chat. O assistente não pode abrir, salvar, exportar, importar, posicionar arquivos, imprimir, fechar ou recarregar o documento, nem chamar comandos internos. Operações comuns de edição, incluindo excluir e limpar, continuam permitidas, porque são desfazíveis — e todo o design se apoia nisso.

O manuseio de imagens é deliberadamente restrito. Imagens geradas são incorporadas diretamente. Imagens buscadas na web são recodificadas antes de entrar no documento, então nenhuma URL remota acaba gravada no seu arquivo.

A revisão continua sendo sua. O assistente é rápido e, de vez em quando, erra com confiança, exatamente como qualquer outro modelo. Olhe para o canvas, não para o log do chat.

Gerar é outra coisa

Há uma segunda aba chamada Gerar, e ela não é o assistente. Ela cria recursos de biblioteca em vez de arte no canvas. Descreva o que quer, escolha um Tipo entre Pincel, Amostra, Gradiente, Símbolo, Filtro, Estilização, Efeito de Caminho ou Marcador, e o resultado passa por um portão de validação antes de cair em Recursos, em Seus, na pasta Gerados por IA.

O portão verifica esquema, tamanho, faixas numéricas, sanitização e depois aplica o recurso brevemente de verdade para ver se funciona. Uma falha ganha uma nova tentativa automática usando o próprio relatório do portão. Ele reutiliza a chave do provedor do chat, então conectar uma vez cobre as duas superfícies.

Regra prática: o Assistente de IA altera seu documento; o Gerar abastece sua caixa de ferramentas.

Perguntas comuns

O Rayzia cobra pela IA?

Não. Você conecta uma conta que já tem e o uso é cobrado nessa conta. O plano gratuito inclui o painel de IA como qualquer outra ferramenta.

Onde minha chave de API fica armazenada?

No armazenamento local do seu navegador, no seu dispositivo. Não há componente de servidor nem proxy. Limpar os dados do site a remove, e outro navegador vai precisar que você a cole de novo.

Posso usar um modelo local ou auto-hospedado?

Os provedores compatíveis com OpenAI aceitam uma URL base, pensada para Groq, Ollama ou um proxy seu. Qualquer coisa que fale essa API deve funcionar. À parte, o Claude Code (local) conecta por uma bridge em loopback e dispensa chave de API.

Ele desenhou algo errado. Como me livro disso?

Ctrl+Z. Cada verbo que não é de desenho é um passo de desfazer e um batch vira um só. Traços à mão livre são reproduzidos pelas ferramentas reais, então podem levar alguns desfazeres para sumir.