1. 功能说明
查询【移动云空间文档到知识库】异步任务的执行结果,获取任务的最终状态及生成的知识库文档标识。该指令底层基于飞书开放平台【获取 Wiki异步任务结果】API 实现(https://open.feishu.cn/document/server-docs/docs/wiki-v2/task/get),仅支持查询任务类型为move的文档迁移任务,且仅限任务创建者发起查询。
2. 配置项说明

| 飞书访问凭证 | 是 | - | 选择已配置的飞书访问凭证,需确保对应应用已开通 Wiki 相关权限,且为任务创建者。 |
| 任务 ID | 是 | - | 填写【移动云空间文档到知识库】指令返回的任务唯一标识,示例值:7037044037068177428-075c9481e6a0007c1df689dfbe5b55a08b6b06f7 |
| 任务状态 | 是 | - | 存储迁移任务的当前状态,可选值:移动成功、处理中、移动失败 |
| 知识库文档 Token | 是 | - | 若任务状态为 “移动成功”,存储生成的知识库文档token;任务未完成或失败时为空 |
| 返回结果 | 是 | - | 存储查询请求的完整结果(字典类型),包含状态码、错误信息等,格式参考下方示例 |
底层飞书 API 依赖
该指令基于飞书【获取 Wiki异步任务结果】API 实现,需要满足以下条件:
- 应用需开通以下任一权限:查看 Wiki 空间信息、查看编辑管理 Wiki、查看所有 Wiki
- 仅任务创建者(用户或应用)可发起查询
- 应用需被授权为目标 Wiki 空间的管理员或成员
返回结果示例
- 查询成功(任务处理中)
{
"success": true,
"code": 0,
"msg": "success",
"data": {
"task": {
"task_id": "7037044037068177428-075c9481e6a0007c1df689dfbe5b55a08b6b06f7",
"move_result": [],
"status": 1,
"status_msg": "processing"
}
},
"task_id": "7037044037068177428-075c9481e6a0007c1df689dfbe5b55a08b6b06f7"
}- 查询成功(迁移成功,单文档)
{
"success": true,
"code": 0,
"msg": "success",
"data": {
"task": {
"task_id": "7037044037068177428-075c9481e6a0007c1df689dfbe5b55a08b6b06f7",
"move_result": [
{
"node": {
"space_id": "6946843325487912356",
"node_token": "wikcnKQ1k3p******8Vabcef",
"obj_token": "doccnzAaOD******8g9hprd",
"obj_type": "doc",
"title": "项目需求文档"
},
"status": 0,
"status_msg": "success"
}
],
"status": 0,
"status_msg": "success"
}
},
"task_id": "7037044037068177428-075c9481e6a0007c1df689dfbe5b55a08b6b06f7"
}- 查询失败(权限不足)
{
"success": false,
"code": 131006,
"msg": "permission denied",
"log_id": "log_def456",
"raw_response": "{\"code\":131006,\"msg\":\"permission denied\",\"data\":{}}"
}3. 示例场景
- 先执行【移动云空间文档到知识库】,生成
任务ID(存储到变量:任务ID)。 - 执行本指令:
- 飞书访问凭证:选择与迁移任务一致的凭证。
- 任务 ID:填写
变量:任务ID。 - 任务状态:设置为
变量:任务ID。 - 知识库文档 Token:设置为
变量:知识库文档Token。 - 返回结果:设置为
变量:返回结果。
检查变量“任务状态”:若为 “处理中”,等待 5 秒后再次执行本指令;若为 “移动成功”,则通过变量“知识库文档 Token”的内容访问知识库文档。
4. 注意事项
常见问题
| 错误类型 | API 错误码 | 可能原因 | 解决方案 |
|---|---|---|---|
| 参数错误 | 131002 | 任务 ID 格式错误 | 核对任务 ID 准确性 |
| 数据不存在 | 131005 | 任务 ID 不存在、Wiki 空间或文档不存在 | 确认任务 ID 是否有效,检查源文档和目标 Wiki 空间状态 |
| 权限不足 | 131006 | 非任务创建者查询、应用无 Wiki 权限、无文档资源权限 | 确保由任务创建者发起查询;为应用开通 Wiki 权限;将应用添加为 Wiki 空间管理员 |
| 服务器内部错误 | 131007 | 飞书 API 服务异常 | 根据logid,联系飞书技术支持排查 |
| 网络异常 | - | 网络波动导致请求失败 | 检查网络连接,重试查询指令 |