Tudo sobre Ava Supernova

O que é a Ava?

Ava é uma IA que realmente faz coisas — não apenas fala. Ela cria um app para você, escreve um documento, ensina algo do zero, desenha um logo ou cuida da administração que você sempre adia. E ela se lembra de você: do que está trabalhando, como gosta das coisas e do que pediu semana passada.

É só uma Ava, e ela trabalha onde você trabalha — no seu editor de código, como um aplicativo de desktop ou no terminal. Mesma memória, mesma personalidade, em qualquer lugar.

O que a torna diferente

• Sua por padrão. Seu trabalho fica na sua própria máquina. Sem rastreamento, sem telemetria — nunca.
• Aberta para todos verem. Cada linha do código da Ava é pública. Nada para confiar cegamente.
• Grátis para começar. 300 créditos todo mês, sem cartão, sem pegadinha — ou conecte suas próprias chaves de IA e não nos pague nada.
• Ensino embutido. Peça à Ava para te ensinar qualquer assunto e ela cria um curso real — aulas, exemplos e quizzes.

Nunca escreveu código? A próxima página foi escrita especialmente para você. Já é técnico? Pule adiante — ela vai acompanhar o ritmo.

Nunca escreveu código? Comece aqui

Se você nunca escreveu uma linha de código, você é exatamente quem a Ava foi feita para ajudar. Você não precisa aprender nenhum jargão para começar — converse com ela em português claro, como pediria a um amigo experiente. Esta página é toda a sua rampa de acesso.

O que você pode fazer hoje, sem experiência

• Pergunte tudo, em palavras normais — 'o que este arquivo faz?', 'por que minha página está em branco?', 'o que é mesmo um banco de dados?' Ela responde em linguagem clara e lembra da conversa.
• Aprenda algo do zero — diga 'ensine-me Python do zero' e ela cria um curso completo com aulas e quizzes.
• Faça algo ser criado — descreva o que quer ('um botão que baixa minhas notas') e ela escreve, mostrando cada alteração antes que aconteça.

Você não precisa entender tudo

A Ava tem muita mecânica por baixo do capô — modos, modelos, especialistas, roteamento. Você verá essas palavras pelo app e nestes documentos. Aqui está o segredo: você pode ignorar quase tudo. A Ava escolhe as ferramentas certas e os ajudantes certos para você automaticamente. As páginas técnicas estão lá quando você ficar curioso, não porque você precise delas para começar.

Um primeiro caminho suave

1. Instale o Ava (próxima página) e abra o chat.
2. Digite uma pergunta real que você tenha. Qualquer coisa. Veja como ela responde.
3. Experimente o modo de aprendizado: digite "ensine-me" e um tópico. Siga junto.
4. Quando quiser que ela realmente crie ou mude algo, basta pedir — ela sempre mostrará o que está prestes a fazer e esperará pelo seu "sim".

Instalar

Escolha a interface que combina com seu modo de trabalho. Você pode usar mais de uma — na mesma máquina, elas compartilham uma única pasta ~/.ava/, então a memória da Ava te acompanha entre elas.

Extensão do VS Code

1. Abra o painel de Extensões no VS Code (Ctrl+Shift+X / Cmd+Shift+X).
2. Procure por "Ava Supernova" e clique em Instalar.
3. Pressione Ctrl+Shift+A (Cmd+Shift+A no macOS) para abrir o painel de chat.
4. Siga o assistente de configuração — escolha um modelo, defina seu modo de permissão, pronto.

IDE Desktop

1. Baixe o instalador para sua plataforma na página de lançamentos.
2. Execute-o. O IDE inicia com um fluxo de boas-vindas na primeira vez.
3. Faça login para obter tokens gratuitos da plataforma, ou cole sua própria chave de API para rodar totalmente local.

CLI

1. npm install -g @ava/cli (ou pnpm / yarn — sua escolha).
2. Execute o ava em qualquer diretório de projeto.
3. Na primeira execução, ele solicitará um provedor e um modelo. Escolha e vá.

Sua primeira tarefa com o Ava

A maneira mais rápida de usar o Ava é pedir algo real e ver ela fazer. Sem configuração para ler, nada para aprender primeiro — apenas diga o que quer, em palavras simples.

Experimente agora

1. Abra o chat.
2. Digite algo que você realmente queira. Tente "explique o que este projeto faz", ou "adicione um botão que limpa o formulário".
3. O Ava mostra o que ela está prestes a fazer — e espera.
4. Gostou? Diga sim. Observe ela fazer.

Esse é todo o ritmo: você pede, ela mostra o plano, você aprova, ela faz. Ela nunca muda nada sem mostrar antes — então você não pode quebrar nada tentando.

Algumas coisas que valem a pena pedir

• Uma pergunta — "por que minha página está em branco?", "o que este arquivo faz?"
• Algo construído — "crie para mim uma página simples de lista de tarefas".
• Para aprender algo — "ensine-me Python do zero". Ela cria um curso real para você, passo a passo.
• Um documento — "escreva para mim uma proposta de projeto de uma página". Ela te entrega um arquivo Word ou PDF.

Local versus nuvem, em um parágrafo

Tudo o que a Ava guarda é local. Memória, tarefas, diário, personalidade, configurações — tudo armazenado no seu computador em ~/.ava/ e .ava/ (por projeto). Ela conversa com provedores de modelos via HTTPS para executar sua solicitação e depois volta para casa. Ela não liga para casa. Ela não coleta telemetria. Ela não treina com seu código.

Se você fizer login, ganha 300 créditos grátis por mês em ambos os serviços — Maestro no Qwen, e Supernova com coordenador DeepSeek. Fazer login nunca sobe sua memória, tarefas ou configurações — não há sincronização na nuvem. Traga sua própria chave de API e a Ava funciona totalmente sem conta.

Preciso escolher uma IA?

Uma boa notícia: você não escolhe a IA. A Ava seleciona a melhor para cada etapa automaticamente, então você tem bons resultados sem precisar pensar nisso.

A única coisa que você pode escolher é um estilo de roteamento — e o padrão serve para quase todos. Só precisa dos outros por um motivo específico.

Os dois estilos

• Maestro — o padrão. Estável, confiável, previsível. Não sabe qual escolher? Este é o ideal.
• Supernova — para trabalhos pesados e multi-etapas, onde vale a pena colocar um especialista diferente em cada parte da tarefa.

Troque a qualquer momento pelo seletor de modelos no topo do chat. Nada está travado.

Glossário em linguagem simples

Cada palavra que você pode encontrar por aí sobre a Ava, explicada sem pressupor conhecimento prévio. Você não precisa decorar nada disso — consulte novamente sempre que um termo te deixar na dúvida.

Roteamento — como a Ava escolhe os modelos

Versão resumida: você nunca precisa escolher qual modelo de IA usar. A Ava faz isso por você, escolhendo a melhor ferramenta para cada parte de uma tarefa — assim como um bom gerente passa a tarefa certa para a pessoa certa.

Você escolhe um dos dois estilos — Maestro ou Supernova — e a Ava envia cada parte do trabalho para o modelo que lida melhor com ele. O Maestro é o padrão, está disponível em todos os planos e é uma boa escolha para quase todos.

Por que se preocupar com roteamento?

Colocar o modelo certo em cada etapa custa menos do que rodar tudo em um modelo grande e caro — e dá melhores resultados, porque cada modelo faz o que é melhor. Você tem custo estável e alta qualidade sem nunca precisar saber qual é qual.

Créditos Ava — como funciona a faturação

