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

# 账号、Agent、版本、Session 与 Run

HostAnAgent 使用个人账号。账号有一个内部应用和一份美元钱包；你的产品可以用同一受限应用 Key 服务它自己的多个用户，但必须从产品已验证的登录态确定各人的 `Subject`。

| 名称 | 含义 | 从哪里取得 |
|---|---|---|
| Agent ID | 一个可修改草稿、发布版本和服务状态的逻辑 Agent | 控制台“我的 Agents”或配置 API/MCP 返回 |
| Agent version ID | 一次发布的不可变配置快照；历史会话仍使用原版本 | 发布结果或版本历史 |
| Session ID | 持续对话及历史的容器，使用 managed + durable | 创建会话后返回；恢复时使用原 ID |
| Run ID | 一轮被接受的具体执行，可排队、运行、等待工具或结束 | 发送请求后返回，在运行记录中检索 |
| Toolset version / binding | 工具定义版本与执行位置登记；配置不代表执行器已在线 | “工具”页面或配置接口 |
| Executor ID | 产品执行器的稳定身份，不等于某个 Worker 的租约 | 产品登记并持久保存 |

一条 Session 在首次运行时固定 Agent 版本；发布新版不会静默替换旧会话。要升级版本，新建会话或按产品流程显式切换。停用/归档逻辑 Agent 会阻止任何版本的新 Run，但已有记录仍可在权限范围内读取。[查看版本与状态](/docs/console/versions-lifecycle/)。

账号会话、MCP OAuth、应用 Key 的用途不同。运行 Key 的 `runtime:read` 与 `runtime:write` 独立；业务工具再需 `tools:execute`。Agent 限定 Key 不因此能读取全局配置或个人账单。[查看身份与权限](/docs/reference/authentication/)。
