SDK、组件与产品接入

在自己的产品中安全接入聊天、会话和业务工具。

本组文档

• 选择接入方式：Python SDK、JS Client Core、Widget、ToolRunner 各负责什么；四个官方包与固定版本安装；Node/Python/浏览器要求；平台 API 基址与产品代理地址的区别
• 产品登录、后端代理与用户隔离：产品后端保存 Key，从已验证登录态确定 Subject；Agent ACL、资源权限、同源请求与身份切换；Node bridge 的回调替换点，mock 登录如何换为真实登录
• Python SDK：hostanagent-client 安装、异步客户端、发现/会话/Run/SSE/取消/追加输入、错误对象；最小可运行服务端示例与版本要求
• JavaScript / TypeScript Client Core：@hostanagent/client-core、bootstrap、AgentClient、订阅/发送/恢复/取消；无 UI 接入；Node /bridge 与浏览器入口的适用范围
• 聊天组件：@hostanagent/chat-widget、固定 CDN + SRI 或自托管、挂载/卸载、内嵌/侧栏/浮窗、固定会话恢复、主题/渲染扩展；附件只是资源引用，不能当作完整模型多模态支持
• 显式接入工具执行：@hostanagent/tool-runner 和 Python 执行器参考；handler、授权、claim、持久 ReceiptStore、业务幂等；普通异常与明确失败/取消、replayed claim 的处理
• 断线、重试与身份变化：原幂等键、Run 快照与 SSE cursor；页面重载和原会话版本；观察断线、停止 Run、取消业务任务分别处理；未知结果先核对
• 异步任务与可靠回执：completion 与 submission 语义、accepted/progress/final、稳定 executor ID、心跳/候选/报告、持久业务关联、重启补投、迟到结果；接入方持续任务示例