AgentsPodium Hosting

agent-gateway

让其他 AI Agent 通过两种机器协议——MCP（Streamable HTTP）和 A2A（Agent2Agent JSON-RPC）——驱动 AgentsPodium 托管服务（创建／监控／管理实例）；这两种协议都由现有的账户 API https://agentspodium.com/api 提供支持。

网关不保存任何状态，也不持有任何自己的密钥。每次调用都携带调用方自己的 AgentsPodium API 密钥（Authorization: Bearer ak_live_...，或会话令牌），并将其原样转发到账户 API。缺少此请求头时，始终会返回 401，并附带 JSON 响应，其中指向 https://agentspodium.com/account（“面向 Agent 的 API 密钥”）和 https://hosting.defispace.com/docs/auth。

一个进程同时服务两个主机名；在两个主机名共用的路径上（仅 GET /），根据 Host 请求头进行选择。其他所有请求默认使用 MCP 行为，而 mcp.agentspodium.com 和 a2a.agentspodium.com 则路由到同一个 Deployment。

本地运行

npm install
npm run build
ACCOUNT_API=https://agentspodium.com/api PORT=3200 npm start
# or, for iteration:
npm run dev

环境变量：

• ACCOUNT_API — 账户 API 的基础 URL（默认值：https://agentspodium.com/api）。
• PORT — HTTP 端口（默认值：3200）。
• A2A_HOST — 用于在 GET / 时选择 A2A 行为的主机名（默认值：a2a.agentspodium.com）。

调用方式

MCP — mcp.agentspodium.com/mcp

Streamable HTTP，无状态（无会话 ID）。需要 Accept: application/json, text/event-stream。

# initialize
curl -s -X POST https://mcp.agentspodium.com/mcp \
  -H "Authorization: Bearer ak_live_..." \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{
    "jsonrpc": "2.0", "id": 1, "method": "initialize",
    "params": {
      "protocolVersion": "2025-06-18",
      "capabilities": {},
      "clientInfo": { "name": "example-client", "version": "0.1.0" }
    }
  }'

# call a tool
curl -s -X POST https://mcp.agentspodium.com/mcp \
  -H "Authorization: Bearer ak_live_..." \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{
    "jsonrpc": "2.0", "id": 2, "method": "tools/call",
    "params": { "name": "list_platforms", "arguments": {} }
  }'

工具：list_platforms、list_instances、create_instance、 get_instance_health、get_instance_term、set_llm_key、pause_instance、 resume_instance、rebuild_instance、delete_instance、get_payment_options、 set_peers、set_webhook。另有一个资源 agentspodium://docs（托管服务文档）。

A2A — a2a.agentspodium.com/

curl -s https://a2a.agentspodium.com/.well-known/agent-card.json

# structured (data part)
curl -s -X POST https://a2a.agentspodium.com/ \
  -H "Authorization: Bearer ak_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0", "id": 1, "method": "message/send",
    "params": {
      "message": {
        "parts": [{ "kind": "data", "data": { "skill": "create-instance", "params": { "engine": "hermes", "tier": "small", "name": "My Agent" } } }]
      }
    }
  }'

# plain text (small command grammar)
curl -s -X POST https://a2a.agentspodium.com/ \
  -H "Authorization: Bearer ak_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0", "id": 2, "method": "message/send",
    "params": { "message": { "parts": [{ "kind": "text", "text": "platforms" }] } }
  }'

文本语法：create <engine> <tier> [name ...]、health <id>、 term <id>、platforms、payment <id>。对于其他任何输入，都会返回 技能列表和准确的 JSON 结构。

无需身份验证即可公开访问：GET /catalog.json（代理账户 API 的 /a2a-catalog）。

部署

docker build -t agentpodium-agent-gateway apps/agent-gateway
# push, then apply:
kubectl apply -f apps/agent-gateway/deploy/gateway.yaml

deploy/gateway.yaml 会创建命名空间 ap-agentgw、一个端口为 3200 的 Deployment/Service，以及两个针对共享 akash-gateway Gateway 的 HTTPRoute（mcp.agentspodium.com、 a2a.agentspodium.com）。应用前，请将 __IMAGE_TAG__ 替换为构建的镜像标签。