Créditos são simplesmente como a Ava conta o que você usa — como minutos em um plano de celular. Todo plano, incluindo o gratuito, vem com uma cota de créditos, e cada coisa que a Ava faz (responder você, criar uma imagem) custa um pequeno número deles. Essa é toda a ideia. O detalhe abaixo é para quando você quer saber exatamente o que custa o quê.

Ava fatura em créditos, não em tokens brutos. (Um "token" é o pequeno pedaço de texto — cerca de algumas letras — que modelos de IA leem e escrevem; a maioria dos serviços te cobra por token, o que é difícil de prever.) Um crédito cobre uma unidade de trabalho — uma rodada de chat, uma criação de persona (um ajudante fazendo uma parte da tarefa), uma geração de imagem. Desacoplar da medição por nível de token significa que você não precisa saber qual modelo está rodando para saber quanto uma ação vai custar. O mesmo turno de chat custa o mesmo seja o Maestro roteando para o Qwen 3.7 Plus ou o Supernova roteando para o DeepSeek Flash.

Planos

Todo plano tem acesso a todos os recursos — acesso a modelos, Creative Studio, todos os sete modos, a orquestração completa de perfis. Níveis superiores compram mais créditos e um teto de limite de taxa mais alto, não recursos desbloqueados.

• Grátis — $0/mês. 300 créditos. Limite de taxa de 20 requisições/minuto. Nenhum cartão necessário.
• Pro — $19/mês. 5.000 créditos. 60 requisições/minuto.
• Ultra — $39/mês. 10.000 créditos. 120 requisições/minuto.
• Enterprise — $79/mês. 20.000 créditos. 200 requisições/minuto.

Quanto as coisas custam

Tabela de custo por ação — o que é deduzido do seu pool de créditos quando cada ação roda. (Um "acerto de cache" é quando a Ava reusa trabalho que já fez em vez de refazê-lo; quando isso acontece você paga menos — a cobrança cai em 70%, ou 50% em modelos pesados de saída como o DeepSeek Flash.)

• Volta de chat — 2 créditos. Uma única ida e volta em qualquer modo.
• Chamada leve — 1 crédito. Filtro de intenção, classificação, leitura única.
• Persona pesada — 3 créditos. Arquiteto, Pesquisador, Pesquisador de CVE, Idealizador (profundidade ≥ 4).
• Persona leve — 1 crédito. Explorador, Verificador, Sequenciador, Desafiador (profundidade ≤ 2).
• Orquestração — 10 créditos. Início completo do pipeline de personas (Condutor + tarefa com múltiplas personas).
• Geração de imagem — 12 créditos. Creative Studio.
• Geração de vídeo — 150 créditos (720p), 300 em 1080p. Creative Studio, via Wan.
• Geração de voz — 10 créditos. Creative Studio, via Qwen3-TTS.
• Remoção de fundo — 2 créditos.

Multiplicadores por modelo

Esta parte é para os curiosos — você não precisa disso para usar o Ava. Um multiplicador apenas ajusta o custo dos créditos para cima ou para baixo, dependendo de quão caro é o modelo por trás de uma ação, então modelos mais pesados custam um pouco mais. ('Margem líquida' é a parte que o projeto retém após cobrir seus próprios custos — buscamos manter isso baixo para que o valor flua de volta para você.)

Cada modelo tem um multiplicador que ajusta o custo de uma ação para refletir quanto custa realmente executá-lo — modelos mais leves custam menos que a faixa fixa, e os mais pesados, mais. Calibrado para uma margem líquida de ~30%, reajustado para baixo de 55% e depois de 40%: cada vez que a meta cai, todo multiplicador cai junto, e a diferença volta para você.

• 1.0× — qualquer modelo sem um multiplicador listado. Taxa base.
• Uma frota em si não adiciona nada. Todo estilo de roteamento é 1.0× por design; o custo de uma rodada vem inteiramente dos modelos que ela acaba usando. É por isso que mover uma frota para um modelo líder mais barato reduz o que ela cobra sem nenhuma mudança de preço.
• Uma observação sobre o DeepSeek: ele cobra o dobro entre 01:00–04:00 e 06:00–10:00 UTC. Todo preço do DeepSeek citado aqui e na calculadora de custos é o valor fora de pico, válido por 17 horas a cada 24.

BYOK e créditos

BYOK ("traga sua própria chave" — você fornece sua própria conta junto a um provedor de IA e uma chave, que é uma senha privada que permite que o software utilize essa conta paga) é voltado para quem já paga diretamente a um provedor de IA. Se não for o seu caso, você pode ignorar esta seção completamente.

Solicitações BYOK contornam totalmente a infraestrutura da plataforma — a chamada vai direto da Ava para o provedor, você paga ao provedor, sem consumir créditos. A única exceção é quando uma sessão BYOK gera uma persona de nível gerenciado para uma subtarefa; a dedução de crédito ainda se aplica porque a orquestração da Ava está sendo utilizada.

Onde verificar seu saldo

• Extensão — Configurações → Conta, ou o indicador de créditos no cabeçalho do chat.
• IDE — O painel da conta exibe o saldo atual e a taxa de consumo.
• Web — avasupernova.com/dashboard mostra saldo, histórico e data de renovação.

Modos — os estados de espírito da Ava

Um modo é o estado mental em que a Ava está — como um colega trocando de chapéu. Mesma pessoa, mesma memória sobre você, mas um construtor pensa diferente de um professor. Você escolhe o modo e isso muda como ela se comporta e quais ajudantes ela traz. Mude a qualquer momento com o seletor de modos, ou digite um atalho de dois caracteres.

Qual deles você quer?

Comece pelo que você está tentando fazer — o modo segue disso:

• Quero algo construído ou alterado → Código (>>). Você descreve, ela constrói, mostrando todas as alterações primeiro. A equipe completa de ajudantes entra em ação para tarefas maiores.
• Quero um plano antes de qualquer alteração → Plano (::). Ela pensa em tudo e te entrega um plano para aprovar ou editar. Ela não tocará seus arquivos neste modo.
• Só quero conversar ou perguntar → Chat (..). Um parceiro de pensamento com memória, notícias e clima. Sem alterações de arquivo, sem código — apenas conversa.
• Quero aprender algo → Ensinar (??). Um curso real feito para você: aulas, quizzes, tudo. Disponível em todos os planos. Perfeito se você é novo.
• Quero meu projeto verificado quanto a falhas de segurança → Segurança (!!). Uma equipe percorre a lista padrão de vulnerabilidades web comuns (as categorias "OWASP") e falhas conhecidas relatadas (chamadas "CVEs"), depois te entrega um relatório ordenado pela gravidade de cada problema. Este é voltado para desenvolvedores — pule se não for o seu caso.
• Quero ideias → Brainstorm (**). Ela gera opções baseadas na sua situação real, aponta falhas nas fracas e refinando o resto em próximos passos.
• Quero escrever um documento → Escrever (<<). Relatórios, propostas, cartas, artigos — ela rascunha em Markdown e exporta um doc Word ou PDF com marca, refinando seção por seção. Sem código, apenas escrita.

Memória — como a Ava se lembra de você

Em termos simples: a Ava se lembra de você. Conte algo uma vez — o que você gosta, uma decisão que tomou — e ela guarda, para você não ter que repetir na próxima conversa ou semana que vem. Essa é a ideia principal. As camadas abaixo explicam apenas como ela mantém essa memória organizada com o tempo.

A Ava tem uma memória persistente ("persistente" significa que ela fica guardada mesmo após fechar o aplicativo) que persiste entre conversas e entre projetos, e vive apenas no seu computador. Não é um histórico de chat. É uma compreensão estruturada e pesquisável sobre quem você é, o que você gosta e o que decidiu.

