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
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)
![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
- **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)
- **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)
- **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
- **Interface Web** - Interface de chat moderna powered by Chainlit
- **Pronto para Docker** - Deploy com um único comando via docker-compose
- **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.
- **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.
- **Integração Multi-Plataforma** - Interface Web via Chainlit e suporte a Bot de Telegram.
- **Suporte Multi-Provedor LLM** - Funciona com Gemini, OpenAI, Anthropic, ou Ollama local.
- **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
@ -27,22 +28,40 @@ minions-da-itguys/
│ ├── router.py # Roteamento inteligente de requisições
│ ├── agents/
│ │ ├── factory.py # Instanciação de agentes
│ │ └── personas/ # 26 arquivos de personalidade (.md)
│ │ └── personas/ # 27 arquivos de personalidade (.md)
│ ├── crews/
│ │ └── definitions.py # Lógica de montagem de crews
│ ├── knowledge/
│ │ └── standards/ # Base de conhecimento corporativo
│ │ ├── dynamic/ # Conhecimento dinâmico gerado
│ │ └── standards/ # +20 arquivos de padrões (Vendas, Zabbix, Segurança, etc.)
│ ├── memory/
│ │ ├── wrapper.py # Integração Mem0 + busca híbrida
│ │ ├── graph_wrapper.py # Gerenciamento de relacionamentos Neo4j
│ │ └── 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
├── Dockerfile # Container da aplicação
├── requirements.txt # Dependências Python
└── .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
### Pré-requisitos
@ -54,7 +73,7 @@ minions-da-itguys/
```bash
# 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
# 2. Configure o ambiente
@ -99,9 +118,9 @@ NEO4J_USER=neo4j
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 |
| **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 |
| **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
```
@ -125,7 +146,7 @@ Usuário: "Analise a segurança da nossa página de login"
→ Elliot realiza reconhecimento
```
## 📦 Dependências
## 📦 Dependências Principais
- `crewai` - Orquestração multi-agente
- `chainlit` - Interface Web