飞书文档 是做什么的?
使用单个 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 }
创建仅需标题。在单独的 write 调用中使用返回的 document_id 作为 doc_token。不要将 content 传递给 create。
grant_to_requester 向运行时上下文提供的受信任飞书请求者授予编辑权限。默认值为 true。切勿替换从消息文本或任意元数据中复制的身份。
媒体
使用 upload_image 或 upload_file,并严格按照当前模式中的一个受支持来源字段进行操作。仅在需要指定位置时传递 parent_block_id 和 index。上传前确认本地文件和远程 URL 是预期的私有内容。
安全
- 在进行破坏性编辑前,解析准确的文档和块 ID。
- 在替换整个文档前,通过读取块保留结构化内容。
- 如果请求的操作在工具模式中不存在,请解释所配置的飞书工具未公开该操作。