# 在画布上标请求，让外部 AI 接着想

URL: https://mindmax.me/zh/docs/guides/canvas-requests-with-an-agent/
Last verified: 2026-11-11

> 在 MindMax 画布的一张卡片或某个要点上标一句请求，把那句话递给连上的 AI 应用，答案便会以新卡片长回你指的那条分支；本页也说明不同宿主各自会怎么呈现这张板。

## 在画布上标请求，让外部 AI 接着想

画布请求是你留在**一张卡片上、或它下面某个要点上**的一个标记：请连上的 AI 应用从这一点接着想。
请求作为数据跟着卡片走，应用下次来访时读到它，答案则以新卡片挂到你指的那条分支下。MindMax 不会
去叫醒应用：标好请求，只是替你复制好一句话，由你粘到应用里。整个交接就是一句话，不是一个排进队列
的任务。

这条路适合要分几轮慢慢长的工作。只想一轮就把问题铺开，读
[和你的 AI 应用一次把难题铺到画布上](https://mindmax.me/zh/use-cases/open-a-question-on-canvas-with-your-agent/)更短；
[在画布上思考](https://mindmax.me/zh/docs/guides/thinking-on-the-canvas/)讲的是这块板本身。

## 开始之前[​](https://mindmax.me/#before-you-start)

- 一张画布，在 MindMax 打开的文件夹里，上面至少有一张你想往下拽的卡片。

- 一个以**协作**权限[连上的应用](https://mindmax.me/zh/docs/getting-started/connect-an-ai-agent/)——加卡片是写操作。

- 把画布切到前台，这样「这张卡」才没有歧义。

## 标一个请求[​](https://mindmax.me/#mark-a-request)

- 把鼠标停在卡片下方某个要点上，按**交给 {应用}**；或者打开卡片的 **⋯** 菜单，
选**交给 {应用}…** 针对整张卡。只有连上了可写的外部应用，这些入口才会出现。

- 写下你要什么——「比较这两个选项」「这件事要成立，什么条件得先成立？」——也可以什么都不写。
空请求的意思就是_顺着这里继续想_。

- 卡片上多出一条小小的署名条，写着有几条请求在等；同时弹出一个提示，提供**复制那句话**。
画布顶栏在等待数旁边也有同样的**复制提示词**。

处理我在 MindMax 画布《Q3 定价方案》上标的请求，把你的新卡加在我标的那些卡下面。

把这句话粘到应用里发出去就行。**复制本身不改任何东西**：画布会把请求留在等待状态，直到应用真的
读到并回答它。按钮为什么是「写一句话」而不是「提交」，见
[把工作交给 AI 应用](https://mindmax.me/zh/docs/guides/handing-work-to-an-agent/)。

## 应用读到什么[​](https://mindmax.me/#what-the-app-reads)

| 步骤 | 发生了什么 | 工具 |
| --- | --- | --- |
| 「这一个」 | MindMax 报出前台的画布、选中的卡片、最后点过的要点，以及通往它的分支路径 | get_active_context 带 canvasSelection |
| 等待中的请求 | 一组 canvas_request 条目，默认只给 pending 的，id 形如 canvas-ask:@ | get_annotations |
| 只有变化的部分 | 把上次读回的「读取时间」传回来，就只拿到增量 | read_canvas {since} |
| 整张板 | 卡片、每张卡是谁写的、卡下的要点、画出的关系——也包括你答过的题和深挖过的分支 | read_canvas |

应用随后用 `add_canvas_cards` 写卡片，把它们挂到你标的那张卡（和那个要点）下，并在 `answering` 里
点名请求 id。这一步把请求标成已处理，并指向新卡片。短一点的回复也可以走 `reply_to_comment`，带上
`canvas-ask:` 的 id。卡片上的署名条于是变成「已回复」并给出新卡片的链接；答得不对可以重新打开请求，
也可以删掉它。

## 你会看到什么[​](https://mindmax.me/#what-you-will-see)

你会看到什么，取决于宿主用的是哪一档。一轮结束时 `show_canvas` 只调用一次，三档都能调，差别只在
**图怎么显示**：

| 宿主 | 你会看到 | 应用告诉你什么 |
| --- | --- | --- |
| 支持交互卡片的宿主（含 ChatGPT 桌面版） | 聊天里一张可点的画布卡片；点某张卡，就能让应用顺着它继续展开 | 一两句话，说明加了什么、去哪看 |
| 多数其他桌面宿主 | 文字后面跟一张整张画布的图，新增的卡片高亮出来 | 一两句话，说明加了什么 |
| 终端宿主（Claude Code、Codex） | 聊天里没有图。 MindMax 把画布提到自己的窗口前台 | 「已经在那里打开了（附链接），新增的卡片写了这些」 |

**没看到图，不等于什么都没画出来。** 卡片无论如何都已经进了画布文件。用终端宿主时切回 MindMax，
板已经在前台，新卡片就在眼前。档位在连接那一刻由宿主声明的能力决定，没有开关可以改。

一轮之后的板：新卡片从你标的那条分支长出来，每张都署着写它的应用名。

## 应用能改什么[​](https://mindmax.me/#what-the-app-may-change)

它可以**新增**卡片和要点，用 `link_canvas_cards` 在卡片之间画支持、反驳或引用关系，也能用
`revise_canvas_card` **改它自己写的卡片**。对 MindMax 生成的卡片，它只能追加要点；对你写的卡片，
修改会被拒绝。移动卡片、换颜色、删卡片、重写你的卡片，工具集里根本没有对应的工具——这些始终留在
MindMax 里由你做。你答过的问题卡可以用 `grade_canvas_answers` 批改，它会给你的答案加一句评语和一个
结论。

一条分支定下来之后，用带 `fromCanvas {path, nodeId?}` 的 `create_document` 把它写成一篇新文档，
再把一张链过去的文档卡挂回画布，于是板上看得出哪条分支变成了哪篇笔记。
[和你的 AI 应用一起构思产品](https://mindmax.me/zh/use-cases/brainstorm-a-product-with-your-agent/)把这条路从头到尾
走了一遍。

## 常见问题[​](https://mindmax.me/#common-problems)

**请求还停在等待。** 你复制了那句话却没发出去，或者应用用的是只读连接。到应用里发出去，再回头看
卡上的署名条。

**新卡片长到了顶层，没在我标的要点下面。** 在句子里点名那张卡片，复制时让它保持选中，这样
`canvasSelection` 才带得着分支。

**应用想重写我的卡片。** 这是设计上就拒绝的。让它改成加一张新卡——原来那张仍然是你的。

**Claude Code 说画布打开了，却什么都没显示。** 它是在 MindMax 窗口里打开的。切过去就好；应用的
回复里应该带着链接和新卡片的摘要。

## 接下来[​](https://mindmax.me/#next)

- [用 AI 应用跑长任务](https://mindmax.me/zh/docs/guides/long-jobs-with-an-agent/)——当这次要想的事需要一整套方法，
而不是一轮卡片。

- [与外部 AI 应用协作](https://mindmax.me/zh/docs/guides/working-with-an-external-ai-agent/)——完整的能力地图。

最后于 **2026年11月11日** 更新