# HostAnAgent

HostAnAgent 提供托管 Agent、会话、运行与工具协议。配置使用 MCP；产品运行使用 SDK 或 REST。阅读文档不授予 API 权限、模型费用或业务工具执行权。

- 网站: https://hostanagent.com/
- 文档首页: https://hostanagent.com/docs/
- 机器目录: https://hostanagent.com/docs/index.json
- REST: https://api.hostanagent.com/v1
- MCP: https://api.hostanagent.com/mcp
- 协议: 1.0；客户端包: 0.2.5；MCP: 0.1.2

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