Cloud Economics Agent

云经济代理

建筑

┌───────────────────────────────────────────────────────────────────────┐
│                         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 .

文档

分析类型

该代理支持9种分析模式，按自然语言分类：

测试

make test              # Run all tests
go test -race ./...    # With race detector