{ "title": "HostAnAgent 文档", "language": "zh-CN", "updated_at": "2026-09-30", "authored_pages": 38, "section_pages": 8, "source": { "docs_commit": "021f927799ccec05ea9869c0f304cd3de47fb0ad", "backend_commit": "40c152f9b0097898d2852c93fdeb2a44d87f6462", "protocol_schema_sha256": "dd28a7849b1a877c8304a185a8baf2cad5011edae12d215b4c9469a5d503ca20" }, "pages": [ { "title": "HostAnAgent 文档", "description": "官网文档首页与任务入口", "url": "https://hostanagent.com/docs/", "markdown_url": "https://hostanagent.com/docs/index.md", "section": "开始使用", "protocol_version": "1.0", "updated_at": "2026-09-30", "doc_status": "published", "feature_status": "available" }, { "title": "开始使用", "description": "按首次使用任务阅读平台、账号与 Agent 配置指南。", "url": "https://hostanagent.com/docs/start/", "markdown_url": "https://hostanagent.com/docs/start/index.md", "section": "开始使用", "protocol_version": "1.0", "updated_at": "2026-09-30", "doc_status": "published", "feature_status": "available" }, { "title": "HostAnAgent 能做什么", "description": "平台托管模型与 Agent 循环，产品保留业务工具、身份、队列、资产及业务收费；适用场景和当前开放范围", "url": "https://hostanagent.com/docs/start/overview/", "markdown_url": "https://hostanagent.com/docs/start/overview/index.md", "section": "开始使用", "protocol_version": "1.0", "updated_at": "2026-09-30", "doc_status": "published", "feature_status": "available" }, { "title": "完成第一次配置与对话", "description": "邮箱注册/登录 → 确认可用余额 → 创建无工具 Agent → 选择模型与输入窗口 → 发布 → 调试 → 查看运行和费用；无余额时可先完成配置", "url": "https://hostanagent.com/docs/start/quickstart/", "markdown_url": "https://hostanagent.com/docs/start/quickstart/index.md", "section": "开始使用", "protocol_version": "1.0", "updated_at": "2026-09-30", "doc_status": "published", "feature_status": "available" }, { "title": "给 Agent 的使用入口", "description": "实际服务地址、当前版本、任务到文档的索引；配置/运行/网页操作如何选择；授权与副作用；需要用户处理的验证码/凭证；成功如何回读确认", "url": "https://hostanagent.com/docs/start/for-agents/", "markdown_url": "https://hostanagent.com/docs/start/for-agents/index.md", "section": "开始使用", "protocol_version": "1.0", "updated_at": "2026-09-30", "doc_status": "published", "feature_status": "available" }, { "title": "核心概念", "description": "理解 Agent、版本、会话、运行、持久化与费用之间的关系。", "url": "https://hostanagent.com/docs/concepts/", "markdown_url": "https://hostanagent.com/docs/concepts/index.md", "section": "核心概念", "protocol_version": "1.0", "updated_at": "2026-09-30", "doc_status": "published", "feature_status": "available" }, { "title": "账号、Agent、版本、Session 与 Run", "description": "个人账号与内部应用、接入方 Subject、逻辑 Agent 与不可变版本、会话与单轮运行、工具集版本/绑定/执行器；各 ID 的来源与关系", "url": "https://hostanagent.com/docs/concepts/core/", "markdown_url": "https://hostanagent.com/docs/concepts/core/index.md", "section": "核心概念", "protocol_version": "1.0", "updated_at": "2026-09-30", "doc_status": "published", "feature_status": "available" }, { "title": "运行、持久化、上下文与费用", "description": "完整历史与执行历史；稳定追加与缓存；整体 Token 窗口、真实用量校准和压缩阈值；工具 UTF-8 字节裁剪；钱包预留与长期运行", "url": "https://hostanagent.com/docs/concepts/execution-and-cost/", "markdown_url": "https://hostanagent.com/docs/concepts/execution-and-cost/index.md", "section": "核心概念", "protocol_version": "1.0", "updated_at": "2026-09-30", "doc_status": "published", "feature_status": "available" }, { "title": "控制台使用指南", "description": "浏览控制台各入口的实际操作和当前限制。", "url": "https://hostanagent.com/docs/console/", "markdown_url": "https://hostanagent.com/docs/console/index.md", "section": "控制台使用指南", "protocol_version": "1.0", "updated_at": "2026-09-30", "doc_status": "published", "feature_status": "available" }, { "title": "项目总览与导航", "description": "11 个主导航入口；独立 API Keys 管理、Agent 数、活动运行、模型调用和 Token 统计含义；从空账号开始的入口", "url": "https://hostanagent.com/docs/console/overview/", "markdown_url": "https://hostanagent.com/docs/console/overview/index.md", "section": "控制台使用指南", "protocol_version": "1.0", "updated_at": "2026-09-30", "doc_status": "published", "feature_status": "available" }, { "title": "注册、登录与账号安全", "description": "邮箱验证、退出、找回/修改密码、更换邮箱、近期身份验证；操作对其他会话/OAuth/Key 的影响；账号关闭与数据清理的区别；Google 当前未配置", "url": "https://hostanagent.com/docs/console/account/", "markdown_url": "https://hostanagent.com/docs/console/account/index.md", "section": "控制台使用指南", "protocol_version": "1.0", "updated_at": "2026-09-30", "doc_status": "published", "feature_status": "available" }, { "title": "创建与管理 API Key", "description": "scope 互不隐含及 Agent 范围、有效期、明文只显示一次、保存失败处理、轮换重叠期、单个撤销、最近使用；密钥放在产品服务端", "url": "https://hostanagent.com/docs/console/api-keys/", "markdown_url": "https://hostanagent.com/docs/console/api-keys/index.md", "section": "控制台使用指南", "protocol_version": "1.0", "updated_at": "2026-09-30", "doc_status": "published", "feature_status": "available" }, { "title": "创建和发布 Agent", "description": "名称、描述、系统指令、平台模型、思考强度、工具集版本、输入 Token 窗口、输出 Schema；保存草稿、校验与发布；发布成功不检查余额", "url": "https://hostanagent.com/docs/console/agents/", "markdown_url": "https://hostanagent.com/docs/console/agents/index.md", "section": "控制台使用指南", "protocol_version": "1.0", "updated_at": "2026-09-30", "doc_status": "published", "feature_status": "available" }, { "title": "版本与生命周期", "description": "历史、差异、复制、回滚生成新版本；启用/停用/归档/恢复；已有会话固定版本；引用查询、申请/撤回删除；未提供物理清理", "url": "https://hostanagent.com/docs/console/versions-lifecycle/", "markdown_url": "https://hostanagent.com/docs/console/versions-lifecycle/index.md", "section": "控制台使用指南", "protocol_version": "1.0", "updated_at": "2026-09-30", "doc_status": "published", "feature_status": "available" }, { "title": "调试工作台", "description": "选择 Agent 和固定版本、新建/恢复会话、消息与思考强度、本轮输入窗口、流式显示、审批和停止；真实工具需接入方执行器", "url": "https://hostanagent.com/docs/console/playground/", "markdown_url": "https://hostanagent.com/docs/console/playground/index.md", "section": "控制台使用指南", "protocol_version": "1.0", "updated_at": "2026-09-30", "doc_status": "published", "feature_status": "available" }, { "title": "运行记录与诊断", "description": "运行状态、快照/消息/工具结果、诊断时间线、首段和完整输出、错误关联 ID、恢复查看、删除会话；不通过重新发起 Run 修复未知结果", "url": "https://hostanagent.com/docs/console/runs-diagnostics/", "markdown_url": "https://hostanagent.com/docs/console/runs-diagnostics/index.md", "section": "控制台使用指南", "protocol_version": "1.0", "updated_at": "2026-09-30", "doc_status": "published", "feature_status": "available" }, { "title": "单个工具配置、工具集与执行诊断", "description": "逐个创建、编辑、复制和移除工具，参数表单与复杂 JSON Schema；执行绑定、不可变工具集版本、连接诊断与模拟结果预览", "url": "https://hostanagent.com/docs/console/tools/", "markdown_url": "https://hostanagent.com/docs/console/tools/index.md", "section": "控制台使用指南", "protocol_version": "1.0", "updated_at": "2026-09-30", "doc_status": "published", "feature_status": "available" }, { "title": "平台模型与思考强度", "description": "从实时模型目录读取可用能力；五档选项及实际映射；没有自带供应商 Key 流程；模型不可用时的处理", "url": "https://hostanagent.com/docs/console/models/", "markdown_url": "https://hostanagent.com/docs/console/models/index.md", "section": "控制台使用指南", "protocol_version": "1.0", "updated_at": "2026-09-30", "doc_status": "published", "feature_status": "available" }, { "title": "套餐、余额与用量", "description": "套餐与赠送、共享槽位、充值报价、冻结与可用金额、模型费用及流水；在线支付尚未开放", "url": "https://hostanagent.com/docs/console/billing/", "markdown_url": "https://hostanagent.com/docs/console/billing/index.md", "section": "控制台使用指南", "protocol_version": "1.0", "updated_at": "2026-09-30", "doc_status": "published", "feature_status": "available" }, { "title": "SDK、组件与产品接入", "description": "在自己的产品中安全接入聊天、会话和业务工具。", "url": "https://hostanagent.com/docs/integration/", "markdown_url": "https://hostanagent.com/docs/integration/index.md", "section": "SDK、组件与产品接入", "protocol_version": "1.0", "updated_at": "2026-09-30", "doc_status": "published", "feature_status": "available" }, { "title": "选择接入方式", "description": "Python SDK、JS Client Core、Widget、ToolRunner 各负责什么；四个官方包与固定版本安装；Node/Python/浏览器要求；平台 API 基址与产品代理地址的区别", "url": "https://hostanagent.com/docs/integration/overview/", "markdown_url": "https://hostanagent.com/docs/integration/overview/index.md", "section": "SDK、组件与产品接入", "protocol_version": "1.0", "updated_at": "2026-09-30", "doc_status": "published", "feature_status": "available" }, { "title": "产品登录、后端代理与用户隔离", "description": "产品后端保存 Key，从已验证登录态确定 Subject；Agent ACL、资源权限、同源请求与身份切换；Node bridge 的回调替换点，mock 登录如何换为真实登录", "url": "https://hostanagent.com/docs/integration/backend-auth/", "markdown_url": "https://hostanagent.com/docs/integration/backend-auth/index.md", "section": "SDK、组件与产品接入", "protocol_version": "1.0", "updated_at": "2026-09-30", "doc_status": "published", "feature_status": "available" }, { "title": "Python SDK", "description": "`hostanagent-client` 安装、异步客户端、发现/会话/Run/SSE/取消/追加输入、错误对象；最小可运行服务端示例与版本要求", "url": "https://hostanagent.com/docs/integration/python/", "markdown_url": "https://hostanagent.com/docs/integration/python/index.md", "section": "SDK、组件与产品接入", "protocol_version": "1.0", "updated_at": "2026-09-30", "doc_status": "published", "feature_status": "available" }, { "title": "JavaScript / TypeScript Client Core", "description": "`@hostanagent/client-core`、bootstrap、AgentClient、订阅/发送/恢复/取消；无 UI 接入；Node `/bridge` 与浏览器入口的适用范围", "url": "https://hostanagent.com/docs/integration/javascript/", "markdown_url": "https://hostanagent.com/docs/integration/javascript/index.md", "section": "SDK、组件与产品接入", "protocol_version": "1.0", "updated_at": "2026-09-30", "doc_status": "published", "feature_status": "available" }, { "title": "聊天组件", "description": "`@hostanagent/chat-widget`、固定 CDN + SRI 或自托管、挂载/卸载、内嵌/侧栏/浮窗、固定会话恢复、主题/渲染扩展；附件只是资源引用，不能当作完整模型多模态支持", "url": "https://hostanagent.com/docs/integration/widget/", "markdown_url": "https://hostanagent.com/docs/integration/widget/index.md", "section": "SDK、组件与产品接入", "protocol_version": "1.0", "updated_at": "2026-09-30", "doc_status": "published", "feature_status": "available" }, { "title": "显式接入工具执行", "description": "`@hostanagent/tool-runner` 和 Python 执行器参考；handler、授权、claim、持久 ReceiptStore、业务幂等；普通异常与明确失败/取消、replayed claim 的处理", "url": "https://hostanagent.com/docs/integration/tool-runner/", "markdown_url": "https://hostanagent.com/docs/integration/tool-runner/index.md", "section": "SDK、组件与产品接入", "protocol_version": "1.0", "updated_at": "2026-09-30", "doc_status": "published", "feature_status": "available" }, { "title": "断线、重试与身份变化", "description": "原幂等键、Run 快照与 SSE cursor；页面重载和原会话版本；观察断线、停止 Run、取消业务任务分别处理；未知结果先核对", "url": "https://hostanagent.com/docs/integration/recovery/", "markdown_url": "https://hostanagent.com/docs/integration/recovery/index.md", "section": "SDK、组件与产品接入", "protocol_version": "1.0", "updated_at": "2026-09-30", "doc_status": "published", "feature_status": "available" }, { "title": "异步任务与可靠回执", "description": "completion 与 submission 语义、accepted/progress/final、稳定 executor ID、心跳/候选/报告、持久业务关联、重启补投、迟到结果；接入方持续任务示例", "url": "https://hostanagent.com/docs/integration/long-running-tools/", "markdown_url": "https://hostanagent.com/docs/integration/long-running-tools/index.md", "section": "SDK、组件与产品接入", "protocol_version": "1.0", "updated_at": "2026-09-30", "doc_status": "published", "feature_status": "available" }, { "title": "MCP 与其他 Agent", "description": "通过 OAuth 授权让其他 Agent 管理配置。", "url": "https://hostanagent.com/docs/mcp/", "markdown_url": "https://hostanagent.com/docs/mcp/index.md", "section": "MCP 与其他 Agent", "protocol_version": "1.0", "updated_at": "2026-09-30", "doc_status": "published", "feature_status": "available" }, { "title": "连接 MCP 与授权", "description": "`https://api.hostanagent.com/mcp`、Streamable HTTP、OAuth 登录/同意、读写权限、刷新与撤销；不把应用 Key 当 OAuth token；客户端升级权限时的行为", "url": "https://hostanagent.com/docs/mcp/quickstart/", "markdown_url": "https://hostanagent.com/docs/mcp/quickstart/index.md", "section": "MCP 与其他 Agent", "protocol_version": "1.0", "updated_at": "2026-09-30", "doc_status": "published", "feature_status": "available" }, { "title": "22 个配置工具参考", "description": "按 Agent/版本与状态、工具集/执行绑定、模型价格/配置校验分组；准确工具名、输入、输出、scope、版本冲突与幂等；从 `tools/list` Schema 核对", "url": "https://hostanagent.com/docs/mcp/tools/", "markdown_url": "https://hostanagent.com/docs/mcp/tools/index.md", "section": "MCP 与其他 Agent", "protocol_version": "1.0", "updated_at": "2026-09-30", "doc_status": "published", "feature_status": "available" }, { "title": "常见 MCP 配置任务", "description": "读取现状→创建草稿→校验→发布；修改并回读；关联新工具集版本；比较/复制/回滚；停用/归档和删除申请；每步标明读或写及结果验证方式", "url": "https://hostanagent.com/docs/mcp/recipes/", "markdown_url": "https://hostanagent.com/docs/mcp/recipes/index.md", "section": "MCP 与其他 Agent", "protocol_version": "1.0", "updated_at": "2026-09-30", "doc_status": "published", "feature_status": "available" }, { "title": "API 与协议参考", "description": "核对公开 REST、SSE、执行器和错误协议。", "url": "https://hostanagent.com/docs/reference/", "markdown_url": "https://hostanagent.com/docs/reference/index.md", "section": "API 与协议参考", "protocol_version": "1.0", "updated_at": "2026-09-30", "doc_status": "published", "feature_status": "available" }, { "title": "地址、身份与权限", "description": "REST `/v1` 与 MCP 地址；Bearer Key、可信 Subject、scope/Agent 范围；网页账号身份与 OAuth；401/403 与资源隔离；公共接口清单入口", "url": "https://hostanagent.com/docs/reference/authentication/", "markdown_url": "https://hostanagent.com/docs/reference/authentication/index.md", "section": "API 与协议参考", "protocol_version": "1.0", "updated_at": "2026-09-30", "doc_status": "published", "feature_status": "available" }, { "title": "配置与生命周期 API", "description": "Agent 与工具集配置、revision 和幂等；max_context_tokens 与 max_result_context_bytes；旧字段删除、发布新版本与会话生效步骤", "url": "https://hostanagent.com/docs/reference/configuration/", "markdown_url": "https://hostanagent.com/docs/reference/configuration/index.md", "section": "API 与协议参考", "protocol_version": "1.0", "updated_at": "2026-09-30", "doc_status": "published", "feature_status": "available" }, { "title": "会话与运行 API", "description": "capabilities/models/bootstrap/runtime 元数据；Session、历史、Run、追加输入、取消、审批和诊断；逻辑 Agent 与固定版本选择；状态和结束分类", "url": "https://hostanagent.com/docs/reference/runtime/", "markdown_url": "https://hostanagent.com/docs/reference/runtime/index.md", "section": "API 与协议参考", "protocol_version": "1.0", "updated_at": "2026-09-30", "doc_status": "published", "feature_status": "available" }, { "title": "SSE 事件与恢复", "description": "事件信封、sequence、事件类型、展示推理、增量与最终结果、快照/cursor/去重、终态及旧客户端处理未知可选字段", "url": "https://hostanagent.com/docs/reference/events/", "markdown_url": "https://hostanagent.com/docs/reference/events/index.md", "section": "API 与协议参考", "protocol_version": "1.0", "updated_at": "2026-09-30", "doc_status": "published", "feature_status": "available" }, { "title": "执行器与工具回执协议", "description": "执行器、claim/grant 与可靠回执；max_result_context_bytes 默认 16 KiB、上限 32 KiB；UTF-8 字节裁剪、完整回执、分页设计与 context_preview 模拟预览", "url": "https://hostanagent.com/docs/reference/tools/", "markdown_url": "https://hostanagent.com/docs/reference/tools/index.md", "section": "API 与协议参考", "protocol_version": "1.0", "updated_at": "2026-09-30", "doc_status": "published", "feature_status": "available" }, { "title": "错误码、限制与重试", "description": "HTTP 状态、稳定错误 code 与安全重试；余额、权限、版本、模型、工具和上下文边界；当前默认值、配置范围及已删除字段", "url": "https://hostanagent.com/docs/reference/errors-limits/", "markdown_url": "https://hostanagent.com/docs/reference/errors-limits/index.md", "section": "API 与协议参考", "protocol_version": "1.0", "updated_at": "2026-09-30", "doc_status": "published", "feature_status": "available" }, { "title": "故障与数据", "description": "按现象排查错误并理解当前数据生命周期。", "url": "https://hostanagent.com/docs/help/", "markdown_url": "https://hostanagent.com/docs/help/index.md", "section": "故障、数据与版本", "protocol_version": "1.0", "updated_at": "2026-09-30", "doc_status": "published", "feature_status": "available" }, { "title": "按现象排查问题", "description": "登录、权限、余额、模型和工具等待排查；旧字段校验失败、工具内容缺失、压缩时机与固定版本；未知结果先核对", "url": "https://hostanagent.com/docs/help/troubleshooting/", "markdown_url": "https://hostanagent.com/docs/help/troubleshooting/index.md", "section": "故障、数据与版本", "protocol_version": "1.0", "updated_at": "2026-09-30", "doc_status": "published", "feature_status": "available" }, { "title": "常见问题", "description": "是否需要供应商 Key；为什么短消息也要预留；MCP 能否运行；关页面是否停止；平台与产品如何收费；工具测试是否真的执行业务；未开放能力", "url": "https://hostanagent.com/docs/help/faq/", "markdown_url": "https://hostanagent.com/docs/help/faq/index.md", "section": "故障、数据与版本", "protocol_version": "1.0", "updated_at": "2026-09-30", "doc_status": "published", "feature_status": "available" }, { "title": "历史保存、删除与当前边界", "description": "平台 durable 历史与产品自存副本；默认组件的正文持久化行为；会话删除、账号关闭、Agent 删除申请；D08 清理/导出/备份删除保护尚未完成，不承诺未实现的保存期限或即时全量删除", "url": "https://hostanagent.com/docs/help/data-lifecycle/", "markdown_url": "https://hostanagent.com/docs/help/data-lifecycle/index.md", "section": "故障、数据与版本", "protocol_version": "1.0", "updated_at": "2026-09-30", "doc_status": "published", "feature_status": "available" }, { "title": "版本与升级", "description": "查询实际上线的能力、版本与兼容边界。", "url": "https://hostanagent.com/docs/releases/", "markdown_url": "https://hostanagent.com/docs/releases/index.md", "section": "故障、数据与版本", "protocol_version": "1.0", "updated_at": "2026-09-30", "doc_status": "published", "feature_status": "available" }, { "title": "用户可见更新", "description": "实际上线日期、受影响功能、包版本和迁移指引；区分源码已合入、包已发布、服务已上线；每次发布关联变更页", "url": "https://hostanagent.com/docs/releases/changelog/", "markdown_url": "https://hostanagent.com/docs/releases/changelog/index.md", "section": "故障、数据与版本", "protocol_version": "1.0", "updated_at": "2026-09-30", "doc_status": "published", "feature_status": "available" }, { "title": "版本与升级", "description": "服务、协议、MCP 和 SDK 的版本边界；已发布 0.2.5 的旧配置类型与当前字段；固定包版本、新 Session 和迁移步骤", "url": "https://hostanagent.com/docs/releases/compatibility/", "markdown_url": "https://hostanagent.com/docs/releases/compatibility/index.md", "section": "故障、数据与版本", "protocol_version": "1.0", "updated_at": "2026-09-30", "doc_status": "published", "feature_status": "available" } ] }