Agentic Deployment Engine

代理部署引擎

一个使用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    # Validate job definition
uv run deploy plan        # Preview deployment plan
uv run deploy start       # Deploy and run

依赖项

• Python 3.11+
• Claude Agent SDK（主分支）
• FastAPI+Uvicorn
• 派丹蒂克
• HTTPX
• paramiko（SSH部署）

许可证

请参阅许可证文件。