# 📚 Wiki Avançada - Mangaba AI

Bem-vindo à Wiki Avançada do **Mangaba AI**, sua documentação completa para criação de agentes de IA inteligentes e versáteis com protocolos **A2A** (Agent-to-Agent) e **MCP** (Model Context Protocol).

## 🗺️ Navegação da Wiki

### 🚀 Para Iniciantes
- **[📖 Visão Geral do Projeto](visao-geral.md)** - Entenda o que é o Mangaba AI
- **[⚙️ Instalação e Configuração](instalacao-configuracao.md)** - Configure seu ambiente
- **[🎯 Primeiros Passos](primeiros-passos.md)** - Seu primeiro agente AI

### 🔧 Para Desenvolvedores
- **[🌐 Exemplos dos Protocolos](exemplos-protocolos.md)** - A2A e MCP na prática
- **[✨ Melhores Práticas](melhores-praticas.md)** - Como criar agentes eficientes
- **[🏗️ Arquitetura Avançada](arquitetura-avancada.md)** - Estrutura interna do sistema

### 🤝 Comunidade
- **[🤲 Diretrizes de Contribuição](contribuicao.md)** - Como contribuir
- **[❓ Perguntas Frequentes (FAQ)](faq.md)** - Soluções para problemas comuns
- **[📝 Glossário](glossario.md)** - Termos técnicos explicados

## 🎯 O que Você Vai Aprender

### Conceitos Fundamentais
- **Agentes de IA**: Como criar e gerenciar agentes inteligentes
- **Protocolo A2A**: Comunicação entre múltiplos agentes
- **Protocolo MCP**: Gerenciamento avançado de contexto
- **Integração**: Como integrar com sistemas existentes

### Casos de Uso Práticos
- 🏢 **Automação Empresarial**: Agentes para processos corporativos
- 📊 **Análise de Dados**: IA para insights avançados
- 🗣️ **Assistentes Conversacionais**: Chatbots inteligentes
- 🔄 **Workflows Automatizados**: Processos end-to-end

### Recursos Avançados
- 🔌 **Integrações**: APIs, bancos de dados, serviços externos
- 📈 **Monitoramento**: Logs, métricas e performance
- 🛡️ **Segurança**: Boas práticas e proteção de dados
- 🚀 **Deploy**: Produção e escalabilidade

## 🚨 Antes de Começar

### Pré-requisitos
- **Python 3.8+** instalado no sistema
- **Conhecimento básico** em Python
- **Conta Google AI** para acesso às APIs
- **Editor de código** de sua preferência

### Configuração Mínima
```bash
# 1. Clone o repositório
git clone https://github.com/Mangaba-ai/mangaba_ai.git
cd mangaba_ai

# 2. Instale as dependências
pip install -r requirements.txt

# 3. Configure sua API key
cp .env.template .env
# Edite o arquivo .env com suas configurações
```

## 📚 Estrutura da Documentação

```
wiki/
├── README.md                    # Esta página principal
├── visao-geral.md              # Visão geral do projeto
├── instalacao-configuracao.md  # Guia de instalação
├── primeiros-passos.md         # Tutorial para iniciantes
├── exemplos-protocolos.md      # Exemplos A2A e MCP
├── melhores-praticas.md        # Boas práticas
├── arquitetura-avancada.md     # Arquitetura do sistema
├── contribuicao.md             # Como contribuir
├── faq.md                      # Perguntas frequentes
└── glossario.md                # Glossário técnico
```

## 🔗 Links Úteis

- **[📁 Repositório Principal](../README.md)** - README do projeto
- **[🗂️ Estrutura do Projeto](../ESTRUTURA.md)** - Organização dos arquivos
- **[📋 Índice Geral](../INDICE.md)** - Navegação completa
- **[📖 Exemplos Práticos](../examples/)** - Código de exemplo
- **[🧪 Testes](../tests/)** - Suite de testes

## 🆘 Precisa de Ajuda?

1. **Consulte o [FAQ](faq.md)** para soluções rápidas
2. **Leia o [Glossário](glossario.md)** para entender termos técnicos
3. **Veja os [Exemplos](exemplos-protocolos.md)** para casos práticos
4. **Abra uma [Issue](https://github.com/Mangaba-ai/mangaba_ai/issues)** no GitHub

---

> 💡 **Dica**: Esta wiki é um complemento à documentação existente. Para uma visão geral rápida, consulte o [README principal](../README.md).

> 🚀 **Começando Agora**: Se você é iniciante, comece pela [Visão Geral](visao-geral.md) e depois vá para [Instalação](instalacao-configuracao.md).