Cinco camadas

1. Extrair — fatos-chave capturados de cada mensagem em tempo real.
2. Refletir — análise mais profunda roda ao final de sessões significativas. Padrões, temas, contradições.
3. Acumular — correções e preferências se acumulam ao longo de semanas e meses.
4. Analisar — o motor de grafos conecta memórias relacionadas e sinaliza contradições quando novas informações conflitam com as antigas.
5. Consolidar — memórias similares se fundem; as antigas são podadas. A memória fica mais afiada com o tempo, não mais barulhenta.

Recordação

Quando você faz uma pergunta, a Ava busca na memória por significado ("busca semântica" — ela entende o que você quer dizer, então encontra a memória certa mesmo se você formular diferente), não apenas por palavras exatas. Filtros específicos do modo rodam junto — Modo Chat puxa contexto pessoal, Modo Trabalho puxa decisões de projeto e padrões de código.

Tarefas e diário

A Ava mantém três tipos de anotações para você, e é fácil confundi-las. O jeito rápido de lembrar: memória é o que ela sabe sobre você, tarefas são o que você ainda precisa fazer, e o diário é um registro de como as coisas foram. Veja quando usar qual.

• Memória — fatos persistentes. Preferências, decisões, padrões. Perguntada repetidamente, raramente criada manualmente.
• Tarefas — coisas a fazer. Itens de ação com prazos e status. Você marca como feitos quando concluídos.
• Diário — reflexão. Registro diário, entradas duplas (suas e observações da Ava sobre a sessão). Útil para rastrear humor, revisões de sessão, contexto para amanhã.

A Ava escreve em todas as três quando faz sentido. Você pode escrever em qualquer uma delas diretamente do painel. Nada está travado em um único lugar onde usa a Ava — uma tarefa que cria em um (digamos, a ferramenta de linha de comando) aparece em todos os outros lugares (como o aplicativo desktop), automaticamente.

Permissões — seu botão de segurança

Permissões são seu botão de segurança. Elas decidem quando a Ava pede sua aprovação antes de fazer algo no seu computador, versus apenas prosseguir. Você pode configurá-la para pedir sobre tudo, pedir apenas sobre o arriscado, ou confiar nela para rodar — e você pode mudar a qualquer momento. Se não tiver certeza, deixe no padrão e ficará tudo bem.

Ava tem mais de 120 ferramentas ("ferramentas" são as ações que ela pode executar — ler um arquivo, buscar na web, etc.). Cada ferramenta pertence a uma categoria (operações de arquivo, shell, git, web, mídia, banco de dados, sistema, documentos, memória, aprendizado). Toda chamada de ferramenta passa pelo portão de permissão (um ponto de verificação que decide se deve perguntar a você primeiro) antes de ser executada. Você controla o que é aprovado automaticamente, o que pergunta uma vez e o que sempre pergunta.

Equilibrado é o padrão. Estrito quando você está auditando o comportamento dela (observando de perto para checar cada passo). Autônomo quando você quer que ela apenas vá.

Guiando e parando a Ava

Você está sempre no comando. Enquanto a Ava trabalha, você pode tanto empurrá-la suavemente para uma nova direção sem quebrar o ritmo, quanto pará-la imediatamente. Dois botões, dois resultados — é só isso que esta página trata.

Ava executa até que seu plano seja concluído ou você a pare. Você tem duas formas de intervir (a palavra para isso é "intervir") enquanto ela está em execução.

Intervir — guiar sem cancelar

Digite uma nova mensagem enquanto a Ava trabalha. Ela finaliza sua chamada de ferramenta atual, lê sua mensagem e ajusta seu plano. Nenhum contexto é perdido. Use isso quando quiser redirecionar, adicionar informações ou mudar prioridades no meio da execução.

Parada brusca — cancelar e limpar

Pressione Escape (CLI), clique em Parar (extensão, IDE) ou digite um comando de parada. A execução atual é cancelada, chamadas de ferramentas pendentes são descartadas e a conversa fica pronta para um novo turno.

Personas de área de trabalho

Esta página é para os curiosos e para usuários avançados. "Automação de área de trabalho" (às vezes chamada de "uso do computador") significa que a Ava pode realmente clicar na sua tela e usar aplicativos por você — abrir Gmail, preencher um formulário, enviar uma mensagem — como uma pessoa no teclado. Para fazer isso com segurança, ela divide a tarefa entre cinco pequenos ajudantes, cada um com um papel estreito. Você nunca lida com eles diretamente; isto apenas mostra quem faz o quê.

Cada passo em uma trajetória de área de trabalho (uma execução da Ava guiando sua tela em direção a um objetivo) executa uma onda de cinco personas. Cada persona tem um trabalho e apenas um trabalho. A separação mantém os prompts concisos, as saídas estruturadas e o raciocínio cético por design.

Explorador

Relata o que está visível na tela agora. Nunca inventa elementos. Nunca planeja. Retorna um ScreenState JSON com IDs de elemento, nomes, bboxes, confiança e uma fonte de referência (UIA, Playwright DOM ou visão OmniParser).

Planejador

Decide a única próxima ação. Uma ação por passo — nunca em lote. Preferência por caminhos reversíveis. Classifica risco conforme a ontologia de segurança. Produz um ProposedAction JSON com kind, target, params, riskClass, reasoning e uma previsão de expectedPostState.

Executor

Executa exatamente o que o Planejador propôs — após o portão de aprovação ter sido liberado. Sem improvisação. Sem reexecução. Falha é relatada fielmente e o Verificador cuida do próximo movimento.

Verificador

Verifica se a ação foi executada. Compara o novo ScreenState contra a previsão do Planejador. Retorna verified, deviated, or rollback_needed. Também executa detecção de loop — repetir uma ação que já teve sucesso é um desvio, não uma verificação.

Narrador

A única voz que o usuário ouve durante uma trajetória. Uma frase no passado por passo ("Abriu o Gmail.", "Clicou em Redigir."). Também escreve o registro de auditoria estruturado. Diz quando algo deu errado — nunca esconde um problema.

Ontologia de segurança de área de trabalho

Em resumo: antes de a Ava clicar em qualquer coisa na sua tela, ela classifica a ação pelo nível de risco. Ler a tela? Inofensivo. Enviar dinheiro ou excluir algo? Ela sempre para e pergunta a você primeiro — todas as vezes, sem exceções. As cinco etiquetas abaixo são apenas os degraus dessa escada de risco. Isso é detalhe para usuário avançado, mas a conclusão é simples: o perigoso sempre precisa do seu sim.

Toda ação proposta é classificada em uma das cinco classes de risco. A classificação combina três sinais — o que é o alvo na tela, uma descrição em linguagem simples ("legenda semântica" — palavras próprias da Ava sobre o que ela está vendo), e as configurações da ação — e eleva o nível (trata como mais arriscado) quando discordam. Um falso positivo (perguntar quando não era necessário) é apenas um incômodo. Um falso negativo (não perguntar quando deveria) é um incidente que encerra o produto.

As cinco classes

• Observacional — ler árvore UIA, captura de tela, passar o mouse. Sempre permitido automaticamente.
• Navegação — rolar, mover foco, abrir menu. Permitido automaticamente no modo Drive.
• Mutativo-reversível — digite em um campo, cole, abra um aplicativo, navegue por uma URL. Confirma no modo Ask; automático no Drive dentro da lista permitida.
• Mutativo-irreversível — enviar, submeter, pagar, excluir, confirmar, publicar. Sempre confirma, independentemente do nível de permissão. Aprovação nunca é armazenada em cache.
• Privilegiado — elevação UAC, sudo, edições de registro, prompts de credenciais. Proibido por padrão. Requer opt-in de uso único por sessão.

