46 lines
1.4 KiB
Markdown
46 lines
1.4 KiB
Markdown
# 模块管理
|
||
|
||
模块是 AgentFox 中端点的分组方式。导入 API 文档时，端点会自动按规则分组到不同模块中。
|
||
|
||
## 自动分组规则
|
||
|
||
导入 API 文档时，AgentFox 按以下优先级自动创建模块：
|
||
|
||
1. **OpenAPI Tags**：如果端点定义了 `tags`，按 tag 名称分组
|
||
2. **路径前缀**：如果没有 tags，按 URL 路径的第一段分组（如 `/users/...` → `users` 模块）
|
||
|
||
## 查看模块
|
||
|
||
在项目详情页的「模块」标签中，可以查看所有模块：
|
||
|
||
- 模块名称
|
||
- 模块中的端点数量
|
||
- 模块来源类型（tag / path_prefix / manual）
|
||
|
||
## 手动添加模块
|
||
|
||
1. 在「模块」标签页顶部，输入模块名称
|
||
2. 点击「添加」按钮
|
||
3. 新模块将显示在列表中（端点数量为 0）
|
||
|
||
手动添加的模块可用于重新组织端点。
|
||
|
||
## 删除模块
|
||
|
||
1. 在模块列表中，找到要删除的模块
|
||
2. 点击删除按钮
|
||
3. 确认删除
|
||
|
||
> **注意**：删除模块会同时删除模块中的所有端点。此操作不可撤销。
|
||
|
||
## 模块对 MCP 工具的影响
|
||
|
||
模块直接影响 LLM 的查询体验：
|
||
|
||
- `get_project_overview` 返回所有模块的 ID 和端点数量
|
||
- `list_modules` 返回模块的详细描述
|
||
- `list_endpoints` 需要传入 `moduleId` 来查看特定模块的端点
|
||
- `search_endpoints` 可选传入 `moduleId` 来限定搜索范围
|
||
|
||
合理的模块划分有助于 LLM 更快定位到所需的端点。
|