使用说明
代理编排器框架（AOF）
构建、运行和观察AI代理的框架。定义代理蓝图，将其作为托管会话运行，并实时观察执行情况。
设计原则：
- 提供者不可知 --执行器层抽象了AI框架（实现了Claude代码，其他可插拔）
- 最小设置 --预构建的容器映像或本地开发脚本
- 可观察对象 --用于监控代理会话和调试的仪表板
什么是代理编排器框架？
构建AI代理系统的基础设施。它提供：
- 代理协调员 --管理会话、排队代理运行、跟踪状态
- Agent Runner --通过可插拔执行器执行代理（实现了Claude代码）
- 上下文存储 --代理之间的文档存储和共享
- 仪表盘 --实时监控和会话管理
使用它来原型化代理工作流，构建多代理系统，或作为代理驱动应用程序的后端。
看 建筑 了解详细的组件交互和术语。
快速开始
选项A：容器图像（推荐）
仅需要 码头工人.
-
获取Claude Code OAuth令牌：
claude setup-token -
创建
.env文件：CLAUDE_CODE_OAUTH_TOKEN=<your-token> -
创建配置目录：
mkdir -p config/agents -
启动服务：
docker compose -f docker-compose.quickstart.yml up -
打开http://localhost:3000
方案B：地方发展
需要 Claude 代码命令行界面, 码头工人, Python≥3.11 + 紫外线.
git clone <repo-url>
cd claude-agent-orchestrator
make start-all
然后在项目目录中启动Agent Runner：
cd /path/to/your/project
/path/to/claude-agent-orchestrator/servers/agent-runner/agent-runner
打开http://localhost:3000
停止服务
# Containers
docker compose -f docker-compose.quickstart.yml down
# Local development
make stop-all
仓库结构
├── README.md
├── Makefile # Build, run, deploy commands
├── docker-compose.yml # Full dev environment
├── docker-compose.quickstart.yml # Minimal setup with pre-built images
│
├── docs/ # Documentation
│ ├── ARCHITECTURE.md # System architecture overview
│ ├── GETTING_STARTED.md # Detailed setup guide
│ └── containers/ # Container image documentation
│
├── servers/
│ ├── agent-coordinator/ # Session management, agent registry, SSE events
│ ├── agent-runner/ # Polls coordinator, executes agent runs
│ │ ├── lib/agent_orchestrator_mcp/ # Embedded MCP server
│ │ └── executors/
│ │ └── claude-code/ # Claude Code executor (Agent SDK)
│ └── context-store/ # Document storage server
│
├── mcps/ # External MCP servers
│ ├── context-store/ # Document management MCP
│ ├── neo4j/ # Neo4j graph database MCP
│ ├── atlassian/ # Jira + Confluence MCP
│ └── ado/ # Azure DevOps MCP
│
├── apps/dashboard/ # Web UI (React + Vite)
│
├── plugins/ # Claude Code plugins
│ ├── orchestrator/ # ao-* orchestration commands
│ └── context-store/ # doc-* document commands
│
├── config/agents/ # Agent blueprints
├── scripts/ # Dev startup scripts
└── tests/ # Integration tests
MCP服务器
中的可选MCP服务器 mcps/ 扩展代理功能（Neo4j、Atlassian、Azure DevOps、Context Store）。
这 代理编排器MCP 嵌入在Agent Runner中，并自动可供正在运行的代理使用。
看 mcps/README.md 用于设置和配置。
代理示例
这 config/agents/ 该目录包含演示各种模式的示例代理蓝图：web研究、Atlassian/ADO集成、知识管理、浏览器自动化等。
看 config/agents/README.md 查看完整列表。
上下文存储
用于在代理之间共享上下文的文档存储服务器。支持标记、查询和父子文档关系。
可选的 语义搜索 允许按含义查找文档（需要Ollama+Elasticsearch）。
看 服务器/上下文存储/README.md 用于安装和API文档。
服务URL
| 服务 | URL |
|---|---|
| 仪表板 | http://localhost:3000 |
| 代理协调员 | http://localhost:8765 |
| 上下文存储 | http://localhost:8766 |
测试
该框架包括一个集成测试套件，用于验证代理协调器和代理运行器的功能。测试可以使用确定性测试执行器或真正的克劳德代码执行器运行。
看 测试/README.md 用于设置和测试用例文档。