Aprovações nunca armazenadas em cache

Todo concorrente armazena aprovações em cache (lembra seu "sim" e reutiliza na próxima vez). Esse é o maior ponto de entrada para injeção de prompt — um ataque onde uma página web com armadilha insere instruções ocultas na IA para fazê-la agir contra você. Se as aprovações forem armazenadas em cache, uma página comprometida pode aproveitar um "sim" que você deu antes. A Ava nunca armazena em cache. Cada ação mutativo-irreversível pede uma nova confirmação.

Gerenciamento de segredos

Senhas, chaves de API e códigos 2FA (os códigos únicos que um segundo aplicativo ou mensagem de texto envia quando você faz login) são manipulados via identificadores opacos — espaços reservados que substituem o valor real. A Ava vê "{segredo}", não a senha real. O valor real nunca entra na memória dela, no log de atividades ou no que ela "lê" — uma camada separada de baixo nível digita isso no último momento, ao pressionar a tecla, para que a parte da IA nunca toque nisso.

Hierarquia de fundamentação do Desktop (Prévia)

Antes de clicar em um botão, ela precisa realmente entender o que está na sua tela e onde as coisas estão — isso é "fundamentação" (descobrir o que cada item na tela é e sua posição exata). Ela tem três maneiras de fazer isso e escolhe a mais confiável que funciona para o app em que você está. Isso é um detalhe avançado para usuários experientes; o ponto é apenas que ela prefere métodos sólidos e precisos em vez de adivinhar a partir de uma imagem.

Três níveis, avaliados em ordem. A fonte confiável de menor custo vence.

1. Janela do navegador → Playwright DOM

Se a janela ativa for um navegador web, a Ava lê a estrutura própria da página (o "DOM" — a lista subjacente do que há em uma página) em vez de adivinhar a partir da imagem. Ler a estrutura é cerca de 10× mais confiável do que olhar os pixels — ela sabe exatamente onde cada botão está e quando a página terminou de carregar. Este é o caminho principal para qualquer coisa na web, não um plano de backup.

2. App nativo com UIA → Automação de Interface do Usuário do Windows

Para aplicativos de desktop comuns no Windows, a Ava lê um mapa de acessibilidade integrado ("UIA", o mesmo dado que leitores de tela usam para descrever uma janela) — ele lista cada controle, seu nome e onde fica. Se esse mapa retornar pelo menos cinco itens utilizáveis e nomeados, ela confia nele e o usa.

3. UIA vazio ou inútil → Visão OmniParser

Quando esse mapa está ausente ou é inútil (alguns apps, jogos e telas remotas não fornecem um), a Ava recorre a olhar diretamente para uma captura de tela. Uma ferramenta de visão (OmniParser) identifica as regiões clicáveis e rotula o que cada uma é, transformando a imagem de volta em uma lista na qual ela pode agir — combinado com o pouco que o mapa de acessibilidade conseguiu dar.

Interruptores de emergência do Desktop (Prévia)

Um "interruptor de emergência" é exatamente o que parece — uma maneira de parar a Ava instantaneamente quando ela está controlando sua tela. A parte tranquilizadora: existem três deles, cada um construído separadamente, então se um falhar, outro ainda funciona. Você não precisa aprender todos os três. Apenas saiba que quando algo parecer errado, você sempre pode pará-lo, e a parada mais forte (o pânico abaixo) não depende da Ava cooperar.

Depois de ler todos os incidentes públicos de autonomia (casos reais onde agentes de IA ignoraram comandos de parada, apagaram arquivos de e-mail, limparam unidades), criamos três interruptores de emergência em três camadas diferentes. Nenhum deles depende do próprio modelo de IA — se a Ava estiver travada ou sem resposta, você ainda pode pará-la.

Pausar — espaço ou o botão Pausa

Congela no próximo limite de etapa. Pode ser retomado. Use isso quando quiser intervir sem perder o rumo.

Parar — Escape ou o botão Parar

Aborto limpo. O narrador resume o que foi feito até agora. Não é retomável. Registra no log de auditoria.

Parada de pânico — três vezes Escape ou Ctrl+Shift+K

A parada mais drástica possível. Um pequeno programa de vigilância separado força o encerramento da parte do Ava que está controlando sua tela. Ele não espera a IA responder, não precisa da janela do aplicativo estar funcionando e não se importa com o estado das coisas — ele apenas mata. Este é o recurso para quando algo está realmente errado.

Referência de ferramentas

Esta é a lista completa de todas as ferramentas que o Ava tem — uma "ferramenta" sendo apenas uma ação específica que ela pode realizar, como ler um arquivo ou executar uma busca. Você não precisa ler esta página. O Ava escolhe a ferramenta certa por conta própria toda vez. Está aqui caso você tenha curiosidade sobre exatamente o que ela pode fazer.

A caixa de ferramentas integrada completa. Cada ferramenta aqui está registrada no núcleo de execução (o motor por trás das três superfícies) e disponível para o Ava quando o modo e o modo de permissão permitirem. Filtre por categoria ou risco.

Não precisa decorar nada disso — a tabela abaixo é apenas um cartão de referência.

Níveis de risco

• Seguro — lê coisas sem alterar nada. file_read, glob (encontra arquivos por padrão de nome), grep (busca texto dentro de arquivos), git_status (Git é o sistema que rastreia alterações no seu projeto).
• Escrita — altera arquivos, salva um ponto de verificação do seu trabalho (um "compromisso"), ou produz algo novo. file_edit, git_commit, generate_image.
• Perigoso — executa comandos no seu computador (o "shell"), controla a área de trabalho, vai para a internet ou consulta bancos de dados. bash, browser, desktop_*.

Modelos

Um "modelo" é o cérebro da IA fazendo o pensamento — Qwen, DeepSeek, Mistral e outros. Esta página lista todos os modelos que o Ava pode usar. O resumo: você não precisa escolher um. O Ava escolhe o modelo certo para cada etapa por conta própria. Leia apenas se quiser entender ou sobrescrever isso.

Todos os modelos aos quais o Ava pode rotear, além das três estratégias de orquestração — as regras que decidem qual modelo cuida de cada parte de uma tarefa. Escolha um modo de roteamento e deixe o Ava encaminhar, ou escolha um único modelo e pule o roteamento inteiramente.

Modos de roteamento

Duas estratégias orquestradas. O mesmo pipeline de personas (a pequena equipe de assistentes especialistas que a Ava executa nos bastidores) funciona em ambos; o que muda é a frota de modelos subjacente. Escolha um modo no seletor de modelos e a Ava cuida do resto. Cada cartão abaixo mostra os especialistas constituintes para os quais o condutor direciona.

Não precisa decorar os cartões abaixo — eles estão aqui para você ver do que cada estratégia é feita.

Modelos gerenciados pela plataforma

Disponível em todos os planos, inclusive no plano gratuito. Tokens (as unidades de texto em que a IA é medida — cerca de três quartos de palavra cada) são descontados da sua cota do plano. As chaves (as senhas privadas que desbloqueiam cada modelo pago) são rotacionadas e monitoradas pela plataforma — nada para você configurar.

Traga sua própria chave

Uma "chave de API" é uma senha privada que permite que um software use um serviço pago na sua própria conta. "BYOK" significa apenas "traga sua própria chave" — usando a sua em vez da nossa. Insira sua chave de API nas configurações. Solicitações BYOK vão direto da Ava para o provedor (a empresa que opera o modelo) — elas não passam pela nossa infraestrutura e não consomem tokens da plataforma. Você paga o provedor; nós não vemos o tráfego.

