编辑文档
EditDocument¶
对 Macro Markdown 文档就地应用 AI 驱动的编辑——重写、插入、格式化或重构。对于 Macro 原生电子表格，请使用 EditSpreadsheet。仅限 Markdown 文档：这些文档是在 Macro 的协作编辑器中创作的，也是本工具唯一能重写内容的文档。如需编辑上传的 Word (.docx) 文件，请改用 ReadWordDocument 和 EditWordDocument。其他上传的文件——PDF、图片、源代码文件（如 .py 或 .ts）——可读但不可编辑，会被拒绝。如果响应包含 clarification 字段，请将所请求的信息附加到 instructions 后再次调用。要插入 @-提及 chips，请在 instructions 中包含每个引用项的 ID 和详细信息：人员使用 userId/email；文档、频道、聊天、项目、任务、邮件、日历事件、技能、通话和例程使用 documentId/documentName/blockName（必要时还需 blockParams）；代理会话使用 session id（以及可选的展开卡片）；时间芯片使用 ISO 日期时间加 displayFormat；预订链接使用 profileId/slug/url。要插入文档卡片，请包含每个文档的 documentId 和 documentName。
参数¶
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
document_id |
string | 是 | 要编辑的 Markdown 文档的 ID。如果不确定该文档是否为 Markdown，请先调用 ReadMetadata 并检查 fileType 是否为 md——在此处传入上传的文件会失败。 |
instructions |
string | 是 | 自然语言指令。对于 @-提及 chips，请包含每个项的 ID 和详细信息：人员使用 userId/email；文档及类似项使用 documentId/documentName/blockName；代理会话使用 session id；时间芯片使用 ISO 日期时间和 displayFormat；预订链接使用 profileId/slug/url。对于文档卡片，请为每个文档包含 documentId 和 documentName。你可能需要查询这些信息。 |
fast |
boolean | 否 | 对于一次快速、独立的编辑——重写此段落、翻译选定的列表、修复标题、将短语加粗——设为 true。单个模型会在几秒内直接完成。对于包含多个部分或需要重构文档的任务，请保留 false（默认值）；默认流程会规划、调度并审查自己的工作，耗时更长，但这是多步编辑所需要的。 |
本页原文 Markdown：在 AtomGit 查看·内容源自开源项目 macro3/macro