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