Orquestração de personas

Uma "persona" é um papel de assistente que a Ava desempenha nos bastidores para tarefas mais difíceis — um explorador, um planejador, um verificador de fatos. Você nunca fala diretamente com elas e não precisa entender esta página para usar a Ava. Ela está aqui quando você tem curiosidade sobre como ela divide um grande trabalho em uma pequena equipe de especialistas.

24 especialistas em 5 equipes de modo. O Maestro (o assistente que coordena os demais) decide qual equipe roda, em que ordem e com qual contexto. O modo Chat não tem personas — é a própria Ava.

Como a orquestração funciona

1. Você envia uma mensagem no modo Planejar, Ensinar, Segurança ou Brainstorm (ou um pedido complexo de Trabalho).
2. O Maestro lê o pedido, escolhe a equipe de modo e cria um plano de execução — algumas personas rodam sequencialmente, outras em ondas paralelas.
3. Cada persona tem seu próprio prompt de sistema, uma lista permitida restrita de ferramentas e um conjunto de contexto compartilhado do que as personas anteriores encontraram.
4. A persona final produz um resumo, um plano ou um relatório, dependendo do modo.
5. A Ava apresenta o resultado para você. Você aprova, ajusta ou redireciona.

A lista completa abaixo é apenas referência — não há necessidade de memorizar quem faz o quê. A Ava monta a equipe certa para você.

Comandos CLI

Esta página é para a CLI — a versão da Ava que você digita em uma janela de terminal, em vez de clicar em botões. Se usar a extensão ou o aplicativo desktop, pode pular completamente. Ela está aqui para quem prefere o teclado.

A CLI é um REPL — um prompt que espera você digitar, executa o que foi digitado e espera novamente. Esses comandos com barra (instruções que começam com "/") funcionam diretamente no prompt.

• /help — listar comandos e modo atual.
• /mode <name> — mudar modo (trabalho, escrita, planejamento, conversa, ensino, segurança, brainstorming).
• /model <id> — mudar modelo sem sair da sessão.
• /clear — limpar conversa atual. Memória intacta.
• /history — listar conversas passadas neste projeto.
• /memory — abrir navegador de memória.
• /tasks — listar e gerenciar tarefas.
• /journal — abrir entrada de diário de hoje.
• /settings — abrir menu de configurações.
• /exit — sair do REPL.

Opções de inicialização

Opções são extras que você adiciona ao iniciar a Ava, cada uma começando com "--", para definir como ela abre.

• --mode <name> — iniciar em um modo específico.
• --model <id> — iniciar com um modelo específico.
• --permission <mode> — estrito / equilibrado / autônomo.
• --project <path> — definir explicitamente a raiz do projeto.

Configurações

Esta página mostra onde a Ava guarda suas configurações e arquivos no seu computador. Quase nunca é preciso mexer nisso manualmente — o aplicativo cuida disso por você. Está aqui caso você queira ver, fazer backup ou compartilhar esses arquivos pessoalmente.

A Ava lê as configurações (suas configurações salvas) de dois escopos. Configurações globais — aquelas que se aplicam em tudo — ficam numa pasta chamada ~/.ava/ (o "~" é abreviação da sua pasta pessoal). Configurações por projeto ficam numa pasta .ava/ dentro do próprio projeto.

Geral — ~/.ava/

• settings.json — preferências de modelo, modo de permissão, personalidade, idioma.
• memory/ — suas memórias globais (preferências, decisões que se aplicam em tudo).
• tasks.json — lista de tarefas entre projetos.
• journal/ — entradas diárias do diário, organizadas por data.

Projeto — .ava/

• instructions.md — instruções específicas do projeto que a Ava sempre carrega. Contexto duradouro ("usamos pnpm, não npm", "chaves de API ficam no 1Password").
• context.md — anotações opcionais livres do projeto.
• memory/ — memórias limitadas a este projeto.
• datasets/config.json — configuração de captura de conjuntos de dados (adesão opcional).

Atalhos de teclado

Atalhos de teclado são aceleradores opcionais — todos eles também são botões que você pode clicar. Consulte esta seção apenas se quiser controlar a Ava mais rápido pelo teclado.

Atalhos por interface (cada um dos três lugares onde a Ava roda: a extensão do VS Code, o aplicativo de desktop e o terminal). Personalize-os nas configurações de cada interface. Não precisa decorar a lista abaixo.

Contexto do projeto

Isso explica como a Ava se informa sobre o seu projeto antes de começar — os arquivos que ela analisa para entender no que você está trabalhando. Você não precisa configurar nada disso; ela faz isso sozinha. Leia se quiser saber onde colocar uma nota para que ela sempre veja.

Quando você abre um projeto, a Ava carrega várias camadas de contexto (informações de fundo que ela mantém em mente). Entender as camadas ajuda você a colocar as informações no lugar certo.

Carregado automaticamente

• .ava/instructions.md — tratado como orientação durável e de alta prioridade. Sempre no contexto.
• .ava/context.md — notas livres. Carregado, prioridade menor.
• README.md — escaneado na primeira execução para resumo do projeto.
• package.json / pyproject.toml / Cargo.toml — os pequenos arquivos que listam a configuração do projeto; lidos para detectar a linguagem, framework e comando de teste.
• .gitignore — a lista de arquivos para deixar fora do controle de versão; respeitado por todas as ferramentas de arquivo (glob, grep, project_index).

Carregado sob demanda

"Sob demanda" significa que a Ava só busca esses itens quando uma tarefa realmente precisa deles, e não de antemão.

• Índice do projeto — um mapa estruturado dos seus arquivos e das partes nomeadas dentro deles (funções, classes — "símbolos") e como eles se conectam ("importações"). Criado apenas quando a Ava precisa.
• Histórico do Git — o registro de mudanças passadas; puxado quando git_status, git_diff ou git_create_pr são chamados (Git é a ferramenta que rastreia toda mudança no projeto; "PR" é um pull request, um lote proposto de mudanças).
• Memória — entradas são correspondidas por significado ("semanticamente") e injetadas uma vez por vez, não tudo de uma vez.

Limites de orçamento da área de trabalho

Quando a Ava controla sua área de trabalho em seu nome — clicando, digitando, abrindo apps — cada execução é chamada de "trajetória". Esta página explica os limites de segurança que impedem qualquer execução de durar demais ou custar muito. O resumo: ela sempre para e verifica antes de ultrapassar o limite. Os números estão aqui se você quiser os detalhes.

Cada trajetória roda sob três limites simultâneos (limites rígidos). O primeiro atingido vence. A trajetória nunca continua silenciosamente após uma violação — o Narrador (o assistente que te explica o que está acontecendo) pausa e pergunta o que fazer.

Três limites rígidos (padrão)

• Contagem de passos — 30 passos
• Orçamento de tokens — 500.000 tokens
• Tempo real — 5 minutos

Faixas de custo da tarefa

• Simples (buscar docs, abrir uma página) — 5–10 passos, ~70–135K tokens, ~$0,04–0,08
• Médio (fazer login, verificar logs, baixar saída) — 15–25 passos, ~205–340K tokens, ~$0,12–0,21
• Complexo (triagem de três problemas do GitHub) — 25–30 passos, ~340–410K tokens, ~$0,21–0,25

Os valores de tokens acima são os limites técnicos por trajetória, não sua cota mensal — isso é contado em créditos, e os 300 gratuitos por mês na camada básica cobrem confortavelmente uma mistura de chat, código e algumas automações.

Lista branca da sessão da área de trabalho

