给 Agent 的使用入口
本页供读取公开网页的 Agent 定位可用能力和文档。当前生产协议为 1.0，MCP 为 0.1.2，Python/JS 客户端包为 0.2.5。不要把“找到一个网页或工具”解释为已获得用户授权。
按任务选择入口
| 用户请求 | 阅读入口 | 操作通道 |
|---|---|---|
| 创建、修改、发布或停用 Agent | MCP 接入 → 工具参考 → 配置配方 | OAuth 授权后的 https://api.hostanagent.com/mcp |
| 为产品用户发起或恢复对话 | 产品身份 → SDK → 运行参考 | 产品后端持有受限 Key，经 https://api.hostanagent.com/v1 |
| 指导用户操作控制台 | 快速开始和控制台指南 | 用户自己的网页登录会话 |
| 接入或核对业务工具 | 工具配置 → ToolRunner → 工具协议 | 产品验证身份、权限和业务结果后执行 |
| 调整上下文或排查工具内容缺失 | 上下文机制 → 配置与迁移 → 模型可见结果预览 | MCP/配置 REST 修改；控制台或工具 REST 预览 |
| 错误或结果不明 | 错误与限制 → 恢复 | 用原请求 ID、Run ID 和幂等键核对 |
MCP 只管理配置，不运行 Agent、读取余额或给账号充值。网页 Cookie 不充当 API Key，MCP OAuth token 也不能调用运行 REST。API Key 必须由用户在控制台创建，并由可信产品服务器保存；不要要求用户把密钥粘贴到网页、对话记录或脚本示例中。
操作前和操作后
当前整体窗口使用 limits.max_context_tokens，默认 256,000 Token；单工具执行结果使用 max_result_context_bytes，默认 16 KiB、最高 32 KiB。max_context_chars、max_result_bytes、max_result_tokens 已删除，不能从旧示例补回。已发布 npm 0.2.5 的配置类型尚未包含新字段，读取当前兼容说明后再生成请求。
读取配置或价格通常不产生模型费用。创建/修改/发布会改变用户配置；启动 Run 可能预留并消耗美元，调用业务工具还可能改变产品数据。分别核对身份、scope、Agent 范围、余额和产品业务许可。邮箱验证码、账户近期验证和 OAuth 同意需要用户在受信任页面完成。
写入时保留 request_id、版本 revision 和实际输入；响应丢失要查询已有结果或按原幂等语义重试。不要凭空创建新请求来“确保成功”。成功时向用户回报实际 Agent/版本/Run ID 和回读结果；失败时说明明确的错误码及下一步。完整机器目录见文档索引。