使用说明
ECHO-行政协调和分级组织
一种基于人工智能的组织模型,其中基于角色的自主代理通过MCP协议进行通信
🎯 视觉
ECHO使未来的科技公司能够与人工智能工作人员合作:
- 自主决策 在其职权范围内
- 通过共识进行合作 需要时
- 上报至相关机构 层级
- 需要人工批准 用于关键决策
- 自然沟通 跨组织层次
🏗️ 建筑
每个组织角色都作为一个 独立MCP服务器 Claude Desktop(或任何MCP客户端)可以连接到:
Claude Desktop / MCP Client
├──> mcp-server-ceo
├──> mcp-server-cto
├──> mcp-server-chro
├──> mcp-server-operations
├──> mcp-server-product-manager
├──> mcp-server-architect
├──> mcp-server-uiux
├──> mcp-server-developer
└──> mcp-server-test-lead
All agents share:
├── PostgreSQL (organizational memory)
└── Redis (message bus)
📊 监控仪表板
新:用于监控代理活动的实时Phoenix LiveView仪表板!
cd monitor
./start.sh
# Open http://localhost:4000
特征:
- 📈 概述:每日代理活动摘要
- 🔗 权力下放:决策流跟踪
- 📊 演出:代理指标和效率
- ⏱️ 时间线:实时活动提要
看 监控_数据库_指南.md 了解详情。
🚀 快速开始
先决条件
- Elixir 1.18+与Erlang/OTP 27
- PostgreSQL 16+
- Redis 7+
- Ollama(用于本地AI模型)
- Claude Desktop(适用于MCP客户端)
设置分为3个步骤
1.启动基础设施:
# macOS with Homebrew
brew services start postgresql
brew services start redis
# Or use Nix shell (includes all dependencies)
nix-shell
2.设置数据库、LLM和代理:
# Create database and run migrations
cd shared
mix ecto.create
mix ecto.migrate
cd ..
# Install Ollama and download AI models (~48GB)
./setup_llms.sh
# Build all agents
./setup.sh
3.配置克劳德桌面:
安装脚本会自动创建配置。只需重新启动克劳德桌面!
手动配置: 看 CLAUDE_DESKTOP_SETUP.md
验证安装
# Check system health
./echo.sh summary
# Expected output:
# ● System Status: OPERATIONAL
# Infrastructure: ✓ PostgreSQL, ✓ Redis
# Agents: ✓ 3 / 9 agents healthy
# Test LLM integration for specific agent
./scripts/agents/test_agent_llm.sh ceo
# Test all agents' LLM integration
./scripts/agents/test_all_agents_llm.sh
第一个演示
打开克劳德桌面并尝试:
Use the CEO agent to approve a strategic initiative:
- Name: "AI Research Lab"
- Budget: $750,000
- Expected outcome: "Advanced AI capabilities"
看 DEMO_GUIDE.md 10个全面的演示场景。
📚 文档
| 文档 | 描述 |
|---|---|
| CLAUDE_DESKTOP_SETUP.md | 将代理连接到Claude Desktop |
| DEMO_GUIDE.md | 10个带示例的演示场景 |
| ECHO_ARCHITECTURE.md | 完整的系统架构 |
| AGENT_INTEGRATION-GUIDE.md | 代理实现细节 |
| LLM_测试_成功.md | LLM集成测试指南 |
| OLLAMA_SETUP_已完成.md | Ollama和模型设置 |
| 分布式_系统_IMPROVEMENTS.md | 可靠性和可观察性 |
| ECHO_SH_README.md | 监控脚本文档 |
🤖 可用代理
每个代理都可以通过专门的本地LLM模型获得AI协助:
| 代理 | 角色 | AI模型 | 状态 |
|---|---|---|---|
| 首席执行官 | 战略领导力,预算分配 | qwen2.5:14b | ✅ 内置+AI |
| CTO | 技术战略、架构 | deepseek编码器:33b | ✅ 内置+AI |
| CHRO | 人力资源、人才管理 | llama3.1:8b | ✅ 内置+AI |
| 运营主管 | 基础设施和运营 | 经理:7b | ✅ 内置+AI |
| 产品经理 | 产品战略、优先级 | llama3.1:8b | ✅ 内置+AI |
| 高级架构师 | 系统设计、技术规格 | deepseek编码器:33b | ✅ 内置+AI |
| UI/UX工程师 | 界面设计、用户体验 | llama3.2-vision:11b | ✅ 内置+AI |
| 高级开发人员 | 功能实现、编码 | deepseek编码器:6.7b | ✅ 内置+AI |
| 测试负责人 | 质量保证、测试 | 代码:13b | ✅ 内置+AI |
所有代理商使用 通过Ollama建立本地人工智能模型 -零API成本,完全隐私,离线工作。
🎯 主要特点
人工智能驱动的决策
每个代理人都有 ai_consult AI辅助分析工具:
# CEO consulting AI for strategic decision
ai_consult(
query_type: "decision_analysis",
question: "Should we expand to European market?",
context: %{
options: ["Immediate expansion", "Pilot program", "Defer"],
budget: "$5M",
timeline: "12 months"
}
)
优点:
- 🔒 私人 -所有AI都在本地运行,没有云API
- 💰 自由 -安装后API成本为零
- 🎯 专业 -每个角色都有特定于领域的模型
- ⚡ 快速 -实时决策的低延迟
- 🌐 离线 -在没有互联网的情况下工作
决策模式
自主 -代理人在授权范围内做出决定:
# CEO can approve budgets under $1M autonomously
approve_budget(amount: 750_000) # ✅ Autonomous
approve_budget(amount: 5_000_000) # ⬆️ Escalates to human
协作的 -多个代理人投票/达成共识:
# CTO proposes architecture, team votes
propose_architecture(design: "Microservices")
# → Senior Architect, Operations, Product Manager vote
分层的 -向上升级报告链:
# Developer uncertain → Architect → CTO → CEO
escalate_technical_decision(issue: "Database choice")
循环中的人类 -关键决策需要人类:
# Legal, financial, or strategic risks
escalate_to_human(reason: "Regulatory compliance")
代理间通信
代理通过Redis发布/订阅+PostgreSQL持久化进行通信:
# Product Manager → CTO
publish_message(
from: :product_manager,
to: :cto,
type: :request,
subject: "Technical feasibility review"
)
工作流引擎
定义多代理工作流:
workflow "Feature Development" do
step :product_manager, "define_requirements"
step :senior_architect, "design_system"
step :cto, "approve_architecture"
parallel do
step :senior_developer, "implement_backend"
step :ui_ux_engineer, "design_ui"
end
step :test_lead, "create_test_plan"
step :ceo, "approve_budget"
end
健康监测
实时系统可观测性:
./echo.sh # Full system status
./echo.sh agents # Agent health with heartbeats
./echo.sh workflows # Running workflows
./echo.sh messages # Message queue status
./echo.sh decisions # Pending decisions
🚧 开发状态
当前阶段: 第4阶段-工作流程和集成
完整的:
- ✅ 第一阶段:基础(共享库、MCP协议、数据库模式)
- ✅ 第二阶段:CEO代理(参考实施)
- ✅ 第三阶段:所有9个代理都已实施
- ✅ 阶段4.1:分布式系统改进(可靠性、可观察性)
进行中:
- 🔄 工作流引擎测试
- 🔄 与外部系统集成
- 🔄 生产部署指南
看 ECHO_ARCHITECTURE.md 用于完整的架构设计。
📄 许可证
MIT许可证
回声 -构建人工智能驱动的组织的未来,一次一个代理。 🚀
