Celestial Observer

O acesso ao Celestial Observer é restrito a operadores autorizados pelo administrador do tenant. O console aceita autenticação via Firebase (e-mail e senha) ou por provedores OIDC corporativos configurados na infraestrutura do cliente. Cada sessão fica vinculada criptograficamente às claims de identidade do operador.

Fluxo de autenticação. Informe o e-mail corporativo e a senha fornecidos pelo administrador do tenant. No primeiro acesso, o sistema exige uma troca obrigatória de senha. Após a autenticação, as permissões da interface são montadas dinamicamente a partir das custom claims do Firebase do usuário: a interface exibe apenas as abas e as ações para as quais você tem autorização.

O Command Center (Central de comando) é a página inicial do dashboard, orientada a tarefas. Ele oferece uma visão em tempo real das operações da sua plataforma de IA e destaca cards de ação proativos para as tarefas que exigem a sua atenção.

A interface é dividida em duas áreas principais. O Status Grid mostra cinco indicadores de alto nível: status da conexão, saúde do agente, atualização da telemetria, saúde da Wiki e prontidão para inspeção. O Action Grid oferece atalhos para os fluxos de trabalho mais comuns, como investigar traces, revisar alterações na Wiki, redigir alterações governadas, sincronizar a Wiki e consultar logs.

A aba System Health (saúde do sistema) apresenta métricas operacionais e a análise de tráfego do agente de IA em tempo real. É a visão principal para acompanhar o desempenho da plataforma e diagnosticar aumentos de latência ou da taxa de erros.

Métricas principais. Os cards de indicadores no topo exibem Total Requests, Token Volume, Avg Latency e Success Rate para o período selecionado. O grande gráfico de área Traffic Analysis mostra esses dados ao longo do tempo, o que permite identificar picos e anomalias.

Service Pulse. O painel à direita monitora a saúde de cada subsistema (API Gateway, LLM Inference, RAG Service, Vector DB etc.). Um ponto verde pulsante indica que o serviço está saudável, o âmbar indica latência elevada ou timeouts, e o vermelho indica uma falha.

A aba User Analytics (análise de usuários) oferece uma trilha de auditoria das interações dos usuários finais com a plataforma de IA. Com ela, os operadores acompanham a adoção, identificam os usuários de maior volume e investigam problemas específicos de cada usuário.

A tabela User Interaction Audit lista os usuários por identidade (e-mail ou ID de usuário), com o volume total de requisições, o consumo de tokens e o horário da última atividade. Ao clicar em qualquer linha, abre-se um painel de detalhes com o histórico completo de sessões daquele usuário. A tabela pode ser ordenada por qualquer coluna e filtrada por e-mail ou ID de usuário.

Nas implantações que usam a integração com a Meta Cloud API, esta aba oferece telemetria omnichannel dedicada. Ela acompanha o volume de mensagens recebidas e enviadas, o status de entrega, o consumo de tokens específico do canal e os custos estimados.

O Connection Card, no canto superior esquerdo, mostra o provedor atual, o Phone Number ID, a WABA, o modo, o limite diário, o modelo de cobrança e a janela de resposta. O gráfico de área Message Flow mostra o volume recebido e enviado ao longo do tempo. O painel Delivery Status separa as mensagens por status: Delivered, Read, Failed e Pending. Na tabela Message Events, na parte inferior, clique em Open para abrir o Flight Recorder de qualquer mensagem específica do WhatsApp.

O Wiki Workspace é o centro da governança do conhecimento do agente. Toda regra de negócio, FAQ, política e configuração de ferramenta que o agente usa em produção é gerenciada aqui, com versionamento completo em Git e rastreabilidade de autoria.

Cabeçalho do workspace. A faixa superior mostra o estado atual do repositório. Os badges indicam se o workspace está Ready, Unsaved ou Review Pending. O botão Sync Wiki envia as alterações aprovadas para o agente em runtime. O botão Refresh busca novamente o estado mais recente no repositório remoto.

Editor TinaCMS. A interface principal de edição usa uma instância incorporada do TinaCMS, que permite editar arquivos Markdown com controles visuais de frontmatter. A barra lateral esquerda mostra a árvore de arquivos do repositório (por exemplo, content/policies, prompts, tools). Confira se o frontmatter YAML está válido antes de salvar.

