# Decision Agent REST 接入指南

Decision Agent REST 接入指南提供两种阅读方式：

## 聚合版

- [aggregate.md](./aggregate.md)
- 适合在一个页面中连续阅读全部 API 内容。
- `aggregate.md` 是通过脚本生成的文件，请不要直接修改。
- 如需调整聚合版内容，请修改 [index.md](./index.md) 或对应子章节文件后重新生成。

生成命令：

```bash
make -C docs/user_manual/api aggregate
```

## 分文件版

- [index.md](./index.md)
- 适合按章节阅读和维护。
- 子章节包括 Agent 生命周期、Agent 配置、发布与广场、对话、对话响应、增量流式、人工干预与终止、Debug 对话、会话/执行/缓存、导入导出与辅助接口。

## 可运行示例

- [../examples/api](../examples/api/README.md)
- 示例使用 Shell + cURL，并提供独立 Makefile。
- 默认运行 `make quick-check`；`make smoke` 是兼容别名。完整创建、发布、取消发布、删除流程运行 `make flow`。