Uma "lista branca" é simplesmente a lista de aplicativos e sites que você disse que a Ava tem permissão para tocar enquanto controla sua área de trabalho. Esta página explica como você concede essa permissão e por que ela reinicia a cada vez. A versão curta: ela só pode agir onde você permite, e pede antes de ir a qualquer lugar novo.

No início de uma sessão de área de trabalho, a Ava pergunta onde ela tem permissão para agir. Inglês simples funciona: "Gmail, Cursor, o portal do Azure." Ela lê isso e confirma a correspondência de volta para você ("Web do Gmail, aplicativo Cursor, portal.azure.com").

Como é aplicado

Ações apenas de visualização — tirar uma captura de tela, ler a lista de botões e campos na tela (a "árvore UIA", o próprio mapa do Windows do que há em uma janela) — são permitidas em todos os lugares, porque você precisa ver o que está na tela para decidir se adiciona um aplicativo à lista branca. Qualquer coisa que mude algo é bloqueada fora da lista; a Ava pausa e pergunta se deve adicionar.

Escopo da sessão, deliberadamente

A lista branca NÃO persiste entre sessões. Não há opção "lembrar deste aplicativo". Cada nova trajetória começa com um escopo fresco. Inconveniente por design — esquecer de reautorizar é um recurso, não um bug.

Adições durante a trajetória

Durante uma trajetória, você pode adicionar aplicativos do cabeçalho: "+ Permitir aplicativo" abre uma pequena entrada. Toque em Adicionar e o novo aplicativo fica ativo pelo resto da sessão.

Pacotes de conhecimento

Em termos simples: entregue à Ava uma pasta com seus próprios documentos, e ela pode ler deles para responder às suas perguntas. Um "pacote de conhecimento" é apenas esse conjunto de arquivos — seu material de referência do qual ela pode consultar.

Arraste um diretório de material de referência (especificações, RFCs, atas de reunião, docs de API) para um pacote de conhecimento. A Ava pode puxar as partes relevantes para o contexto quando uma conversa aborda o tópico.

Os pacotes são indexados localmente. A recuperação é semântica — a Ava encontra o documento certo pelo significado, não pelo nome do arquivo. ("Semântica" significa que ela combina com o que o documento trata, então você não precisa lembrar das palavras exatas ou do nome do arquivo.) Os pacotes podem ser compartilhados com a equipe ou mantidos privados.

Creative Studio

Em termos simples: descreva o ícone, imagem, vídeo ou narração que você quer, e Ava cria junto com você — sem software de design, sem luta com prompts.

Creative Studio é um espaço de trabalho de design guiado. Ele abre em três painéis — os tipos de design à esquerda, sua tela no meio e os controles da peça em que você está trabalhando à direita. Não há botão "gerar" para procurar: você fala com o Arquiteto de Design (Ava, no seu papel de designer) na parte inferior da tela, ela usa as ferramentas para você e você refina com alguns controles claros.

O que você pode criar hoje

• Ícones — o carro-chefe. Comece com uma forma real de ícone de linha (1,990 embutidos), escolha um material e a cor da sua marca, e Ava reestiliza e corta para um PNG transparente limpo.
• Imagens — livre-forma, a partir de uma descrição. Quadrado, paisagem ou retrato (1:1, 16:9, 9:16).
• Vídeo — clipes curtos de IA a partir de um prompt. 5 ou 10 segundos, até 1080p, em paisagem, retrato ou quadrado.
• Narrações — texto para fala natural, com prévia da forma de onda. Onze vozes em dez idiomas.
• Kit de Marca — sua paleta, sempre à mão para que cada ativo permaneça alinhado à marca.

Mais tipos de design — ícones de apps, logotipos, emblemas, avatares, banners, imagens principais e sociais, ilustrações, padrões e um conjunto completo para desenvolvimento de jogos — estão sendo adicionados e aparecerão como "em breve" na barra lateral esquerda.

O que impulsiona isso

Ícones e imagens são gerados com Qwen-Image, vídeo com Wan e narração com Qwen3-TTS. Tudo o que você cria vai para sua Biblioteca, organizado pelo tipo em que foi feito.

Creative Studio não é um complemento pago — está disponível em todos os planos, incluindo o Gratuito. As gerações usam seu saldo de créditos normal, o mesmo número do resto do Ava.

Saúde & Nutrição

Em termos simples: diga ao Ava seu objetivo e o que tem para trabalhar, e ela cria um plano de treino e alimentação real — depois ajuda você a segui-lo, dia após dia.

Saúde & Nutrição é uma sala focada no painel. Ava pergunta algumas coisas sobre você — seu objetivo, seus equipamentos, quaisquer limites — depois usa uma biblioteca real de exercícios e receitas para criar um plano que se encaixe. Planos podem ser de fitness, refeição, ou ambos juntos.

Como funciona

1. Ava pergunta sobre seu objetivo e configuração através de controles simples — cartões de objetivo, etiquetas de equipamento, um campo numérico — não uma parede de perguntas.
2. Ela constrói um plano de várias semanas a partir do catálogo, um que você pode realmente fazer com o que tem.
3. Você segue dia após dia; Ava pode preencher ou ajustar qualquer dia individual conforme as coisas mudam.

Tudo é salvo na sua biblioteca de planos local, na sua própria máquina. Os catálogos de receita e exercício são conteúdo real, curado — não inventado na hora.

Transformando um plano em comida

Um plano só é útil se você puder comprar os itens. A lista de compras reúne todos os ingredientes da semana e os organiza como uma loja — hortifruti, carnes e peixes, laticínios, padaria, despensa — para que você caminhe uma vez só em vez de voltar atrás.

• O mesmo item escrito de duas formas é unificado. "Cebola" e "cebola picada" viram uma linha só, e mostra em quais refeições ela foi usada.
• As quantidades se ajustam ao seu lar. Esse número é aplicado aqui e em nenhum outro lugar — seu plano continua por pessoa, então uma família de quatro não multiplica as calorias de cada dia por quatro.
• As unidades são escolhidas para facilitar a leitura. Meio quilo de arroz aparece como 500g.
• Linhas sem medida não são ignoradas. "Sal a gosto" é contabilizado em vez de ser descartado só porque ninguém o pesou.
• Escolha quais refeições está comprando. Tudo começa selecionado; desative uma se já tiver o item. Isso mantém "Já tenho isso" separado de "Já comprei isso", algo que uma simples marca não consegue expressar.
• Se a lista não conseguir cobrir algo, ela avisa o quê e por quê — em vez de parecer completa e deixar faltar coisas em silêncio.

Quando realmente cozinhar

O plano de preparo mostra onde o trabalho cai durante a semana. Separa minutos de mão na massa dos tempos sem supervisão, porque ninguém fica parado sobre um ensopado de quatro horas — cozimento conta como trabalho até uma hora, nada além disso, então um prato longo e lento parece mais leve do que o relógio diz, o que reflete o esforço real.

• Qual dia tem mais trabalho, para você ver uma terça-feira ruim antes de vivê-la.
• O que precisa começar na noite anterior — aveia de noite e similares. Só quando muda verdadeiramente sua noite; um descanso de massa de noventa minutos não vale a pena cobrar.
• O que vale a pena cozinhar uma vez. O mesmo prato duas vezes na semana, dentro dos dias que ele dura, vira cozinha segunda, cobre quarta, economiza uma hora.
• Se você disse à Ava quanto tempo tem para cozinhar, dias que estouram o limite são sinalizados. Se não disse, nada é chamado de pesado — um orçamento não declarado é desconhecido, não zero.

Registrando o que aconteceu

