kalumba1829/executive-ai-core

O que executive-ai-core faz?

Construa um agente executivo de IA mínimo em Python com código totalmente comentado para aprendizado, ensino e desenvolvedores iniciantes.

Visão Geral

Esta skill fornece uma implementação de referência de um agente executivo de IA em Python. O agente executivo atua como um orquestrador, que recebe tarefas complexas e as delega a agentes especializados, unificando as respostas em um relatório executivo coeso. O código é extensivamente comentado, explicando cada conceito e decisão de design, ideal para quem está aprendendo sobre arquiteturas de agentes de IA.

Funcionalidades

• Agente Executivo: Orquestra múltiplos agentes especializados.
• Agentes Especializados: Exemplos incluem PesquisaAgent (para pesquisa web) e CodeAgent (para geração de código).
• Loop de Raciocínio: Loop simples baseado em prompt para planejamento e execução.
• Código Comentado: Cada função e classe possui comentários detalhados em português.
• Fácil de Estender: Adicione novos agentes especializados com pouco esforço.

Plataformas Suportadas

• Claude Code
• Cursor
• Codex
• Terminal (execução direta do Python)

Como Usar

1. Clone o repositório:

git clone https://github.com/kalumba1829/executive-ai-core.git
cd executive-ai-core

2. Execute o agente:

python executive_agent.py

3. Siga as instruções no terminal para fornecer uma tarefa.

Estrutura do Código

executive-ai-core/
├── executive_agent.py      # Classe principal do agente executivo
├── agents/                 # Diretório com agentes especializados
│   ├── __init__.py
│   ├── research_agent.py   # Agente de pesquisa
│   └── code_agent.py       # Agente de código
├── utils/                  # Utilitários
│   ├── __init__.py
│   └── helpers.py
└── README.md               # Este arquivo

Exemplo de Uso

from executive_agent import ExecutiveAgent
from agents.research_agent import ResearchAgent
from agents.code_agent import CodeAgent

# Criar o agente executivo
executive = ExecutiveAgent()

# Registrar agentes especializados
executive.register_agent("pesquisa", ResearchAgent())
executive.register_agent("codigo", CodeAgent())

# Executar uma tarefa
tarefa = "Crie um script Python que baixe dados da API do GitHub"
resultado = executive.execute(tarefa)
print(resultado)

Licença

MIT