使用说明
代理部署引擎
一个使用Claude agent SDK的多代理部署框架，具有MCP集成和声明性作业编排功能。
特性
- SDK MCP A2A传输 -高效的进程内代理通信（比子进程快10-100倍）
- 动态代理发现 -通过A2A协议自动检测能力
- 声明性工作定义 -在YAML中定义复杂拓扑
- 多目标部署 -部署到本地主机、SSH、Docker或Kubernetes
- 多种拓扑模式 -轮辐、管道、网格、DAG、层次结构
快速开始
安装
uv sync
运行代理
# Start all example agents
uv run start-all
# Or individually
uv run weather-agent # Port 9001
uv run maps-agent # Port 9002
uv run controller-agent # Port 9000
部署作业
uv run deploy start examples/jobs/simple-weather.yaml
查询代理
curl -X POST http://localhost:9000/query \
-H "Content-Type: application/json" \
-d '{"query": "What is the weather in Tokyo?"}'
项目结构
agentic-deployment-engine/
├── src/ # Core framework
│ ├── agents/ # Agent base classes and transport
│ ├── backends/ # LLM backends (Claude, Gemini, CrewAI)
│ ├── core/ # Types, exceptions, container
│ ├── jobs/ # Job deployment system
│ ├── security/ # Auth and permissions
│ └── observability/ # Logging and telemetry
├── examples/ # Example implementations
│ ├── agents/ # Weather, Maps, Controller agents
│ ├── tools/ # MCP tools
│ ├── jobs/ # Job YAML definitions
│ └── demos/ # Demo scripts
├── tests/ # Test suite
│ ├── unit/ # Fast, mocked tests
│ ├── integration/ # Component coordination
│ └── usability/ # End-to-end validation
└── docs/ # Documentation
文档
- 入门 -安装和第一步
- 建筑代理商 -创建自定义代理
- 建筑 -系统设计和模式
- 配置 -设置参考
- 工作定义 -YAML作业格式
- SSH部署 -远程部署
- 安全 -身份验证和权限
- 测试 -运行和编写测试
- MCP传输 -运输内部构件
- 故障排除 -常见问题
拓扑模式
星型
配备专业人员的中央协调员。
Controller
/ | \
Weather Maps Database
管道
顺序处理阶段。
Intake → Process → Validate → Output
网格
所有代理都连接到所有其他代理。
1 ←→ 2
↕ ╲╱ ↕
4 ←→ 3
有向无环图
具有并行分支的有向无环图。
┌─ Branch-A ─┐
Source ─┤ ├─ Merge
└─ Branch-B ─┘
分层的
多级树形组织。
Root
/ \
VP-Eng VP-Sales
/ \
Team-A Team-B
测试
# Run all tests
uv run pytest tests/ -v
# By category
uv run pytest tests/unit/ -v
uv run pytest tests/integration/ -v
uv run pytest tests/usability/ -v
# With coverage
uv run pytest tests/ --cov=src
CLI命令
uv run deploy validate <job.yaml> # Validate job definition
uv run deploy plan <job.yaml> # Preview deployment plan
uv run deploy start <job.yaml> # Deploy and run
依赖项
- Python 3.11+
- Claude Agent SDK（主分支）
- FastAPI+Uvicorn
- 派丹蒂克
- HTTPX
- paramiko（SSH部署）
许可证
请参阅许可证文件。