Planos encontram a vida real. Abra qualquer dia passado e marque cada item: fez ou pulou, comeu, comeu outra coisa, ou pulou. Há uma caixa de nota ao lado, e ela diz claramente que a Ava lê — porque as pessoas escrevem diferente quando sabem, e descobrir depois parece estar sendo vigiado.

Em branco significa não registrado. Não significa pulado. São fatos diferentes e a Ava trata-os de forma diferente — ela nunca lerá um dia vazio como um perdido.

Para o treino há também um registro mais completo: séries, repetições e peso, preenchidos previamente pelo que o plano pediu, então o caso comum é alguns toques e só as diferenças precisam ser digitadas. Pular é tão fácil quanto registrar, propositalmente — se pular estiver escondido, as pessoas deixam a linha em branco em vez disso, e a distinção se perde na origem.

O que você registra alimenta a memória da Ava sobre como você realmente treina e come, então o conselho da próxima semana é moldado pela realidade em vez do plano que ela escreveu.

Repetindo e evoluindo

Copie um dia ou uma semana inteira para frente, opcionalmente escalonado — uma repetição a mais, ou uma série a mais. A cópia é escalonada, nunca o original, para que o trabalho já feito não seja reescrito.

Aquecimentos, resfriamentos, mobilidade e dias inteiros de recuperação ficam intocados. Adicionar uma série a um dia de recuperação não é evolução, é silenciosamente transformá-lo em uma sessão — exatamente o que aquele dia foi agendado para prevenir. Carga nunca é escalonada automaticamente também: peso aqui é texto livre, e adicionar uma porcentagem a "peso corporal" é absurdo.

Pedindo ajuda com um dia

Travado numa quinta-feira? Peça à Ava para preencher, adicionar um finalizador, tornar mais fácil, aumentar proteína ou ficar mais rápido. Ela propõe — o dia atual fica ao lado da sugestão dela para você ver exatamente o que muda antes de tocar no seu trabalho, e nada é salvo até você aceitar.

Tudo é salvo na sua biblioteca de planos local, no seu próprio computador. Os catálogos de receitas e exercícios são conteúdos reais e curados — as receitas possuem três níveis de habilidade e método completo, os exercícios trazem guias de técnica, erros comuns e imagens demonstrativas. Nada disso é inventado na hora.

Aprendizado

Em termos simples: peça ao Ava para te ensinar algo e ela cria um curso adequado — lições, exemplos resolvidos e quizzes — depois guia você por ele no seu próprio ritmo.

Aprendizado é uma sala focada no painel. Ava planeja um currículo para o que você quer aprender, ensina lição por lição, verifica seu entendimento com quizzes e rastreia o que você já cobriu para você retomar de onde parou.

Como funciona

1. Diga ao Ava um tópico — "ensine-me Python do zero", ou "ajude-me a entender bancos de dados".
2. Ela constrói um curso estruturado: módulos, lições e pontos de verificação.
3. Você aprende uma lição de cada vez; ela explica, dá exemplos e faz quizzes para fixar o conteúdo.
4. Seu progresso é salvo, então a próxima sessão começa onde você parou.

Por baixo disso, este é o modo Ensinar — uma pequena equipe de especialistas (um arquiteto de currículo, um escritor de conteúdo, um verificador de fatos, um mestre de quizzes e um tutor) que Ava coordena para você.

Office Suite

Precisa de um relatório, um e-mail ou um documento escrito? Ava pode rascunhá-lo e entregar um arquivo real do Word, Excel ou PDF que você pode abrir e editar como qualquer outro.

Relatórios, e-mails e documentos — rascunhados, formatados e exportados para formatos nativos (.docx é Word, .xlsx é Excel, .pdf é um PDF).

• report_generate — um .docx estruturado que extrai dados de tarefas, diário, memória e estado do projeto.
• email_draft — e-mail com tom controlado para um arquivo .docx.
• document_manage — criar, ler, editar, exportar entre Word, Excel, PDF, CSV, Markdown.

Útil quando Ava está escrevendo em seu nome — relatórios de status, apresentações de início, atualizações de clientes. O .docx chega ao seu projeto onde você pode refiná-lo.

Biblioteca

Em termos simples: uma única prateleira para o que você guarda — os artigos que lê, os ativos que cria e os documentos que escreve — para que nada se perca.

A Biblioteca é um painel navegável com três abas:

• Artigos — artigos científicos que você salvou, trazidos do arXiv, OpenAlex e Crossref, com o texto completo para ler direto na tela.
• Ativos — tudo que você criou no Creative Studio, organizado pelos mesmos tipos de design usados na criação (Open Canvas, Web / App, Dev de Jogos). Filtre por grupo e depois por tipo; cada tipo mostra quantos você possui.
• Documentos — os arquivos Word, Excel, PDF e outros que a Ava escreveu com você, filtráveis pelo tipo.

Uma barra de armazenamento no topo mostra quanto espaço seus arquivos locais ocupam, e um botão "Abrir pasta de salvamento" te leva direto para a pasta no disco. É focado no local — a Biblioteca lê o que está na sua própria máquina.

Resumo diário

Em termos simples: uma nota curta "aqui está onde você parou" toda manhã, para que você possa retomar sem reler tudo.

Resumo matinal: diário de ontem, tarefas abertas, estado do projeto e quaisquer lembretes que a Ava definiu. Opcional — ative nas configurações.

O resumo usa a memória para mostrar contexto relevante ("na última vez que trabalhou no fluxo de autenticação, você notou que queria revisar a estratégia de token de atualização"). Não é um feed de notícias — é uma atualização focada.

Fluxos de Trabalho

Em termos simples: ensine à Ava uma rotina que você faz repetidamente, dê um nome a ela e ela pode executar tudo novamente sob demanda. Um "workflow" é apenas essa rotina salva — um conjunto de passos que Ava repete para você.

Salve uma sequência de passos que você encontra repetindo-se — revisar o pull request → rodar testes → escrever notas de versão → rascunhar o e-mail. Um workflow é um plano reutilizável que Ava pode reproduzir com entradas diferentes.

Os workflows são armazenados por projeto em uma pasta chamada .ava/workflows/ dentro do seu projeto. Compartilhe-os com sua equipe fazendo commit do diretório (salvando-o no seu projeto compartilhado para que os colegas também o recebam).

Eventos e notificações

Em termos simples: enquanto a Ava trabalha, você recebe uma lista passo a passo organizada do que ela está fazendo, e um aviso quando um trabalho longo termina para que você possa se afastar.

Enquanto a Ava está executando, você vê atualizações estruturadas, não um muro de texto. Cada chamada de ferramenta, cada transferência de agente, cada delta transmitido é um evento discreto na interface — expansível para detalhes, colapsável para visão geral.

Execuções em segundo plano emitem notificações ao nível do sistema operacional quando terminam. Você pode se afastar de uma compilação longa e a Ava avisará quando estiver pronta.

Designer de Personalidade

Em termos simples: ajuste como a Ava fala com você — conversadora ou breve, formal ou casual, mais piadas ou menos — para que ela soe como você gosta.

Defina como a Ava fala com você. Tom, energia, verbosidade (o quanto ela diz), formalidade, humor. Controles deslizantes e presets — engenheiro conciso, mentor acolhedor, colega seco, ou sua própria mistura.

A personalidade afeta a formulação, não a competência. Ela ainda executa as mesmas ferramentas e segue as mesmas regras de permissão. O nome dela está travado em Ava — isso é inegociável.

Automação de Área de Trabalho

Em termos simples: Ava pode assumir o controle do seu mouse e teclado para fazer tarefas por você — abrir um aplicativo, clicar em botões, preencher um formulário — enquanto você assiste e aprova qualquer coisa importante.

