Pular para o conteúdo principal

Glossário

Definições curtas e precisas dos termos usados na documentação do Imaginne, em ordem alfabética. Cada termo aponta para a página onde o assunto é tratado em profundidade.

A​

Agente — A entidade que conduz uma sessão: lê, raciocina com um modelo, usa ferramentas e skills, e responde. No Desktop/TUI/VS Code o agente roda no Engine local. Veja Arquitetura.

AllowedModels — A lista de modelos que a política da organização permite. Determina o que aparece no seletor de modelo. Veja Modelos e Governança.

Artefato — Um arquivo que o agente gera: .pptx, .docx, .xlsx, .pdf, imagens, código. No Desktop aparece no dock de Preview e na pasta de saída; no chat web, em cartões com Baixar. Veja Arquivos & artefatos.

Autonomia — Quanto o agente pergunta antes de agir: baixa (confirma tudo), média (padrão) e alta (não pergunta). É distinta do modo de execução. Veja Autonomia & permissões.

B​

BYOK (Bring Your Own Key) — Chaves de fornecedor de modelo cadastradas pela organização (não por usuário), write-only, usadas no servidor ao chamar o fornecedor. Veja Administração → BYOK e Credenciais & segredos.

C​

Cofre (firewall) — O conjunto de regras, sempre ativo, que restringe o agente ao workspace e impõe negações fixas (comandos catastróficos, caminhos de sistema). Vale em qualquer nível de autonomia. Veja Autonomia & permissões.

Compactação — A redução automática de partes antigas do contexto quando a janela se aproxima do limite, para a conversa continuar sem perder o fio. Veja Sessões.

Contexto — O que o modelo "lê" em uma chamada: a mensagem atual mais o histórico e os trechos relevantes. Tem um limite (janela de contexto). Veja Sessões.

D​

dangerous_bypass — O modo de execução menos restrito, que desliga as validações de shell. Só fica disponível se o aplicativo foi iniciado com o sinalizador apropriado; mesmo assim, workspace e auditoria continuam valendo. Veja Autonomia & permissões.

Desktop — O aplicativo nativo (macOS/Windows) do Imaginne, com o Engine embutido. Veja Instalar o Desktop e Usar o Desktop.

E​

Engine — O componente que executa o agente. Roda localmente no Desktop, na TUI e no VS Code; no chat web roda no servidor. Veja Arquitetura.

Env-secret — Um segredo por organização (token, certificado, credencial), write-only, injetado apenas nas skills que o declaram em required_env, sem carry-over. Veja Administração → Env-secrets e Credenciais & segredos.

F​

Firewall — Veja Cofre.

G​

Gateway — O corretor de modelos do Imaginne: o componente que fala com o provedor de IA e o ponto único de saída do conteúdo do prompt. Veja Arquitetura.

Grupo de skill — Um agrupamento de skills que também delega administração a um skill_admin. Veja Administração → Grupos de skill.

I​

Identidade — Quem você é no Imaginne, carregada pela sua sessão autenticada e vinculada à sua organização. Veja Identidade & login.

L​

local_plain — O modo de execução normal de skills: os arquivos ficam abertos em ~/.imaginne/skills/<key>/, transparentes. Veja Modos de execução.

local_protected — O modo de execução com integridade verificada (HMAC + digest), execução em pasta temporária e anti-shadowing. Garante integridade, não sigilo (não é DRM). Veja Skills protegidas.

Local-first — O princípio de que, nas superfícies de aplicativo, o agente roda na sua máquina e os arquivos não saem; só o conteúdo do prompt trafega. Veja Execução local & privacidade.

M​

Memória — Quatro notas Markdown por projeto (perfil, projeto, glossário, decisões) que persistem entre sessões e entram no contexto no início de cada uma. Veja Memória.

Modelo — O motor de IA que o agente usa. O produto expõe nnumbers e nnumbers-code, além do modo automático. Veja Modelos.

Modo automático — O roteamento por turno entre nnumbers e nnumbers-code conforme a tarefa. Veja Modelos.

Modo de execução — O controle, separado da autonomia, sobre rodar comandos de terminal: safe, auto (padrão) e dangerous_bypass. Veja Autonomia & permissões.

N​

nnumbers — O modelo principal e padrão do produto: planeja, raciocina e age. Veja Modelos.

nnumbers-code — O modelo especializado em desenvolvimento: código, diffs, scripts, testes e depuração. Veja Modelos.

O​

Organização — O locatário do Imaginne. Define política, credenciais, usuários e skills; tudo o que você faz acontece no contexto dela. Veja Organizações & políticas.

outputs/ — A pasta de saída padrão do projeto, onde as skills gravam artefatos. Veja Arquivos & artefatos.

P​

Perfil — A entidade que liga skills a usuários. Sem um perfil com skills, o agente não recebe capacidades para você. Veja Administração → Perfis.

Platform — O plano de controle: identidade, política, relay de remote e console /app. Não fala com o provedor de modelo (isso é do Gateway). Veja Arquitetura.

Política — O conjunto de regras da organização que governa modelos, credenciais, skills, execução e conteúdo. Combina camadas com deny-wins. Veja Organizações & políticas e Governança.

R​

Remote (pareamento) — Conduzir a sua sessão local a partir de outra tela. O seu app é o runtime; a Platform só faz o relay. Pareamento por código efêmero de 30s. Veja Usar remotamente.

required_env — A lista de nomes de env-secrets que uma skill declara precisar. O Engine injeta somente esses nomes no processo da skill. Veja Env-secrets de skills.

Rotina — Uma tarefa recorrente, global do usuário, que roda enquanto o Desktop está aberto (agendador real). Distinta de Saved Prompts. Veja Rotinas.

S​

safe — O modo de execução mais restrito: sem strings de shell, operadores ou redirecionamento. Veja Autonomia & permissões.

Saved Prompt — Um prompt reutilizável, por projeto e somente manual ("Run Now"), sem agendamento. Distinto de Rotina. Veja Rotinas.

Sessão — Uma conversa contínua com o agente: histórico, ações e estado. Você a abre, fecha e retoma. Veja Sessões.

Skill — Uma capacidade que o agente usa quando relevante. Não é um comando (/x) nem uma menção de arquivo (@x). Origens: inclusas, publicadas pela org, pessoais/projeto. Veja Skills — visão geral.

Skill Studio — O editor e gerador conversacional de skills no console /app. Veja Criar uma skill.

skill_admin — O papel que gerencia as skills dos grupos sob sua administração. Veja Administração → Usuários & papéis.

Streaming — A entrega incremental da resposta do modelo, token a token, à medida que é gerada. Veja Sessões.

T​

Token — No sentido de identidade, veja Identidade; no sentido de unidade de texto do modelo, veja a janela de contexto em Sessões.

TUI — A interface de terminal (binário imaginne), com o Engine local. Veja Instalar a TUI e Usar a TUI.

V​

Verificador de conteúdo — A camada que redige padrões sensíveis conhecidos (e‑mails, documentos, cartões, tokens, chaves) antes de enviar o prompt ao modelo, sem registrar o texto em log. Veja Execução local.

VS Code (extensão) — A extensão nnumbers.imaginne, que usa o CLI imaginne serve por baixo. Veja Instalar no VS Code e Usar no VS Code.

W​

Workspace — A pasta de projeto que delimita onde o agente pode ler, escrever e executar por padrão. O cofre impõe esse limite. Veja Autonomia & permissões.

Próximos passos​