docs: Atualiza README com contagem de agentes e links de documentação

This commit is contained in:
João Pedro Toledo Goncalves 2026-01-08 21:34:23 -03:00
parent cd5fa8e3d0
commit 948b00ee1c
1 changed files with 36 additions and 15 deletions

View File

@ -1,6 +1,6 @@
# 🧠 Antigravity Brain - Sistema de IA Corporativo # 🧠 Antigravity Brain - Sistema de IA Corporativo
Uma aplicação modular **CrewAI** com memória compartilhada, 26 agentes de IA especializados, e interface web powered by **Chainlit**. Uma aplicação modular **CrewAI** com memória compartilhada, 27 agentes de IA especializados, e interface web powered by **Chainlit**.
![Python](https://img.shields.io/badge/Python-3.11+-blue) ![Python](https://img.shields.io/badge/Python-3.11+-blue)
![CrewAI](https://img.shields.io/badge/CrewAI-0.80+-green) ![CrewAI](https://img.shields.io/badge/CrewAI-0.80+-green)
@ -9,13 +9,14 @@ Uma aplicação modular **CrewAI** com memória compartilhada, 26 agentes de IA
## 🚀 Funcionalidades ## 🚀 Funcionalidades
- **26 Agentes de IA Especializados** - De infraestrutura (Arthur Mendes, Gus Fring) a vendas (Ari Gold, Don Draper) até gestão de crises (Olivia Pope, Saul Goodman) - **27 Agentes de IA Especializados** - De infraestrutura (Arthur Mendes, Gus Fring) a vendas (Ari Gold, Don Draper) até gestão de crises (Olivia Pope, Saul Goodman) e especialistas técnicos (React Expert, Linus Torvalds).
- **Memória Híbrida Inteligente** - Combinação de banco vetorial (Qdrant) + grafo de relacionamentos (Neo4j) para busca semântica e contextualizada - **Memória Híbrida Inteligente** - Combinação de banco vetorial (Qdrant) + grafo de relacionamentos (Neo4j) para busca semântica e contextualizada.
- **Agentes Escolhem Estratégia de Busca** - Podem usar busca rápida (vetorial) ou busca contextualizada (vetor + relacionamentos) - **Agentes Escolhem Estratégia de Busca** - Podem usar busca rápida (vetorial) ou busca contextualizada (vetor + relacionamentos).
- **Roteamento Inteligente** - Classificação automática de solicitações para a equipe apropriada - **Roteamento Inteligente** - Classificação automática de solicitações para a equipe apropriada.
- **Suporte Multi-Provedor LLM** - Funciona com Gemini, OpenAI, Anthropic, ou Ollama local - **Integração Multi-Plataforma** - Interface Web via Chainlit e suporte a Bot de Telegram.
- **Interface Web** - Interface de chat moderna powered by Chainlit - **Suporte Multi-Provedor LLM** - Funciona com Gemini, OpenAI, Anthropic, ou Ollama local.
- **Pronto para Docker** - Deploy com um único comando via docker-compose - **Base de Conhecimento Padronizada** - Protocolos rigorosos para código, vendas, segurança e operações.
- **Pronto para Docker** - Deploy com um único comando via docker-compose.
## 📁 Estrutura do Projeto ## 📁 Estrutura do Projeto
@ -27,22 +28,40 @@ minions-da-itguys/
│ ├── router.py # Roteamento inteligente de requisições │ ├── router.py # Roteamento inteligente de requisições
│ ├── agents/ │ ├── agents/
│ │ ├── factory.py # Instanciação de agentes │ │ ├── factory.py # Instanciação de agentes
│ │ └── personas/ # 26 arquivos de personalidade (.md) │ │ └── personas/ # 27 arquivos de personalidade (.md)
│ ├── crews/ │ ├── crews/
│ │ └── definitions.py # Lógica de montagem de crews │ │ └── definitions.py # Lógica de montagem de crews
│ ├── knowledge/ │ ├── knowledge/
│ │ └── standards/ # Base de conhecimento corporativo │ │ ├── dynamic/ # Conhecimento dinâmico gerado
│ │ └── standards/ # +20 arquivos de padrões (Vendas, Zabbix, Segurança, etc.)
│ ├── memory/ │ ├── memory/
│ │ ├── wrapper.py # Integração Mem0 + busca híbrida │ │ ├── wrapper.py # Integração Mem0 + busca híbrida
│ │ ├── graph_wrapper.py # Gerenciamento de relacionamentos Neo4j │ │ ├── graph_wrapper.py # Gerenciamento de relacionamentos Neo4j
│ │ └── entity_search_tool.py # Busca por entidades específicas │ │ └── entity_search_tool.py # Busca por entidades específicas
│ └── tools/ # Ferramentas customizadas (Zabbix, Evolution, etc.) │ ├── tools/ # Ferramentas customizadas (Zabbix, Evolution, etc.)
│ └── integrations/
│ └── telegram_bot.py # Interface de Bot Telegram
├── docs/ # Documentação detalhada do sistema
│ ├── AGENT_CATALOG.md # Catálogo completo dos agentes
│ ├── AI_AGENT_PROTOCOL.md # Protocolo de comportamento dos agentes
│ ├── DEVELOPER_GUIDE.md # Guia para desenvolvedores
│ └── ...
├── docker-compose.yml # Orquestração de containers ├── docker-compose.yml # Orquestração de containers
├── Dockerfile # Container da aplicação ├── Dockerfile # Container da aplicação
├── requirements.txt # Dependências Python ├── requirements.txt # Dependências Python
└── .env # Chaves de API & configuração └── .env # Chaves de API & configuração
``` ```
## 📚 Documentação Estendida
Explore a pasta `docs/` para detalhes aprofundados:
- [**Catálogo de Agentes**](docs/AGENT_CATALOG.md): Lista completa de personas, suas skills e propósitos.
- [**Protocolo IA**](docs/AI_AGENT_PROTOCOL.md): Diretrizes éticas e operacionais para os agentes.
- [**Guia do Desenvolvedor**](docs/DEVELOPER_GUIDE.md): Arquitetura, padrões de código e fluxos de contribuição.
- [**Troubleshooting**](docs/TROUBLESHOOTING.md): Solução de problemas comuns.
- [**Padrões (Standards)**](src/knowledge/standards/): Consulte os arquivos em `src/knowledge/standards/` para diretrizes específicas de cada domínio (Sales, DevOps, Security, etc.).
## 🛠️ Instalação ## 🛠️ Instalação
### Pré-requisitos ### Pré-requisitos
@ -54,7 +73,7 @@ minions-da-itguys/
```bash ```bash
# 1. Clone o repositório # 1. Clone o repositório
git clone https://github.com/your-org/minions-da-itguys.git git clone https://git.itguys.com.br/joao.goncalves/minions-ai-agents.git
cd minions-da-itguys cd minions-da-itguys
# 2. Configure o ambiente # 2. Configure o ambiente
@ -99,9 +118,9 @@ NEO4J_USER=neo4j
NEO4J_PASSWORD=antigravity2024 NEO4J_PASSWORD=antigravity2024
``` ```
## 🤖 Crews Disponíveis ## 🤖 Crews Disponíveis (Exemplos)
| Crew | Agentes | Propósito | | Crew | Agentes Principais | Propósito |
|------|---------|-----------| |------|---------|-----------|
| **Engenharia de Infra** | Arthur Mendes, Gus Fring | Templates Zabbix, monitoramento | | **Engenharia de Infra** | Arthur Mendes, Gus Fring | Templates Zabbix, monitoramento |
| **Auditoria de Segurança** | Elliot Alderson, Devil | Avaliação de vulnerabilidades | | **Auditoria de Segurança** | Elliot Alderson, Devil | Avaliação de vulnerabilidades |
@ -109,6 +128,8 @@ NEO4J_PASSWORD=antigravity2024
| **Crescimento de Vendas** | Ari Gold, Chris Gardner, Don Draper | Gestão de pipeline | | **Crescimento de Vendas** | Ari Gold, Chris Gardner, Don Draper | Gestão de pipeline |
| **Estratégia de Negócios** | Harvey Specter, Kevin O'Leary | Compliance, análise de ROI | | **Estratégia de Negócios** | Harvey Specter, Kevin O'Leary | Compliance, análise de ROI |
> *Veja a lista completa em [docs/AGENT_CATALOG.md](docs/AGENT_CATALOG.md)*
## 🧪 Exemplos de Uso ## 🧪 Exemplos de Uso
``` ```
@ -125,7 +146,7 @@ Usuário: "Analise a segurança da nossa página de login"
→ Elliot realiza reconhecimento → Elliot realiza reconhecimento
``` ```
## 📦 Dependências ## 📦 Dependências Principais
- `crewai` - Orquestração multi-agente - `crewai` - Orquestração multi-agente
- `chainlit` - Interface Web - `chainlit` - Interface Web