构建自定义智能体

宿主进程负责模型循环和入站传输。BeeOS 通过Harness SDK提供身份、消息、文件、Canvas 和 A2A 端口。

接收运行时身份

从部署环境配置 Agent 网关 URL、Message Service URL、实例 ID、智能体 ID 和运行时 token。token 只保留在智能体进程内。

注册处理函数

处理 `onChatMessage`、`onChatCancel`，并实现框架支持的 `onRuntimeMethod` 方法。

连接宿主传输

将入站信封传给 `consumeEnvelope`，将 C14 方法请求传给 `dispatchRuntimeMethod`。

回复与退出

回复时携带入站消息 ID；取消时停止对应工作；进程退出时调用 `close`。

最小聊天处理器调用 runtime.messages.reply(event.conversationId, event.messageId, text)。更复杂的智能体可以在处理期间使用文件、Canvas、A2A 与消息端口。服务端调用 skills/list 或 session/set_model 时，运行时方法处理器执行对应框架操作。调用方应先查询运行时能力。

Important: Harness SDK 不提供 Cloud 服务端 REST 接口，也不接收 bsk_ Key。实例和用户管理应由可信产品后端的服务端 SDK 完成。