get_note_task_progress
Check the processing status of note creation tasks by polling with a task ID to determine when a linked note is ready or has failed.
Instructions
查询创建笔记任务的处理进度。用于链接笔记(note_type=link)创建后,通过 save_note 返回的 task_id 轮询任务状态,直到 status 变为 success(可获取 note_id)或 failed(可获取 error_msg)。建议每 10~30 秒轮询一次,约 3 分钟内完成。需要 note.content.read scope。
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| task_id | Yes | 任务 ID(创建链接笔记时 save_note 返回的 tasks[].task_id) |
Implementation Reference
- src/client.ts:120-127 (handler)The handler function in the client class that executes the API request to get the note task progress.
async getNoteTaskProgress(task_id: string) { return this.request<NoteTaskProgress>( "POST", "/resource/note/task/progress", undefined, { task_id } ); } - src/index.ts:137-151 (registration)The registration of the get_note_task_progress tool, defining its schema and description.
name: "get_note_task_progress", description: "查询创建笔记任务的处理进度。用于链接笔记(note_type=link)创建后,通过 save_note 返回的 task_id 轮询任务状态,直到 status 变为 success(可获取 note_id)或 failed(可获取 error_msg)。建议每 10~30 秒轮询一次,约 3 分钟内完成。需要 note.content.read scope。", inputSchema: { type: "object" as const, properties: { task_id: { type: "string", description: "任务 ID(创建链接笔记时 save_note 返回的 tasks[].task_id)", }, }, required: ["task_id"], }, }, {