diff --git a/README.md b/README.md
index 34b5248cb..fef82815b 100644
--- a/README.md
+++ b/README.md
@@ -57,8 +57,8 @@ Core exposes two APIs:
 
 | API | Path | Used by |
 | --- | --- | --- |
-| **Agents API** | `/v1` | Your applications. Same protocol as OpenAI's |
-| **Core API** | `/core/v1` | Operators, through Web |
+| **[Agents API](docs/api/public-agent-api.md)** | `/v1` | Your applications. Same protocol as [OpenAI's Agents API](https://developers.openai.com/api/docs/guides/agents-api/overview) |
+| **[Core API](docs/api/README.md#core-api)** | `/core/v1` | Operators, through Web |
 
 Core keeps all state. The Runtime runs the chosen harness inside the Environment.
 Each connection is a defined protocol, so any part can be replaced on its own. See
diff --git a/README.zh-CN.md b/README.zh-CN.md
index 2f4008513..cc2313230 100644
--- a/README.zh-CN.md
+++ b/README.zh-CN.md
@@ -54,8 +54,8 @@ Core 对外提供两组 API：
 
 | API | 路径 | 调用方 |
 | --- | --- | --- |
-| **Agents API** | `/v1` | 你的应用，与 OpenAI 协议一致 |
-| **Core API** | `/core/v1` | 管理员，通过 Web 调用 |
+| **[Agents API](docs/api/public-agent-api.md)** | `/v1` | 你的应用，与 [OpenAI 的 Agents API](https://developers.openai.com/api/docs/guides/agents-api/overview) 协议一致 |
+| **[Core API](docs/api/README.md#core-api)** | `/core/v1` | 管理员，通过 Web 调用 |
 
 所有状态都由 Core 保存；Runtime 在 Environment 中运行所选 Harness。各部件之间都通过既定协议连接，
 任何一个都可以单独替换。详见[架构说明](docs/architecture.md)。