---
title: "Agent 工作流"
description: "安全地把外部 agent 用在 flare.design：选择合适任务、提供画布上下文、管理权限，并把生成媒体放回项目。"
locale: "zh"
section: "MCP"
updated: "2026-06-28"
source: "https://flare.design/zh/docs/agent-workflows"
---

# Agent 工作流

安全地把外部 agent 用在 flare.design：选择合适任务、提供画布上下文、管理权限，并把生成媒体放回项目。

> 分类: MCP

[HTML](https://flare.design/zh/docs/agent-workflows) | [Markdown](https://flare.design/zh/docs/agent-workflows/index.md)

外部 agent 可以帮助 flare.design 项目读取画布、草拟修改、生成媒体，或自动执行聚焦编辑。目标不是把整个项目交出去，而是让人继续掌握方向，把边界清楚的任务交给 agent。

这篇讲产品工作流。如果你需要 endpoint、scope 和工具名，读 [配置 flare.design MCP](/zh/docs/configure-flare-design-mcp)。

## 适合交给 agent 的任务

当任务有清楚的画布上下文和结束条件时，agent 效果最好。

| 任务     | 合适的请求                                                  |
| -------- | ----------------------------------------------------------- |
| 画布评审 | “看一下选中的 frame，给出三个层级优化建议。”                |
| 文案变体 | “给这个 frame 做五个更短的标题版本，放到右侧。”             |
| 媒体改图 | “读取这张图片上的批注，把修改后的版本放在原图旁边。”        |
| 版式扩展 | “从这个 1:1 frame 做两个 9:16 版本，保持产品主体清楚。”     |
| 动效设计 | “给这个 frame 加一个克制的 motion plan，不要让每一层都动。” |
| 项目总结 | “列出这个项目的最终 frame、用到的媒体资产和导出检查清单。”  |

尽量避免只说“帮我优化一下”。如果要这样问，也补充哪些东西不能动：格式、品牌、受众、时长、文案或已有资产。

## 从画布上下文开始

画布是共同参考点。让 agent 写入前，先选中真正相关的 frame、图层、图片或 group。

有用上下文包括：

- 当前 frame 或选中的图层。
- 导出 frame 外的附近参考素材。
- 图片批注、箭头、裁切说明或文字评论。
- 资产名称、生成 prompt 和来源模型 metadata。
- 目标输出格式，例如 9:16 MP4 或 1:1 still。
- 不应改变的约束，例如品牌色、产品裁切、时长或已批准文案。

当 agent 能读取实时画布上下文时，它可以把新内容放在你的选区附近，而不是落在随机坐标。

## 有意识地管理权限

MCP 授权会把项目、画布、资产、生成和渲染能力分开。按任务授予最小权限。

| 需求                       | 权限                                                                          |
| -------------------------- | ----------------------------------------------------------------------------- |
| 总结或审查项目             | `projects:read`、`canvas:read`                                                |
| 放置已有资产或生成文件     | `projects:read`、`canvas:read`、`canvas:write`、`assets:read`、`assets:write` |
| 编辑文字、布局、层级或动效 | `projects:read`、`canvas:read`、`canvas:write`                                |
| 启动 Flare 后端生成任务    | 额外添加 `generation:create`                                                  |
| 启动云端渲染任务           | 额外添加 `render:create`                                                      |

写权限允许客户端改变画布。生成和渲染创建可能消耗 Flares、渲染额度或套餐用量，除非任务明确需要，否则不要打开这些 scope。

## 接受前先评审

把 agent 输出当成提案。保留原 frame，在替换任何内容前先比较。

一个干净的评审循环：

1. 复制 frame，或要求 agent 把变体放在原版旁边。
2. 检查文字可读性、裁切、节奏和品牌贴合度。
3. 保留最好候选，把被拒方向移出最终导出 frame。
4. 给有用的生成资产改名，方便之后搜索。
5. 只有当 frame 已经可读时，再导出短评审版。

如果一次编辑影响范围超出预期，先 undo 或回到之前保存的项目状态，再继续。

## 生成媒体

当 agent 在 flare.design 外生成或编辑图片时，应上传真实文件字节，再把返回的 asset 放到画布上。不要把 base64、data URL 或本地文件路径塞进 MCP JSON。

推荐流程：

1. Agent 生成或编辑一个本地图片文件。
2. 通过短时二进制上传会话上传文件。
3. 把返回的 asset 放在选中 frame 或目标图片旁边。
4. 你先对比新旧结果，再决定是否替换。

这样生成媒体会带着来源 metadata 留在资产库里，而不是变成匿名的 canvas-only 图片。

## 更好的提示词

给 agent 一个小角色、一个目标和一个边界：

- “使用选中的 9:16 frame，做三个开场标题处理。不要改产品图片。”
- “只参考图片批注。生成一个新版图片，上传后放在原图右侧。”
- “读取选中的 frame，设计 4 秒以内的动效。最后要保留 logo 可见。”
- “总结这个项目，告诉我哪些资产看起来没被使用。不要删除任何东西。”

短而具体的提示通常比长而模糊的 brief 更好。如果某件事比新鲜感更重要，就明确写成约束。

## 什么时候看配置文档

当你需要连接客户端、选择 scope、理解工具分组、上传生成媒体或做 smoke test 时，读 [配置 flare.design MCP](/zh/docs/configure-flare-design-mcp)。