这页适合谁
适合需要“先看 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_id、summary、input_schema、output_schema 和 examples。继续往哪看
这页解决的是“先记住 shape”。如果你要看真实命令和完整上下文,再顺着下面两条路走。