概览

为 Agent 添加私有数据库、类型化业务逻辑、LLM 可调用工具和侧边栏 UI。

## 本章内容

| 页面 | 主题 | 学完后可以做什么 |
|------|------|-----------------|
| [Agent 数据库](./models) | 定义 `.mod.yao` 模型、自动迁移数据表、在 Hook 和 MCP 工具中查询数据 | 拥有私有持久化存储的 Agent |
| [脚本与 Process](./scripts) | 将 TypeScript 函数导出为 Yao Process | 可从任意位置调用的可复用业务逻辑 |
| [MCP 工具（Yao Process）](./mcp) | 通过 `transport: "process"` 将 Process 映射为 MCP 工具 | 由自己代码驱动的 LLM 可调用工具 |
| [SUI 页面](./pages) | 构建 Agent 可跳转的侧边栏页面 | 对话中嵌入结构化 UI |
| [开源项目](./open-source) | 真实参考项目 | 找到完整的实现示例 |

## 学习路径

```
models.mdx          ← 先定义数据层
    │
    ▼
scripts.mdx         ← 将业务逻辑写成 Process
    │
    ▼
mcp.mdx             ← 将 Process 暴露给 LLM 作为 MCP 工具
    │
    ▼
pages.mdx           ← 添加 Agent 可跳转的侧边栏 UI
    │
    ▼
open-source.mdx     ← 在真实项目中查看完整实现
```

每一步都建立在上一步的基础上。学完后，你将拥有一个能存储数据、运行类型化业务逻辑、将其暴露为工具并在侧边栏展示结果的 Agent。

## 前置条件

- 已完成或浏览过 [Yao Agent](/tutorials/zh-cn/agent/yao-agent) 章节——你应该知道 Hook 是什么以及 MCP 工具从 Hook 侧如何工作。
- 一个运行中的 Yao 应用，至少有一个 Assistant（`package.yao`）。