Vincent Jiang
12 KiB
English | 简体中文 | Español | Português | 日本語 | Русский
Visão Geral
Construa agentes de IA confiáveis e auto-aperfeiçoáveis sem codificar fluxos de trabalho. Defina seu objetivo através de uma conversa com um agente de codificação, e o framework gera um grafo de nós com código de conexão criado dinamicamente. Quando algo quebra, o framework captura dados de falha, evolui o agente através do agente de codificação e reimplanta. Nós de intervenção humana integrados, gerenciamento de credenciais e monitoramento em tempo real dão a você controle sem sacrificar a adaptabilidade.
Visite adenhq.com para documentação completa, exemplos e guias.
O que é Aden
Aden é uma plataforma para construir, implantar, operar e adaptar agentes de IA:
- Construir - Um Agente de Codificação gera Agentes de Trabalho especializados (Vendas, Marketing, Operações) a partir de objetivos em linguagem natural
- Implantar - Implantação headless com integração CI/CD e gerenciamento completo do ciclo de vida de API
- Operar - Monitoramento em tempo real, observabilidade e guardrails de runtime mantêm os agentes confiáveis
- Adaptar - Avaliação contínua, supervisão e adaptação garantem que os agentes melhorem ao longo do tempo
- Infraestrutura - Memória compartilhada, integrações LLM, ferramentas e habilidades alimentam cada agente
Links Rápidos
- Documentação - Guias completos e referência de API
- Guia de Auto-Hospedagem - Implante o Hive em sua infraestrutura
- Changelog - Últimas atualizações e versões
- Reportar Problemas - Relatórios de bugs e solicitações de funcionalidades
Início Rápido
Pré-requisitos
- Docker (v20.10+)
- Docker Compose (v2.0+)
Instalação
# Clonar o repositório
git clone https://github.com/adenhq/hive.git
cd hive
# Copiar e configurar
cp config.yaml.example config.yaml
# Executar configuração e iniciar serviços
npm run setup
docker compose up
Acessar a aplicação:
- Dashboard: http://localhost:3000
- API: http://localhost:4000
- Health: http://localhost:4000/health
Funcionalidades
- Desenvolvimento Orientado a Objetivos - Defina objetivos em linguagem natural; o agente de codificação gera o grafo de agentes e código de conexão para alcançá-los
- Agentes Auto-Adaptáveis - Framework captura falhas, atualiza objetivos e atualiza o grafo de agentes
- Conexões de Nós Dinâmicas - Sem arestas predefinidas; código de conexão é gerado por qualquer LLM capaz baseado em seus objetivos
- Nós Envolvidos em SDK - Cada nó recebe memória compartilhada, memória RLM local, monitoramento, ferramentas e acesso LLM prontos para uso
- Humano no Loop - Nós de intervenção que pausam a execução para entrada humana com timeouts e escalonamento configuráveis
- Observabilidade em Tempo Real - Streaming WebSocket para monitoramento ao vivo de execução de agentes, decisões e comunicação entre nós
- Controle de Custo e Orçamento - Defina limites de gastos, throttles e políticas de degradação automática de modelo
- Pronto para Produção - Auto-hospedável, construído para escala e confiabilidade
Por que Aden
Frameworks de agentes tradicionais exigem que você projete manualmente fluxos de trabalho, defina interações de agentes e lide com falhas reativamente. Aden inverte esse paradigma—você descreve resultados, e o sistema se constrói sozinho.
A Vantagem Aden
| Frameworks Tradicionais | Aden |
|---|---|
| Codificar fluxos de trabalho de agentes | Descrever objetivos em linguagem natural |
| Definição manual de grafos | Grafos de agentes auto-gerados |
| Tratamento reativo de erros | Auto-evolução proativa |
| Configurações de ferramentas estáticas | Nós dinâmicos envolvidos em SDK |
| Configuração de monitoramento separada | Observabilidade em tempo real integrada |
| Gerenciamento de orçamento DIY | Controles de custo e degradação integrados |
Como Funciona
- Defina Seu Objetivo → Descreva o que você quer alcançar em português simples
- Agente de Codificação Gera → Cria o grafo de agentes, código de conexão e casos de teste
- Workers Executam → Nós envolvidos em SDK executam com observabilidade completa e acesso a ferramentas
- Plano de Controle Monitora → Métricas em tempo real, aplicação de orçamento, gerenciamento de políticas
- Auto-Aperfeiçoamento → Em caso de falha, o sistema evolui o grafo e reimplanta automaticamente
Estrutura do Projeto
hive/
├── honeycomb/ # Frontend (React + TypeScript + Vite)
├── hive/ # Backend (Node.js + TypeScript + Express)
├── docs/ # Documentação
├── scripts/ # Scripts de build e utilitários
├── config.yaml.example # Template de configuração
└── docker-compose.yml # Orquestração de containers
Desenvolvimento
Desenvolvimento Local com Hot Reload
# Copiar overrides de desenvolvimento
cp docker-compose.override.yml.example docker-compose.override.yml
# Iniciar com hot reload habilitado
docker compose up
Executar Sem Docker
# Instalar dependências
npm install
# Gerar arquivos de ambiente
npm run generate:env
# Iniciar frontend (em honeycomb/)
cd honeycomb && npm run dev
# Iniciar backend (em hive/)
cd hive && npm run dev
Documentação
- Guia do Desenvolvedor - Guia abrangente para desenvolvedores
- Começando - Instruções de configuração rápida
- Guia de Configuração - Todas as opções de configuração
- Visão Geral da Arquitetura - Design e estrutura do sistema
Roadmap
O Aden Agent Framework visa ajudar desenvolvedores a construir agentes auto-adaptativos orientados a resultados. Encontre nosso roadmap aqui:
Comunidade e Suporte
Usamos Discord para suporte, solicitações de funcionalidades e discussões da comunidade.
- Discord - Junte-se à nossa comunidade
- Twitter/X - @adenhq
- LinkedIn - Página da Empresa
Contribuindo
Aceitamos contribuições! Por favor, consulte CONTRIBUTING.md para diretrizes.
- Faça fork do repositório
- Crie sua branch de funcionalidade (
git checkout -b feature/amazing-feature) - Faça commit das suas alterações (
git commit -m 'Add amazing feature') - Faça push para a branch (
git push origin feature/amazing-feature) - Abra um Pull Request
Junte-se ao Nosso Time
Estamos contratando! Junte-se a nós em funções de engenharia, pesquisa e go-to-market.
Segurança
Para questões de segurança, por favor consulte SECURITY.md.
Licença
Este projeto está licenciado sob a Licença Apache 2.0 - veja o arquivo LICENSE para detalhes.
Perguntas Frequentes (FAQ)
P: O Aden depende do LangChain ou outros frameworks de agentes?
Não. O Aden é construído do zero sem dependências do LangChain, CrewAI ou outros frameworks de agentes. O framework é projetado para ser leve e flexível, gerando grafos de agentes dinamicamente em vez de depender de componentes predefinidos.
P: Quais provedores de LLM o Aden suporta?
O Aden suporta OpenAI (GPT-4, GPT-4o), Anthropic (modelos Claude) e Google Gemini prontos para uso. A arquitetura é agnóstica de provedor através da abstração do SDK, com integração LiteLLM no roadmap para suporte expandido de modelos.
P: O Aden é open-source?
Sim, o Aden é totalmente open-source sob a Licença Apache 2.0. Incentivamos ativamente contribuições e colaboração da comunidade.
P: Quais opções de implantação o Aden suporta?
O Aden suporta implantação Docker Compose pronta para uso, com configurações de produção e desenvolvimento. Implantações auto-hospedadas funcionam em qualquer infraestrutura que suporte Docker. Opções de implantação em nuvem e configurações prontas para Kubernetes estão no roadmap.
P: O Aden pode lidar com casos de uso complexos em escala de produção?
Sim. O Aden é explicitamente projetado para ambientes de produção com recursos como recuperação automática de falhas, observabilidade em tempo real, controles de custo e suporte a escalonamento horizontal. O framework lida tanto com automações simples quanto com fluxos de trabalho complexos multi-agente.
P: O Aden suporta fluxos de trabalho com humano no loop?
Sim, o Aden suporta totalmente fluxos de trabalho com humano no loop através de nós de intervenção que pausam a execução para entrada humana. Estes incluem timeouts configuráveis e políticas de escalonamento, permitindo colaboração perfeita entre especialistas humanos e agentes de IA.
P: Como posso contribuir para o Aden?
Contribuições são bem-vindas! Faça fork do repositório, crie sua branch de funcionalidade, implemente suas alterações e envie um pull request. Consulte CONTRIBUTING.md para diretrizes detalhadas.
Feito com 🔥 Paixão em San Francisco