Saúde e integridade da Wiki. O painel à direita monitora continuamente a saúde da conexão com a Wiki. Git Sync verifica se a sessão local do TinaCMS está sincronizada com o repositório Git remoto. Tina Session confirma que a sessão de autenticação está ativa. Document Count exibe o total de documentos indexados em todas as coleções.

O Wiki Copilot é um assistente de IA criado para ajudar os operadores a redigir, validar e preparar com segurança alterações na base de conhecimento do agente. Ele aplica as regras de governança e garante que as alterações sigam o schema correto antes que possam passar por merge.

Todas as alterações na Wiki, sejam propostas por operadores via Copilot ou geradas pelo agente como Memory Candidates, precisam passar pela Review Queue (fila de revisão) antes de se tornarem memória institucional oficial. Esse é o firewall de governança que impede que erros gerados por IA corrompam a base de conhecimento.

Review Pending. Exibe os Pull Requests ativos. Você pode revisar o nome do branch, o caminho do documento e o hash do head commit. As ações disponíveis são Approve, Merge & Sync e Close. Aprovar um PR não o sincroniza automaticamente com o agente em produção: também é preciso clicar em Merge & Sync.

Memory Candidates. São possíveis itens de memória de longo prazo, identificados automaticamente pelo agente durante as interações em runtime. Operadores com a claim wiki.approver precisam aprovar (Approve) ou rejeitar (Reject) explicitamente cada candidato. Os candidatos aprovados são gravados na Wiki como conhecimento governado. Esse fluxo rompe o ciclo de feedback negativo descrito na spec Institutional Memory Governance.

O Aura Flight Recorder v2 é o instrumento de trace profundo do Celestial Observer. Ele captura um registro de órbita completo e imutável que mostra exatamente como o agente de IA processou uma transação específica, do sinal de intenção inicial até a saída final, passando por cada invocação de ferramenta e cada sequência cognitiva do LLM.

Barra de KPIs. O cabeçalho do modal exibe o Transaction ID e o status geral do trace. A barra de KPIs traz métricas rápidas: LLM CORE, o modelo usado (por exemplo, gpt-4o); RUNTIME, o tempo total de execução; TOKEN_LOAD, o total de tokens consumidos; OBJECTS_GEN, os objetos estruturados gerados; NETWORK_OPS, as chamadas externas a ferramentas e APIs.

Aba Flow (Visual). Esta aba mostra o pipeline de execução do agente em ordem cronológica. Ela começa pelo User Intent Input e por qualquer feedback associado. Logo abaixo, o Agent Execution Pipeline exibe a sequência de invocações de ferramentas. Cada card de etapa mostra o nome da ferramenta, a duração, os argumentos exatos de prompt enviados à ferramenta e o resultado operacional retornado. É a visão principal para entender por que o agente tomou determinada ação.

Aba Brain (LLM). Esta aba expõe o processo cognitivo bruto do LLM. A coluna da esquerda lista o Cognitive Sequence Index: cada chamada de inferência feita durante a transação, com o respectivo timestamp e a contagem de tokens. Ao selecionar uma etapa, você vê a Cognitive Injection exata (o system prompt completo, o contexto e os dados do usuário enviados ao modelo) e o Model Response Output. É a visão definitiva para depurar alucinações, problemas de prompt injection ou comportamentos inesperados do modelo.

O Audit Trail (trilha de auditoria) mantém um registro imutável de eventos de segurança, ações administrativas e acessos a dados em toda a plataforma. É a camada de compliance e de perícia forense do Celestial Observer.

Os eventos são classificados por severidade (INFO, WARN, ERROR) e por tipo (AUTH, ADMIN, DATA_ACCESS). Cada registro inclui o ID do usuário, o endereço IP mascarado e os detalhes específicos da ação. O gráfico Audit Distribution, à direita, mostra a distribuição dos tipos de evento no período selecionado. O painel Sign-In Configuration mostra o provedor de autenticação ativo e o status da sua conexão.

O modal Settings (Configurações) é o hub de configuração do dashboard. Ele fica acessível pela barra lateral e reúne todas as opções de configuração da plataforma.