Administração — visão geral

O console de administração vive em /app e é onde você governa a sua organização no Imaginne: usuários e papéis, perfis, grupos de skills, o catálogo de skills, políticas, credenciais (BYOK e env-secrets), templates, integrações e o log de auditoria.

Quem entra e para onde vai

O acesso ao console é exclusivamente por login no navegador — o mesmo da identidade que vale para todas as superfícies. Não existe criação de senha local nem de chave de API: você entra, o navegador autentica, e a sessão é vinculada à sua organização.

O destino logo após o login depende do seu papel:

Papel	Destino	O que administra
Administrador da organização (org_admin)	/org	Tudo: usuários, perfis, grupos, skills, políticas, BYOK, env-secrets, templates, integrações, auditoria.
Administrador de skills (skill_admin)	/skill-admin	Apenas as skills dos grupos sob sua responsabilidade (My Groups).
Usuário (member)	/chat	Não administra; vai direto para o chat.

O org_admin também precisa de um perfil para usar o chat

Administrar a organização e usar o agente são coisas separadas. Um administrador sem perfil atribuído abre o chat sem nenhuma skill. Atribua um perfil a si mesmo se quiser usar as superfícies de chat. Veja o aviso de "sem perfil" mais abaixo.

Navegação lateral

A barra lateral do console agrupa as áreas de administração. Cada item leva à sua página:

Item	Rota	Para que serve
Dashboard	/org	Visão geral com contadores e atividade recente.
Usuários	/org/users	Lista de usuários, criação e gestão de papéis.
Perfis	/org/profiles	Ligam skills a usuários.
Grupos de skills	/org/skill-groups	Organizam skills e delegam administração.
Skills	/org/skills	Catálogo de skills da organização.
Governança	/org/governance	Editor de políticas e simulador.
BYOK	/org/byok	Chaves de modelo da própria organização.
Env-secrets	/org/env-secrets	Segredos injetados em skills.
Templates	/org/templates	Templates DOCX/PPTX da organização.
Integrações	/org/integrations	Conexões com Slack, Google, Atlassian.
Auditoria	/org/audit	Log de ações administrativas.

As rotas são internas do console

A tabela acima mostra os caminhos reais dentro de /app para orientação. A documentação sempre linka para as páginas explicativas de cada área (por exemplo, Usuários & papéis).

O Dashboard

A página inicial (/org) dá uma leitura rápida do estado da organização. Ela reúne:

• Cartões de contadores — Usuários, Perfis, Grupos de skills e Skills. Cada cartão mostra o total atual e leva à listagem correspondente.
• Atividade recente — os últimos eventos administrativos (criação de usuário, publicação de skill, alteração de perfil, etc.), uma amostra do log de auditoria.
• Aviso de "sem perfil" — quando você, administrador, não tem nenhum perfil atribuído, o Dashboard exibe um aviso explicando que o chat abrirá vazio até que você se atribua um perfil.

Sem perfil, o chat abre vazio

O conjunto de skills que aparece na sua sessão é a união dos skills dos perfis atribuídos a você. Sem perfil — inclusive para administradores — nenhuma skill entra na conversa. Esse é o motivo do aviso no Dashboard.

O que o console não tem

Para evitar expectativas erradas, é importante deixar claro o que está fora do escopo deste console:

• Não há tela de uso ou faturamento (billing). A visibilidade que o administrador da organização tem sobre atividade se resume aos cartões do Dashboard e ao log de auditoria. Métricas de consumo detalhadas e cobrança não são expostas aqui.
• Não há criação de chaves de API. O acesso é somente pelo login no navegador. Criar um usuário não gera senha nem chave — o usuário recebe um e-mail para definir a própria senha. Veja Usuários & papéis.
• Não há configuração de infraestrutura. Servidores, deploy e rede são responsabilidade da plataforma, não deste console.

Por onde começar

Se a organização é nova, um caminho comum é: criar usuários → criar grupos de skills → publicar/importar skills → criar perfis ligando skills a usuários → ajustar a política e, se for o caso, configurar BYOK e env-secrets.

Áreas do console

👥Usuários & papéis

Criar usuários, definir papéis e overrides de execução.

Abrir →🎭Perfis

Ligar skills a pessoas. Sem perfil, o chat abre vazio.

Abrir →🗂️Grupos de skills

Organizar skills e delegar ao administrador de skills.

Abrir →🧠Skills (governança)

O catálogo de skills da organização: criar, importar, versionar.

Abrir →📜Governança & políticas

O editor de regras e o simulador de política.

Abrir →🔑BYOK

Usar as chaves de modelo da própria organização.

Abrir →🔐Env-secrets

Segredos injetados nas skills que os declaram.

Abrir →📄Templates

Templates DOCX/PPTX padrão da organização.

Abrir →🔌Integrações

Conectar Slack, Google Workspace e Atlassian.

Abrir →📒Auditoria

O registro de ações administrativas.

Abrir →

Próximos passos

• Usuários & papéis
• Governança & políticas
• Auditoria