<!-- 来源: https://hostanagent.com/docs/ | 协议: 1.0 | 更新: 2026-09-30 -->

# HostAnAgent 文档

HostAnAgent 托管 Agent 的模型调用、执行循环、会话与运行状态。你可以在控制台创建并调试 Agent，再通过 SDK 或聊天组件把它接入自己的产品。产品继续管理用户登录、业务权限、工具、队列和资产。

## 从哪里开始

- 第一次使用：按[快速开始](/docs/start/quickstart/)注册、发布 Agent、检查余额并查看运行记录。
- 希望其他 Agent 帮你配置：阅读[给 Agent 的使用入口](/docs/start/for-agents/)和[MCP 接入](/docs/mcp/quickstart/)。MCP 负责配置；运行仍使用 SDK 或 REST。
- 在产品中接入：先[选择接入方式](/docs/integration/overview/)，再配置[产品后端身份](/docs/integration/backend-auth/)。
- 调整上下文或工具返回大小：阅读[两套历史与 Token 校准](/docs/concepts/execution-and-cost/)、[字节预算与预览](/docs/reference/tools/)及[旧字段迁移](/docs/reference/configuration/)。
- 运行不符合预期：打开[故障排查](/docs/help/troubleshooting/)与[错误和限制](/docs/reference/errors-limits/)。

## 已开放的基础能力

控制台提供账号、Agent 草稿和发布、版本与状态、调试工作台、运行记录、工具、模型、余额、MCP 和接入说明。公开 REST API 基址为 `https://api.hostanagent.com/v1`；MCP 地址为 `https://api.hostanagent.com/mcp`。客户端包版本为 0.2.5，协议版本为 1.0，MCP 服务版本为 0.1.2。

模型由平台配置。创建和发布 Agent 不需要余额；真正调用模型需要账号有可用余额。在线支付充值尚未开放；可用额度需由平台运营方按审计流程处理。首次产品接入中的真实模型费用、业务工具和长期任务仍需逐项验证。

2026-09-28 服务已上线输入 Token 窗口与工具字节预算更新；客户端包仍为 0.2.5，已发布 npm 的配置类型尚未包含新字段。[更新记录](/docs/releases/changelog/)与[兼容说明](/docs/releases/compatibility/)。

## 阅读边界

网页会话、应用 API Key 和 MCP OAuth 使用不同身份。阅读公开文档不会授予配置写入、模型费用或业务工具执行权限。Google 登录尚未配置；账号与 Agent 的物理内容清理、历史导出属于待实施的 D08；ephemeral 执行模式暂缓。[查看当前数据边界](/docs/help/data-lifecycle/)。

本网站的内容也可通过[文档索引 JSON](/docs/index.json)、本页 `index.md`、[llms.txt](/llms.txt) 和每页 Markdown 直接读取。页面底部提供版本与更新时间。
