diff --git a/README.md b/README.md index 4bb58de..f97b5d9 100644 --- a/README.md +++ b/README.md @@ -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