Um novo modo para Ava, prefixo @@. Ela observa a área de trabalho, decide o que fazer e executa a automação de interface (controlando os aplicativos na sua tela para você) para concluir a tarefa. Roda na sua máquina real com suas credenciais reais — não é um navegador na nuvem. Disponível em todas as camadas após o lançamento.

Por que mais uma?

A maioria dos produtos de automação de desktop age como um simples clicador, fazendo o que manda. A Ava planeja primeiro: ela mostra os passos, espera sua confirmação e pergunta novamente antes de qualquer coisa irreversível — sempre, nunca em cache.

Ela também lembra como navegar nos seus aplicativos entre sessões. Todo outro agente reaprende tudo toda vez. O diferencial de memória se acumula com o uso.

Como funciona

Cada etapa ativa uma onda de cinco personas: Scout observa, Planner escolhe a próxima ação, Actor executa, Verifier verifica, Narrator relata o que aconteceu. O sidecar escolhe a ancoragem confiável mais econômica — UIA para aplicativos nativos, Playwright para navegadores, visão OmniParser quando nada mais oferece uma árvore útil.

Veja as páginas de conceitos para ontologia de segurança, hierarquia de ancoragem, interruptores de segurança e o modelo de lista branca de sessão.

Erros comuns

A maioria dos erros tem uma causa curta e específica. Aqui estão os mais comuns e como corrigi-los. Não se preocupe se o texto parecer técnico — cada um abaixo diz exatamente o que você está vendo e o que fazer.

Modelo não responde

O que você vê: A Ava fica em silêncio e não responde.

Verifique o indicador de status no cabeçalho do chat. Se disser "conectando", seu provedor (o serviço de IA com o qual a Ava está falando) está acessível, mas lento — aguarde trinta segundos. Se disser "indisponível", a Ava caiu automaticamente para o próximo modelo na cadeia (ela trocou automaticamente para um modelo de backup). Se nada acontecer, verifique sua chave de API nas Configurações e teste a conexão. (Uma chave de API é a senha privada que permite à Ava usar um serviço de IA pago.)

Chamada de ferramenta falhou

O que você vê: Uma das etapas da Ava (uma "chamada de ferramenta" — ela lendo um arquivo, executando um comando, etc.) mostra um erro vermelho em vez de terminar.

Clique na chamada de ferramenta falhada para ver o erro. Causas comuns: ela tentou tocar em um arquivo fora da pasta do seu projeto, o que é bloqueado propositalmente por segurança (essa proteção é chamada de proteção contra "travessia de caminho" — impede que ela saia da pasta em que você está trabalhando); um comando que precisa ser executado em outra pasta; ou um arquivo que foi movido desde que a Ava olhou pela última vez. Diga a ela o que aconteceu — ela tentará novamente com correções.

Memória não recorda

O que você vê: A Ava não encontra algo que você tem certeza que ela deveria lembrar.

A memória funciona por significado, não por palavras exatas (é isso que "semântico" significa). Então "O que decidi sobre autenticação?" funciona melhor do que "encontre minha decisão sobre auth". Se a memória estiver definitivamente lá mas não aparecendo, abra o navegador de memória e pesquise — se não estiver lá, nunca foi salva.

Loops de login

O que você vê: Você faz login, mas a Ava continua pedindo para você fazer login novamente — um ciclo que nunca deixa você passar.

A solução é limpar os detalhes de login salvos e começar do zero: na extensão, execute "Ava: Sign Out" na paleta de comandos; na IDE, vá em Configurações → Conta → Sair; na CLI, exclua o arquivo em ~/.ava/auth.json (um pequeno arquivo de login em uma pasta chamada .ava no seu diretório home). Depois faça login novamente.

Tokens esgotados

O que você vê: Uma mensagem dizendo que você acabou do uso gratuito do mês. (“tokens” são como o uso de IA é medido — “esgotados” apenas significa que você usou toda a cota gratuita deste mês.)

O orçamento mensal da camada gratuita reinicia no dia 1 de cada mês. Até lá, mude para um provedor BYOK (use sua própria chave de API) para continuar trabalhando. Sua conta permanece ativa — apenas as solicitações gerenciadas gratuitamente pela plataforma estão pausadas.

Onde ficam os logs

Um "log" é apenas um diário que seu computador mantém do que aconteceu — útil quando algo quebra e você (ou o suporte) precisa ver os detalhes.

Quando você precisa da imagem bruta — qual ferramenta foi chamada, que informações ela obteve, o que o serviço de IA retornou — os logs são arquivos de texto simples em uma pasta no seu computador em ~/.ava/logs/ (uma pasta chamada .ava no seu diretório home, com uma pasta logs dentro dela).

• ~/.ava/logs/session-<date>.log — transcrições por sessão incluindo chamadas de ferramentas, respostas transmitidas e erros.
• ~/.ava/logs/extension.log — log do host da extensão VS Code. Falhas de ativação, erros do painel.
• ~/.ava/logs/ide.log — log do IDE desktop. Mensagens do processo sidecar, falhas no Rust.
• ~/.ava/logs/cli.log — log do REPL CLI.

Na extensão, "Ava: Show Logs" na paleta de comandos abre o log relevante em uma aba de editor. Na IDE, Configurações → Diagnósticos tem um botão "Open Logs". A CLI pode acompanhar seu próprio log com ava logs --follow.

Abrindo um pedido de suporte

Em termos simples: se algo estiver errado e as correções acima não ajudarem, envie-nos uma mensagem sobre isso. O jeito mais fácil é pedir para a Ava fazer isso por você.

Se um problema não estiver coberto pelos erros comuns, abra um chamado de suporte (envie um pedido de ajuda à equipe de suporte). Você pode fazer isso dentro da Ava (sem formulário para preencher) ou na web.

Dentro da Ava

Peça para ela abrir o chamado. "Ava, você pode abrir um chamado de suporte sobre isso?" Ela aciona o support_request, anexa o contexto relevante da sessão (com credenciais ocultadas) e envia. Caminho mais rápido.

Pela web

Acesse avasupernova.com/support. Escolha uma categoria (bug, feature, account, security, general) e descreva o que aconteceu. Resposta em até um dia útil.

O que incluir

• O que você estava tentando fazer.
• O que realmente aconteceu.
• Qual ambiente (extensão, IDE, CLI) e qual versão.
• Qualquer mensagem de erro ou trecho de log. Oculte as credenciais primeiro.

Reportando problemas de segurança

Em termos simples: se você identificou uma forma de a Ava ser invadida ou usada indevidamente (uma "vulnerabilidade" — uma falha de segurança), por favor nos avise privadamente primeiro para que possamos corrigir antes que alguém possa explorar. Esta página explica como.

Encontrou uma vulnerabilidade? Obrigado. Levaremos cada relatório a sério e trabalharemos com você na correção antes de qualquer divulgação pública (antes que o problema seja anunciado publicamente).

Como reportar

1. Envie um email para security@ava-supernova.com com uma descrição, passos para reproduzir e sua janela de divulgação preferida.
2. Ou abra um chamado de suporte com a categoria "segurança" — mesma fila de triagem.
3. Reconhecemos em até 24 horas.

Nossos compromissos

• Divulgação coordenada — concordamos com um cronograma com você antes de qualquer coisa ficar pública. O padrão é 90 dias.
• Crédito — você será creditado nas notas da correção, a menos que prefira anonimato.
• Sem retaliação legal — pesquisas de boa-fé são bem-vindas. Não enviaremos advogados atrás de você.