Claude Agent Orchestrator

代理编排器框架（AOF）

构建、运行和观察AI代理的框架。定义代理蓝图，将其作为托管会话运行，并实时观察执行情况。

设计原则：

• 提供者不可知 --执行器层抽象了AI框架（实现了Claude代码，其他可插拔）
• 最小设置 --预构建的容器映像或本地开发脚本
• 可观察对象 --用于监控代理会话和调试的仪表板

什么是代理编排器框架？

构建AI代理系统的基础设施。它提供：

• 代理协调员 --管理会话、排队代理运行、跟踪状态
• Agent Runner --通过可插拔执行器执行代理（实现了Claude代码）
• 上下文存储 --代理之间的文档存储和共享
• 仪表盘 --实时监控和会话管理

使用它来原型化代理工作流，构建多代理系统，或作为代理驱动应用程序的后端。

看 建筑 了解详细的组件交互和术语。

快速开始

选项A：容器图像（推荐）

仅需要 码头工人.

1. 获取Claude Code OAuth令牌：

   claude setup-token

1. 创建 .env 文件：

   CLAUDE_CODE_OAUTH_TOKEN=

1. 创建配置目录：

   mkdir -p config/agents

1. 启动服务：

   docker compose -f docker-compose.quickstart.yml up

1. 打开http://localhost:3000

方案B：地方发展

需要 Claude 代码命令行界面, 码头工人, Python≥3.11 + 紫外线.

git clone 
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

测试

该框架包括一个集成测试套件，用于验证代理协调器和代理运行器的功能。测试可以使用确定性测试执行器或真正的克劳德代码执行器运行。

看 测试/README.md 用于设置和测试用例文档。

文档

• 建筑 -完整的系统架构和组件交互
• 入门指南 -详细的设置和配置
• **** -Docker设置和配置
• 文档索引 -所有文档主题
• Agent Runner -使用嵌入式代理编排器MCP运行执行器
• 上下文存储 -具有语义搜索功能的文档存储服务器
• MCP服务器概述 -所有可用的MCP服务器
• 上下文存储MCP -文档管理MCP服务器