修改学习白板
凭最新 readToken 提交知识地图补丁，或按明确绘图请求修改原始图形。
whiteboard_edit云端执行使用方式
必须先读取白板。学习地图优先使用 knowledgeMap：应用保留已有布局和注释，并布局新概念，只加入本次对话已经解释的知识。通常新增 1—4 个核心概念，修正现有概念时复用 ID；建议概念名 2—12 字、关系短语 2—8 字。聚焦一个主概念，最多三个；允许仅聚焦或空补丁而不改变绘图。 明确绘图请求可使用 upsert、deleteIds、name、layers、transform，但不能与 knowledgeMap 同次提交。新元素需要类型和合理的画布像素坐标；形状标签使用单独的 text 元素与 containerId 绑定。省略字段保留已有值，绑定标签及箭头端点自动跟随。线和箭头的 points 相对 x、y，首点必须是 [0,0]；端点绑定使用 elementId、side、gap，而非原生 focus 或 fixedPoint 元数据。 成功编辑立即持久化，并在下一次编辑前支持撤销。平移、缩放不改变令牌。出现过期或无效令牌必须重新读取和规划，不能盲目重试。
认证远程会话默认加载；执行前需要绑定学习白板。
在对话中描述需求，由 Agent 决定是否调用。以下是 Agent 工具参数，不是公开 HTTP API。
输入参数
readTokenstring · 必填精确复制 whiteboard_read 或最近成功编辑、撤销返回的短令牌，长度 1—40。不可编造；不可用或被拒绝时重新读取。示例中的占位符必须替换为真实值。
namestring · 可选白板名称，长度 1—100；属于原始白板操作，不能与 knowledgeMap 混用。
upsertarray<object> · 可选最多 100 个新增或更新的原始元素，每项必须有 id，长度 1—100，仅英文字母、数字、下划线和短横线。类型支持 rectangle、ellipse、diamond、text、arrow、line。新元素需提供 type 及合理 x、y；坐标范围 ±100000，宽高范围 1—10000。可设置文本、字体、对齐、颜色、描边、填充、透明度、圆角、分组、线点及箭头绑定等已定义字段。text 最长 2000 字符；标签用独立 text 和 containerId 绑定，每个容器一个标签，null 解绑。points 为 2—50 个相对坐标点，首点 [0,0]。绑定对象使用 elementId，可选 side 与 gap；gap 范围 1—100。elbowed 仅用于箭头，其路由控制 points 和 angle，角度必须为 0。
deleteIdsarray<string> · 可选原始图形删除 ID 列表，最多 100 项；每个 ID 长度 1—100，仅英文字母、数字、下划线和短横线。不能与 knowledgeMap 混用。
layersarray<object> · 可选最多 50 项图层调整，按提供顺序从后向前应用。每项必需 ids 与 placement；ids 包含 1—100 个唯一 ID。placement 为 front、back、above 或 below，above/below 必须提供 referenceId。整体移动分组及其绑定标签，不传原始小数索引。
transformobject · 可选在 upsert 后平移或旋转选区、分组。ids 与 groupId 必须且只能指定一个；ids 为 1—100 个唯一 ID。可选 dx、dy 范围 ±100000，rotateDegrees 范围 -360—360，pivot 为二维坐标；默认围绕选区边界中心。标签与箭头端点自动跟随，绑定箭头重新路由；肘形箭头不支持任意旋转。
knowledgeMapobject · 可选知识地图补丁，必须同时提供 nodes、edges、deleteIds、focusIds 四个数组。nodes 最多 60 项，每项含 id、label，label 长度 1—48；edges 最多 100 项，每项含 id、from、to、label，label 长度 1—24。地图 ID 长度 1—80，仅英文字母、数字、下划线和短横线。deleteIds 最多 100 个唯一 ID，focusIds 最多 3 个唯一 ID。同一用户轮次全部调用合计最多新增 6 个概念、8 条关系；数组容量不代表可以突破新增预算。不能与 name、upsert、deleteIds、layers、transform 同次使用。
调用示例
在先读白板、确认本次对话已解释且白板未重复存在这些概念后，用两个核心概念和一条关系更新地图，并聚焦知识地图。
{
"tool": "whiteboard_edit",
"arguments": {
"readToken": "<本次读取的readToken>",
"knowledgeMap": {
"nodes": [
{
"id": "knowledge_map",
"label": "知识地图"
},
{
"id": "concept",
"label": "概念"
}
],
"edges": [
{
"id": "map_contains_concept",
"from": "knowledge_map",
"to": "concept",
"label": "包含"
}
],
"deleteIds": [],
"focusIds": [
"knowledge_map"
]
}
}
}示例仅用于说明结构，不会在浏览此页时执行。
返回结果
成功后返回更新后的白板描述、readToken、canUndo、完整 knowledgeMap 和首批元素信息。知识地图修改还返回 mapEdit，其中含 addedIds、updatedIds、deletedIds、focusIds 及 changed。应继续使用返回的真实令牌，不得在工具失败时声称修改成功。
执行范围与限制
- knowledgeMap 与原始图形操作必须分开调用；即使字段为空也不能混用。
- 同一用户轮次全部调用合计最多新增 6 个概念和 8 条关系；不得通过拆分调用绕过预算。
- 只记录已在本次对话解释的知识，不将讨论内容标记为已掌握。
- 保留无关内容，未经请求不得清空白板；复用已有 ID，避免重复同义概念。
- 令牌无效、绑定变化或版本过期时重新读取并规划；不能盲目重试。
- 本示例仅展示合法输入结构，实际提交须先检查已有地图，并将 readToken 占位符替换为真实值。
文档对应部署版本 7f25f541a4e68cf36a2c8a1e55f4e4891e581966。模型生成于 2026/10/26 18:42（北京时间）。本页不读取用户会话的实时工具列表。