云经济代理
建筑
┌───────────────────────────────────────────────────────────────────────┐
│ External Clients │
│ (other agents, dashboards, CLIs) │
└─────────────────────────────┬─────────────────────────────────────────┘
│ HTTP (JSON-RPC 2.0 / SSE)
┌─────────────────────────────▼─────────────────────────────────────────┐
│ A2A Agent Server (:8080) │
│ │
│ Agent Card Discovery JSON-RPC Dispatch SSE Streaming │
│ GET /.well-known/ POST / task.status │
│ agent.json task.artifact │
│ │
│ ┌───────────────────┐ │
│ │ Agent Core │ │
│ │ classify → fetch │ │
│ │ → analyze → emit │ │
│ └─────────┬─────────┘ │
└──────────────────────────────┼────────────────────────────────────────┘
│ HTTP (internal)
┌──────────────────────────────▼────────────────────────────────────────┐
│ MCP Tool Server (:8081) │
│ │
│ get_ec2_costs get_rds_costs get_savings_plan_coverage │
│ get_s3_costs get_data_transfer get_idle_resources │
│ get_portfolio_companies get_commitment_plan │
│ │
│ GET /tools/list POST /tools/call │
└───────────────────────────────────────────────────────────────────────┘这 A2A服务器 处理代理发现、JSON-RPC调度和SSE流。这 MCP服务器 展示了8个成本分析工具。代理对自然语言请求进行分类，调用适当的工具，并生成带有PE受众框架（EBITDA影响、投资组合级别建议）的降价报告。
快速开始
# Start both servers
make run
# Or manually:
go run ./cmd/mcp-server & # Terminal 1
go run ./cmd/a2a-server # Terminal 2示例
# Discover the agent
curl -s http://localhost:8080/.well-known/agent.json | jq .name
# "Cloud Economics Agent"
# Run a portfolio roll-up (synchronous)
curl -s -X POST http://localhost:8080/ \
-H "Content-Type: application/json" \
-d '{
"jsonrpc": "2.0",
"id": 1,
"method": "message/send",
"params": {
"message": {
"role": "user",
"parts": [{"type": "text", "text": "Run a full portfolio roll-up analysis"}]
}
}
}' | jq '.result.artifacts[0].parts[0].text' -r
# Stream with real-time progress
curl -N -X POST http://localhost:8080/ \
-H "Content-Type: application/json" \
-d '{
"jsonrpc": "2.0",
"id": 2,
"method": "message/stream",
"params": {
"message": {
"role": "user",
"parts": [{"type": "text", "text": "Analyze EC2 spend for account 111222333444"}]
}
}
}'
# Call an MCP tool directly
curl -s -X POST http://localhost:8081/tools/call \
-H "Content-Type: application/json" \
-d '{"name": "get_ec2_costs", "parameters": {"account_id": "111222333444", "period_days": 30}}' | jq .文档
| 文档 | 描述 |
|---|---|
| 建筑 | 系统设计、请求流、包结构、设计决策 |
| API 参考 | 为两台服务器提供完整的HTTP API，并提供示例 |
| 工具目录 | 所有8个带参数、模式和示例的MCP工具 |
| 开发指南 | 本地运行、测试、添加新工具、代码约定 |
| 部署指导 | Docker、Compose、TLS、健康检查、可观察性、生产考虑因素 |
分析类型
该代理支持9种分析模式，按自然语言分类：
| 请求 | 示例 | 使用的工具 |
|---|---|---|
| EC2分析 | “分析EC2支出” | EC2成本+节省覆盖率 |
| RDS分析 | “数据库成本明细” | RDS成本+节约覆盖率 |
| S3分析 | “S3存储成本” | S3成本 |
| 数据传输 | “出口成本分析” | 数据传输成本 |
| 空闲资源 | “查找未使用的资源” | 空闲资源检测 |
| 储蓄覆盖率 | “RI覆盖率分析” | 储蓄计划覆盖率+EC2 |
| 承诺计划 | “承诺优化器” | 承诺计划器 |
| 全面分析 | “全面成本分析” | 一个账户的所有工具 |
| 投资组合汇总 | “投资组合汇总” | 所有工具，所有账户（并行） |
测试
make test # Run all tests
go test -race ./... # With race detector