# 给 Agent 的使用入口 本页供读取公开网页的 Agent 定位可用能力和文档。当前生产协议为 1.0，MCP 为 0.1.2，Python/JS 客户端包为 0.2.5。不要把“找到一个网页或工具”解释为已获得用户授权。 ## 按任务选择入口 | 用户请求 | 阅读入口 | 操作通道 | |---|---|---| | 创建、修改、发布或停用 Agent | [MCP 接入](/docs/mcp/quickstart/) → [工具参考](/docs/mcp/tools/) → [配置配方](/docs/mcp/recipes/) | OAuth 授权后的 `https://api.hostanagent.com/mcp` | | 为产品用户发起或恢复对话 | [产品身份](/docs/integration/backend-auth/) → [SDK](/docs/integration/overview/) → [运行参考](/docs/reference/runtime/) | 产品后端持有受限 Key，经 `https://api.hostanagent.com/v1` | | 指导用户操作控制台 | [快速开始](/docs/start/quickstart/)和[控制台指南](/docs/console/overview/) | 用户自己的网页登录会话 | | 接入或核对业务工具 | [工具配置](/docs/console/tools/) → [ToolRunner](/docs/integration/tool-runner/) → [工具协议](/docs/reference/tools/) | 产品验证身份、权限和业务结果后执行 | | 调整上下文或排查工具内容缺失 | [上下文机制](/docs/concepts/execution-and-cost/) → [配置与迁移](/docs/reference/configuration/) → [模型可见结果预览](/docs/reference/tools/) | MCP/配置 REST 修改；控制台或工具 REST 预览 | | 错误或结果不明 | [错误与限制](/docs/reference/errors-limits/) → [恢复](/docs/integration/recovery/) | 用原请求 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 的配置类型尚未包含新字段，读取[当前兼容说明](/docs/releases/compatibility/)后再生成请求。 读取配置或价格通常不产生模型费用。创建/修改/发布会改变用户配置；启动 Run 可能预留并消耗美元，调用业务工具还可能改变产品数据。分别核对身份、scope、Agent 范围、余额和产品业务许可。邮箱验证码、账户近期验证和 OAuth 同意需要用户在受信任页面完成。 写入时保留 `request_id`、版本 revision 和实际输入；响应丢失要查询已有结果或按原幂等语义重试。不要凭空创建新请求来“确保成功”。成功时向用户回报实际 Agent/版本/Run ID 和回读结果；失败时说明明确的错误码及下一步。完整机器目录见[文档索引](/docs/index.json)。