71 lines
2.5 KiB
Markdown
71 lines
2.5 KiB
Markdown
# 飞书知识库内容读取技能
|
||
|
||
## 功能说明
|
||
批量读取飞书知识库中指定文档及其所有子文档的内容，支持结构化提取文档内容，用于后续分析、整理和同步。
|
||
|
||
## 使用场景
|
||
1. 需要批量获取知识库中某目录下所有文档内容
|
||
2. 需要读取指定文档及其子文档做内容分析
|
||
3. 需要迁移或备份知识库内容
|
||
4. 需要同步知识库内容到其他存储位置
|
||
|
||
## 前置条件
|
||
- 已获取飞书用户授权（包含知识库读取权限）
|
||
- 已知目标文档的飞书URL或node_token
|
||
|
||
## 操作步骤
|
||
|
||
### 1. 获取文档子文档列表
|
||
如果需要读取目录下的所有子文档，先调用接口获取子文档列表：
|
||
```json
|
||
{
|
||
"name": "feishu_wiki_space_node",
|
||
"parameters": {
|
||
"action": "list",
|
||
"parent_node_token": "<目标文档的node_token>",
|
||
"space_id": "<文档所在知识空间的space_id>"
|
||
}
|
||
}
|
||
```
|
||
- 可以通过文档URL提取node_token，例如URL：`https://makee-interactive.feishu.cn/wiki/R8REwpLPxikYUEkLsdCcGy7pnCh` 中的 `R8REwpLPxikYUEkLsdCcGy7pnCh` 就是node_token
|
||
- space_id可以通过get接口查询文档信息获取
|
||
|
||
### 2. 读取单个文档内容
|
||
对每个子文档，调用接口读取内容：
|
||
```json
|
||
{
|
||
"name": "feishu_fetch_doc",
|
||
"parameters": {
|
||
"doc_id": "<子文档的node_token或URL>"
|
||
}
|
||
}
|
||
```
|
||
- 支持直接传入文档URL，工具会自动解析node_token
|
||
- 返回内容为Markdown格式，保留文档结构、表格、链接等元素
|
||
|
||
### 3. 批量读取完整流程示例
|
||
```
|
||
# 第一步：获取目录下所有子文档
|
||
GET子文档列表 → 得到所有子文档的node_token和标题
|
||
|
||
# 第二步：遍历读取每个子文档
|
||
FOR 每个子文档 IN 子文档列表:
|
||
读取子文档内容 → 保存到本地或内存
|
||
|
||
# 第三步：内容处理（可选）
|
||
合并/整理/分析读取到的所有文档内容
|
||
```
|
||
|
||
## 示例
|
||
### 读取「L2 数据分析」目录下所有子文档
|
||
1. 目标文档URL：`https://makee-interactive.feishu.cn/wiki/R8REwpLPxikYUEkLsdCcGy7pnCh`
|
||
2. 调用`feishu_wiki_space_node`的list接口，获取到3个子文档
|
||
3. 分别调用`feishu_fetch_doc`读取每个子文档内容
|
||
4. 得到所有3个文档的完整Markdown内容
|
||
|
||
## 注意事项
|
||
1. 每个子文档的读取需要单独调用接口
|
||
2. 如果文档内容过大，需要使用offset参数分页读取
|
||
3. 需要确保用户已授权知识库读取权限，否则会返回授权失败
|
||
4. 文档中的图片、附件等资源需要单独调用下载接口获取
|