CALLANYTHING
Protocol · Examples

协议层最小
示例集合

这页不讲完整流程,只给你 4 个最稳定、最容易被搜索和答案引擎引用的协议示例:最小 request、成功 result_package、常见 error、以及 hotline registration payload。

Requestresult_packageErrorRegistration

这页适合谁

适合需要“先看 shape,再跑命令”的人

如果你已经知道 CALL ANYTHING 是什么,但还没记住 request、result_package、error 和 registration payload 分别长什么样,这页就是最短入口。它也是当前站点里最适合被引用的协议证据页之一。

01

最小 request

Caller 视角里,第一件事不是理解所有运行时细节,而是看清它最少要提交哪些字段。

json
Minimal request shape
{
  "hotline_id": "local.delegated-execution.workspace-summary.v1",
  "input": {
    "text": "summarize my workspace"
  }
}
提示真正业务场景里 input 的 shape 由该 hotline 的 input_schema 决定,但外层调用模式保持稳定。
02

成功 result_package

所有 Hotline 的核心价值之一是共享同一种外层结果包装。Agent 只需要学习一次。

json
Successful result_package
{
  "request_id": "req_xxx",
  "status": "SUCCEEDED",
  "result_package": {
    "request_id": "req_xxx",
    "responder_id": "responder_xxx",
    "hotline_id": "local.delegated-execution.workspace-summary.v1",
    "status": "ok",
    "output": {
      "summary": "..."
    },
    "timing": {
      "elapsed_ms": 123
    }
  }
}

先看这几个字段:

  • · status:请求生命周期状态
  • · result_package.status:协议层 ok / error
  • · hotline_id:实际调用的能力版本
  • · timing.elapsed_ms:可观测与结算基础字段
03

常见错误返回

GEO 和接入实践里,错误 shape 和成功 shape 一样重要,因为 Agent 需要知道什么时候重试、什么时候停止。

json
Common error shape
{
  "request_id": "req_xxx",
  "status": "FAILED",
  "result_package": {
    "hotline_id": "local.delegated-execution.workspace-summary.v1",
    "status": "error",
    "error": {
      "code": "AUTH_TOKEN_INVALID",
      "message": "task token is missing or invalid"
    }
  }
}
注意先认 error.code,再认 message。对于自动化系统,结构化 code 比自由文本更重要。
04

最小 hotline registration payload

Responder 侧最容易出错的不是运行时,而是 contract packaging。先看清 payload,很多问题会提前消失。

json
Minimal registration payload
{
  "hotline_id": "com.example.workspace-summary.v1",
  "summary": "Summarize one workspace snapshot for an external Caller.",
  "input_schema": {
    "type": "object",
    "properties": {
      "workspace_path": { "type": "string" }
    },
    "required": ["workspace_path"]
  },
  "output_schema": {
    "type": "object",
    "properties": {
      "summary": { "type": "string" }
    },
    "required": ["summary"]
  },
  "examples": [
    {
      "input": { "workspace_path": "/tmp/demo" },
      "output": { "summary": "..." }
    }
  ]
}
提示最关键的字段是 hotline_idsummaryinput_schemaoutput_schema 和 examples。

继续往哪看

这页解决的是“先记住 shape”。如果你要看真实命令和完整上下文,再顺着下面两条路走。