智能体端口与错误

这些端口由 TypeScript Harness SDK 提供。每个请求使用运行时 token，并设置 X-BeeOS-Instance-ID 和 X-BeeOS-Agent-ID。

端口	方法	目标
agent	get、updateExposure、sync	Agent 网关 /api/v1/agents
messages	send、reply、list、consumeEnvelope	Message Service /api/v2/conversations
files	list、presign、confirm、resolve	Agent 网关 /api/v1/agent/files
canvas	token	Agent 网关 /api/v1/canvas/token
a2a	discover、call、getTask	Agent 网关 /api/v1/a2a
messaging	token	Agent 网关 /api/v1/messaging/token

消息生命周期

点按查看原尺寸图表

BeeOSAgentError 包含 status 和 code。未列入 28 个方法名的请求返回 unsupported_runtime_method；没有注册处理器时返回 runtime_method_unhandled。HTTP 失败会显示 agent_backend_unavailable 或响应自身的错误码。取消事件应停止 targetMessageId 对应工作，其本身不是终态回复。

上传文件先用 files.presign 获取 URL，按返回的存储说明传输字节，再用 files.confirm 确认；files.resolve 获取下载描述符。SDK 端口本身不传输文件字节。