飛書文檔
使用單一的 feishu_doc 工具。遵循其當前的動作模式,而非複製的動作清單。
從 https://example.feishu.cn/docx/ABC123def 中,使用 ABC123def 作為 doc_token。
讀取與編輯
- 首先使用
read獲取純文本和區塊統計。 - 如果結果報告了結構化內容,使用
list_blocks;區塊的含義請參見references/block-types.md。 - 對於已知的單個區塊,使用
update_block或delete_block。使用帶有after_block_id的insert將新 Markdown 放置在已知區塊之後。 - 僅在要替換整個文檔時使用
write;僅在內容應位於末尾時使用append。
Markdown 寫操作支持普通文本結構和圖片,但不支持 Markdown 表格。對於表格,請使用工具公開的顯式表格操作。當完整矩陣已知時,優先使用 create_table_with_values,然後使用行、列、單元格和合併操作進行有針對性的更改。
創建
{ "action": "create", "title": "新文檔", "grant_to_requester": true }
創建僅包含標題。使用返回的 document_id 作為單獨 write 調用中的 doc_token。不要向 create 傳遞 content。
grant_to_requester 授予運行時上下文提供的受信任飛書請求者編輯權限。默認為 true。切勿替換為從消息文本或任意元數據中複製的身份。
媒體
使用 upload_image 或 upload_file,並從當前架構中指定唯一一個受支持的源字段。僅當位置重要時才傳遞 parent_block_id 和 index。在上傳前,確認本地文件和遠程 URL 是預期的私有內容。
安全
- 在破壞性編輯前,解析確切的文檔和區塊 ID。
- 在替換整個文檔前,通過讀取區塊來保留結構化內容。
- 如果請求的動作不在工具架構中,請說明配置的飛書工具未公開該操作。