文档采用“AgentCore 为主线,TokenHub 为模型 Gateway,能力与接口分层”的组织方式。这样用户先理解平台边界,再进入具体能力和字段。
目录骨架
| 层次 | 解决的问题 | 主要内容 |
|---|
| AgentCore 概念 | Agent 平台由什么组成? | Agent API、Runtime、Gateway、LTM、接入面和治理边界 |
| AgentCore 组件 | 每个组件负责什么? | TokenHub Gateway、Tool Gateway、LTM、Managed Chat |
| TokenHub 接口 | 如何访问和治理模型? | 协议、模型能力、Token、可靠性、用量和计费 |
| 接入指南 | 应用如何接入? | Public API、Managed Chat、CLI + Skills、Developer Platform |
| API 参考 | 字段和状态码是什么? | OpenAPI 生成的端点、请求体、响应体和错误码 |
归类规则
- 先按 AgentCore / TokenHub 判断责任边界,再决定页面属于概念、能力还是接入指南。
- TokenHub 的模型 Gateway 属于 AgentCore 组件,但 TokenHub 文档保留独立入口,因为普通应用也可以直接使用它。
- LTM、Tool Gateway、Agent API 和 Runtime 讲 Agent 侧状态与执行;协议、模型、Token 和调用治理讲 TokenHub 侧能力。
- API 参考保持字段精确;背景、取舍和完整流程放在概念或接入指南。
- 当前可用、建设中和规划中的能力必须显式标注。
- 保留既有 URL,通过侧边栏和交叉链接完成迁移,不为重分类制造破坏性链接变化。
旧内容的归位
| 现有内容 | 新的主归属 |
|---|
| 核心接口、生成端点、模型能力 | TokenHub |
| 计费、Token 计数、速率限制、Fallback | TokenHub / 治理 |
| LTM、Managed Chat、CLI + Skills | AgentCore / Agent 组件与接入 |
| Function Calling、MCP、外部工具接入 | AgentCore / Gateway |
| 通用排障、迁移和 SDK | 共享接入与运维 |
| OpenAPI 端点和字段 | API 参考 |
迁移顺序
- 使用 AgentCore 概览作为平台入口,解释组件关系。
- 把 TokenHub 明确为 AgentCore 的模型 Gateway,同时保留独立调用路径。
- 将 LTM、Gateway 和未来 Agent API / Runtime 放入 AgentCore 组件目录。
- 将模型协议、模型能力、Token、可靠性和计费归入 TokenHub 目录。
- 最后统一旧页面的标题、交叉链接和示例,保持原 URL 可用。