Rogue
O Agente Rogue atua como a orquestradora central e despachante (Message Broker) do ecossistema Jack-In Station. A seguir, detalho a origem do seu nome, seu papel arquitetural e o seu comportamento.
A Origem do Nome¶
O nome é inspirado no universo de Cyberpunk 2077, onde "Rogue" é a figura de uma das maiores fixers (despachantes/intermediárias) de Night City. A escolha do nome comunica perfeitamente o seu papel no sistema: ela não executa o trabalho bruto, mas conhece exatamente quem sabe executar. Arquiteturalmente, ela assume uma persona forte no ecossistema, coordenando a rede de execução de especialistas e distanciando-se de nomes místicos ou puramente de infraestrutura para reforçar sua posição de "operadora de rede".
O Papel da Rogue¶
A função primária da Rogue é responder à pergunta: "Quem deve agir agora?". Ela monitora o painel de trabalhos (Job Board), coordena a concorrência, despacha tarefas para os agentes apropriados e controla todo o ciclo de vida dos contratos no sistema.
Seu maior trunfo arquitetural é o uso de Roteamento Baseado em Capacidades (Capability-Based Routing). Em vez de a Rogue possuir um código rígido que diz "envie o comando de tabela para o Muninn", ela simplesmente pergunta ao sistema: "Preciso de alguém que execute a capacidade DESCRIBE_TABLE". O agente que anunciar essa capacidade em seu registro assumirá a tarefa. Isso elimina o acoplamento e permite que o sistema escale com múltiplos executores.
Ela atua para separar a decisão da rota, a execução técnica e a avaliação operacional, garantindo previsibilidade e facilidade de manutenção.
Seu Comportamento e Arquitetura¶
O comportamento da Rogue é estritamente procedural e orientado a contratos de estado, operando na primeira versão sem a necessidade de recorrer a LLMs. Sua arquitetura assíncrona gerencia fluxos publicando e consumindo do Job Board implementado em DuckDB, o que evita o travamento da interface com o usuário.
O comportamento de despacho da Rogue se divide em dois modos vitais:
1. Modo Comando Direto (Command Mode)
Se o usuário insere um comando iniciado por uma barra / (como /tabela Contrato ou /sql), a Rogue assume um controle determinístico e rigoroso. Ela trata o texto não como intenção, mas como sintaxe formal: valida a estrutura e despacha diretamente para o agente técnico responsável (como o Muninn). Este modo pula totalmente as camadas de Eirene e Pythia, garantindo uma resposta ágil e sem consumo de IA.
2. Modo Entrada Livre (Free Text Mode)
Quando o usuário digita uma pergunta ou intenção em linguagem natural (ex: "quero tabelas de contratos por cidade"), a Rogue aciona a "rota semântica". Ela envia o trabalho para a Eirene normalizar a intenção, depois submete a saída para a Pythia traçar a profecia da rota (ex: STRONG_PATH, SEMANTIC_DIRECTION), e, finalmente, a Rogue despacha o contrato para os agentes especialistas, como a Misty ou Huginn, conforme a decisão.
Pagamento e Avaliação (Scoring)
Ao longo do ciclo, quando um agente técnico pega uma tarefa (IN_PROGRESS) e a finaliza (COMPLETED), a Rogue retoma o controle para fechar o contrato (CLOSED). Nesse momento, ela age como uma auditora: ela avalia o resultado retornado pelo agente e o "paga" atribuindo-lhe um score de qualidade operacional (avaliando se a formatação estava válida, se a tarefa foi cumprida e a confiança do retorno). Esse score cria um histórico de reputação valioso para processos futuros de RAG.
