Visão Geral da Arquitetura

O Capellaris foi projetado com uma arquitetura modular que permite fácil adição de novos agentes e integração com diferentes sistemas. Cada componente tem uma função específica e se comunica de forma padronizada.

Diagrama de Arquitetura

graph TB
    subgraph Interface["🖥️ Interface do Usuário"]
        CHAT[Chat Platforms
Slack / Teams]
        API[API REST]
    end
    
    subgraph Core["⚙️ Núcleo do Sistema"]
        ROUTER[Roteador de
Mensagens]
        CONFIRM[Sistema de
Confirmação Humana]
        ORCH[Orquestrador
de Tarefas]
    end
    
    subgraph Agents["🤖 Agentes Especializados"]
        MKT[Marketing]
        FIN[Financeiro]
        DEV[Desenvolvimento]
        HR[RH]
        SALES[Vendas]
        OPS[Operações]
    end
    
    subgraph Learning["🧠 Sistema de Aprendizado"]
        KB[Base de
Conhecimento]
        ANALYZER[Analisador de
Padrões]
        OPTIMIZER[Otimizador de
Prompts]
    end
    
    CHAT --> ROUTER
    API --> ROUTER
    ROUTER --> CONFIRM
    CONFIRM --> ORCH
    ORCH --> MKT
    ORCH --> FIN
    ORCH --> DEV
    ORCH --> HR
    ORCH --> SALES
    ORCH --> OPS
    
    MKT --> KB
    FIN --> KB
    DEV --> KB
    KB --> ANALYZER
    ANALYZER --> OPTIMIZER
    OPTIMIZER --> ORCH
    
    style Interface fill:#e3f2fd
    style Core fill:#fff3e0
    style Agents fill:#e8f5e9
    style Learning fill:#f3e5f5

Modularidade

Componentes independentes com interfaces bem definidas, facilitando manutenção e extensão do sistema.

Escalabilidade

Arquitetura projetada para escalar horizontalmente, suportando múltiplos agentes e tarefas simultâneas.

Extensibilidade

Fácil adição de novos agentes e integrações sem modificar o núcleo do sistema.

Componentes Principais

Núcleo do Sistema

O cérebro central que coordena todas as operações. Gerencia o registro de agentes, orquestra a execução de tarefas e mantém o estado do sistema.

Responsabilidades:

Registro e gerenciamento de agentes
Coordenação de tarefas
Manutenção do estado global
Gerenciamento de configurações

Sistema de Comunicação

Gerencia a troca de mensagens entre agentes, baseado no protocolo A2A (Agent-to-Agent) do Google, garantindo comunicação padronizada e eficiente. 

sequenceDiagram
    participant U as Usuário
    participant R as Roteador
    participant A1 as Agente 1
    participant A2 as Agente 2
    
    U->>R: Envia solicitação
    R->>A1: Roteia mensagem
    A1->>A2: Solicita colaboração
    A2->>A1: Retorna resultado
    A1->>R: Resposta consolidada
    R->>U: Entrega resposta

Confirmação Humana

Sistema de segurança que garante que todas as ações dos agentes sejam aprovadas por um operador humano antes da execução. 

flowchart LR
    A[Tarefa Solicitada] --> B{Análise de Risco}
    B -->|Baixo| C[Aprovação Simples]
    B -->|Médio| D[Aprovação Gerente]
    B -->|Alto| E[Aprovação Diretoria]
    C --> F[Execução]
    D --> F
    E --> F
    F --> G[Relatório]

Tecnologias Utilizadas

Python

Linguagem principal

FastAPI

Framework web

PostgreSQL

Banco de dados

OpenAI GPT

Modelo de IA

Backend

  • Redis para cache
  • RabbitMQ para mensageria
  • Prometheus para monitoramento

Integração

  • APIs REST e GraphQL
  • OAuth 2.0 e JWT
  • Webhooks para chat