> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs-staging.joytokens.ai/llms.txt.

# Agent工作台

> 发现并使用精选垂类场景 Agents，完整体验一键生图 Agent 的使用流程

## 快速开始：进入工作台并开始对话

### 进入 Agent 工作台

1. 登录 JoyToken，在首页点击「Agent工作台」。
2. 进入「我的 Agent」，查看已有 Agent。
3. 点击左侧「开启新话题」，使用内置「JoyToken Agent」；也可在「我的 Agent」选择目标 Agent，点击「进入会话」。
4. 要使用市场中的其他 Agent，先完成下文的添加和装配，再进入会话。

| 入口        | 用途                               |
| --------- | -------------------------------- |
| Agent 工作台 | 对话、Agent 配置、Skill、MCP、知识库、任务和交付物 |
| API 控制台   | API Key、模型调用策略、额度、用量及账务          |

### 选择默认模型 API Key

1. 打开「工作台设置」。
2. 在「默认模型 API Key」中选择已有 Key，检查名称、状态和过期时间。
3. 滚动到页面底部，点击「保存设置」。
4. 返回目标 Agent 的会话，输入需求。

没有可用 Key 时，点击「管理 Key」进入当前环境的 Key 管理。创建 Key 后还要在工作台选择并保存；同时检查 Key 预算、日配额、模型权限与账户余额。

![工作台设置：选择默认模型Key后保存。](/_fern-files/_img/32d9ce85166d1a7e7456befc56959cee7b81037c265ac0c261ef9f03f006c547.webp)

工作台设置：选择默认模型Key后保存。

### 输入需求并检查结果

输入区支持 Enter 发送、Shift+Enter 换行，显示 4,000 字符上限。可以使用下面这段示例：

```text
请把以下记录整理成待办表，列为事项、负责人、截止日期。
没有提供的信息写“未提供”，不要推测。
小林整理演示资料，截止日期未定。
小周在2026年11月6日前校对页面文字。
2026年11月9日前汇总试用反馈，负责人未定。
请生成可下载的“会议待办清单.md”。
```

回复后查看结果，按提示完成工具授权，并下载文件检查。继续同一工作可留在原话题；独立工作使用「开启新话题」。

![用中文提交目标、交付格式和验收标准。](/_fern-files/_img/b9e4e53f5ac6f6b9e1fc250a3edc29fb2ba915d8f499218ea5b7265ffea0625b.webp)

用中文提交目标、交付格式和验收标准。

## 导航、话题与任务

| 位置    | 入口与用途                             |
| ----- | --------------------------------- |
| 工作台侧栏 | 「Agent」下列出已有 Agent；旁边「新建」打开创建方式弹窗 |
| 市场分组  | 「Agent」「Skill」「MCP」分别打开对应市场       |
| 知识库分组 | 「知识库」打开列表，「新建」创建知识库，下方可直接进入已有库    |
| AIGC  | 「生图专区」「视频专区」                      |
| 历史入口  | 「最近话题和任务」用于查找和继续历史话题              |
| 会话侧栏  | 「返回工作台」「开启新话题」「Agent 档案与配置」       |
| 设置与账务 | 「工作台设置」「API 控制台」                  |

进入「最近话题和任务」，点击 Agent 行左侧的展开按钮，再选择话题。页面提供「任务状态」筛选、「隐藏空话题」和「查看积分消耗明细」。话题是交流记录；任务有独立目标和状态；一次任务运行对应一条执行记录。

在会话中使用「编辑并重新发送（不修改历史）」可调整输入后重新发送，原消息保留在历史记录中。

## 工作台设置

### 默认 Key 与 Agent 专属 Key

工作台默认 Key 供未指定专属 Key 的 Agent 使用。在 Agent 的「绑定 API KEY」中可以选择「跟随用户默认 Key」或绑定专属 Key。Agent 专属绑定优先于工作台默认绑定；专属 Key 失效时应检查并调整配置。

### 记录保留、工具与记忆

「会话和任务存储时间」中的「存储天数」接受 1–3650 天，同时作用于会话和任务记录。修改后点击页面底部「保存设置」。

「Agent 内置工具」分为默认启用的「基础工具」和可选择的「可选工具」，用于设置新建 Agent 的初始能力。

调整已有 Agent 的工具，请进入该 Agent 的「配置装配」；调用需要授权的工具时，按提示确认。

「启用记忆功能」允许从对话提取偏好和信息；「自动压缩上下文」在接近上下文上限时生成历史摘要。

调整保留时间前，先下载需要长期保存的结果。

## 创建、添加和配置 Agent

### 三种创建方式

在侧栏点击 Agent 旁的「新建」，或在市场页面点击「新建 Agent」，选择创建方式。

| 方式            | 用途                 |
| ------------- | ------------------ |
| 通过对话创建 Agent  | 描述需求，在对话中逐步完善配置    |
| 从市场添加 Agent   | 浏览已有 Agent，并进入添加流程 |
| 从空白模板创建 Agent | 自行填写名称、角色、提示词和能力   |

![新建助理的三种方式。](/_fern-files/_img/38fa4ef1a3d4f5a9096f7be75c219053838222bbf4b065b6913d724ea336011e.webp)

新建助理的三种方式。

选择空白模板后，页面标题为「创建 Agent · 配置 Agent 装配」。在「身份与提示词」填写名称、简介、提示词和可选欢迎消息；名称和提示词必填。展开「更多身份设置」可填写最多 4 条开场问题。按需检查「生成参数」，添加 Skill、MCP、知识库并选择 Key，最后点击「创建 Agent」或「创建并进入会话」。

![在身份与提示词区域填写职责和回答规则。](/_fern-files/_img/77df77f09935928900e27d4a54974060912086875e26389419ade71850eba20c.webp)

在身份与提示词区域填写职责和回答规则。

### 从市场添加

1. 在「市场」分组点击「Agent」，进入「Agent 市场」页签，按名称或分类查找。
2. 点击卡片或「前往添加」进入详情。
3. 在「概览」「设定」「装配」「相关」「版本」中查看用途、提示词、能力和版本信息。
4. 需要手动添加时，在「添加方式」选择「我是 Human」，按说明点击页面上方「添加」。
5. 确认出现「已添加」，并在「我的 Agent」找到该 Agent。
6. 点击「配置装配」检查能力和 Key；保存后通过「进入会话」开始使用。

也可选择「我是 Agent」，将接入 Prompt 复制给 AI 助手，按指引完成添加。内置「JoyToken Agent」可直接使用。

### 编辑已有 Agent

在「我的 Agent」卡片或个人详情页点击「配置装配」，修改身份、提示词、Skill、MCP、知识库和 Key。编辑后点击「保存配置」或「保存并进入会话」。需要查看能力信息时，可打开详情页的「装配」页签。

![在「我的 Agent」中选择中文示例“会议纪要助手”。](/_fern-files/_img/f0eae2699e387ac23c89d49f8eb4fa3a53eb366a6e95cd92d6a214c9d49c618c.webp)

在「我的 Agent」中选择中文示例“会议纪要助手”。

## Skill：导入与装配

### 导入自己的 Skill

1. 在市场分组点击「Skill」，进入「Skill 市场」，点击「导入 Skill」。
2. 选择「导入方式」，填写「Skill 名称」「Skill 描述」。默认表单可上传 UTF-8 Markdown 文件或粘贴「Markdown 正文」，也提供远程链接和 ZIP 导入方式。
3. 按对应表单提示填写，点击「确认导入」。Markdown 正文上限为 1 MiB，即 1,048,576 字节。
4. 到「我的 Skill」检查导入结果。使用市场中的 Skill 时，点击卡片上的「前往导入」，打开详情并按提示导入。

### 装配到Agent

1. 打开可编辑Agent的「智能体档案与配置」。
2. 在「启用 SKILLS」点击「添加 Skill」。
3. 在选择面板中找到个人技能并勾选。
4. 点击「确定」，再保存Agent配置。
5. 新建或进入该助手话题，提交符合技能用途的输入。

技能详情也提供「启用到我的 Agent」。单纯导入不会自动绑定所有助手。

Skill是工作方法和资料，不会自动提供通用代码沙箱、OCR或任意文件编辑能力。

## MCP：获取、绑定与故障处理

### 从市场获取

1. 打开「MCP市场」，选择服务。
2. 在详情查看简介、工具、Schema、版本及授权要求。
3. 点击「添加到我的连接」。
4. 到「我的MCP」打开个人连接，检查状态及工具。

### 添加到Agent

1. 打开Agent「智能体档案与配置」。
2. 点击「添加MCP」。
3. 勾选已获取的服务，点击「确定」。
4. 保存配置，进入会话。
5. 明确提出需要该工具的任务，检查实际结果。

### 个人连接详情

可查看连接名称、标识、远端服务器标识、启用状态、鉴权配置和工具权限。自建连接按当前表单设置地址和凭据；不要将模型Key当作第三方工具凭据。

### 出错时

依次区分：

1. 配置未保存、未绑定；
2. 连接或工具不可用；
3. 当前操作未获授权；
4. 模型调用失败，还没有完成工具使用；
5. 工具返回失败或没有结果。

## 知识库：从上传到引用

### 创建知识库

1. 从「知识库」点击「新建」，或在知识库页点击「新建知识库」。
2. 填写「知识库名称」，描述为可选项。
3. 点击「创建知识库」。
4. 在库列表中点击「查看」进入。

知识库当前按个人可见范围管理；页面明确显示「仅自己可见」。

### 上传文件

空库提供「上传文件」「上传文件夹」。已有文件时，通过「＋ 添加」继续添加。

当前页面列出的格式为pdf、doc、docx、xls、xlsx、pptx、md、markdown、txt、ipynb、html、htm，单个文件不超过100 MB。文件夹内文件会平铺保存，不能假设保留原目录结构。

上传后按服务端状态观察「排队中」「已就绪」等变化。界面尚未更新时可稍后重新进入，但不要重复上传相同文件来催进度。

![中文知识库“产品发布会议资料”与已就绪的会议记录。](/_fern-files/_img/e0e89ad5a03f40a71529914f92f708f5569b41dba8fcc1c0205ebd48f34710d4.webp)

中文知识库“产品发布会议资料”与已就绪的会议记录。

### 文件详情与预览

在知识库的文件列表中点击「预览」，打开「文件详情」。这里分为文件信息与正文预览：前者说明文件有没有完成处理、能否参与检索；后者用于检查上传的是不是正确内容。

**字段说明：**

| 字段        | 含义                                 |
| --------- | ---------------------------------- |
| 大小、文件类型   | 大小是已上传文件的字节量；类型表示PDF、DOCX、MD等文件格式。 |
| 分块        | 文档被拆成可供检索使用的内容片段数量。                |
| 解析 / 分块状态 | 将文件内容提取出来，再组织为检索片段的处理阶段。           |
| 向量化状态     | 把内容片段转换为用于相关性查找的数字表示。              |
| 状态        | 服务端返回的整体处理状态。                      |
| 启用        | 文档当前是否允许在相应资料范围内被使用。               |
| 上传者       | 记录是谁上传该文件。                         |
| 上传时间      | 本次将文件保存到知识库的时间。                    |

**正文预览：**

正文区域通过临时下载地址展示当前文件。重点核对标题、关键字段、文字是否完整，以及是不是期望的版本。不同文件类型的展示方式可能不同。

当前详情提示预览链接默认30分钟有效。链接过期时，关闭详情再重新打开，以获取新地址。

![文件详情：中文源资料、分块数量和处理状态。](/_fern-files/_img/6501c57184a0a642e30716610883b0bbd7f130162fd443dd0b58899207d716da.webp)

文件详情：中文源资料、分块数量和处理状态。

### 绑定并检索

1. 打开可编辑Agent的配置。
2. 点击「添加知识库」，勾选已有库并确定。
3. 保存配置。
4. 进入该助手话题，明确要求依据已绑定资料回答。
5. 核对回答和来源，资料未覆盖的内容应说明缺失。

附件与知识库不同：附件服务当前输入；知识库是可反复检索的资料。

## 会话、附件和检查器

### 输入与附件

输入区支持Enter发送、Shift+Enter换行；空输入框按↑可查看输入历史，Escape退出相关状态。

通过「＋」添加文件。当前会话附件区最多显示10项，并提供「清空附件」。附件上传表单接受的类型与知识库上传不完全相同，请按当前选择框和错误提示处理。

发送时应同时写明怎么处理附件。例如“提取待办”比“看看这个文件”更容易获得确定结果。

### 工具调用审批

模型提出需要授权的动作后，会显示「工具调用审批」，列出工具名与参数。

| 操作      | 含义                             |
| ------- | ------------------------------ |
| 允许本次    | 批准当前操作                         |
| 本会话始终允许 | 对当前会话中的相应行为采用界面描述的放行方式，使用前确认范围 |
| 拒绝      | 不批准该操作                         |
| 取消调用    | 取消当前待处理调用                      |

修改外部数据、媒体生成等操作不能只凭助手说“开始了”判断已获批准。等待授权时先处理弹窗，再看最终状态。

### 检查器

点击输入区「检查器」，查看「概览」「路由」。

概览可显示请求ID、Key、策略、档位、实际模型、积分、Token、缓存及耗时。没有返回某字段时按“未提供”。

### 重试、停止与历史

区分三个对象：会话保存交流历史；会话中“正在生成”的是当前这一轮回复；任务和媒体还有各自独立的执行状态。

**重试：**

点击消息处的「重试」，等待本次返回结果；重试可能产生新的调用与费用。

**停止：**

当前回合运行中可以使用停止操作，或按页面提示使用Escape。点击后等待状态更新，确认本轮已结束；已经输出和保存的内容可继续回看。

如果该回合已经启动独立任务，还需到任务详情查看是否需要「取消运行」；图片或视频已经提交到上游时，还要检查对应媒体状态。关闭页面、切换话题、删除消息和停止生成不是同一动作。

**回看历史：**

* 通过「最近话题和任务」找到对应Agent和话题，打开原有消息。
* 回看独立任务时，打开任务详情的「执行历史」，按运行时间、触发方式或序号选择一次执行，再点击「查看会话」。
* 核对交付物属于哪一次执行，区分首次运行、重试和定时产生的结果。

## 文件交付：Word、Excel、PPT和PDF

明确告诉Agent文件类型、文件名和结构。例如：

```text
根据刚才确认的待办表：
生成一份Word纪要和一份Excel表格。
另外生成PDF和3页PPT，PPT包含主题、待办、待确认。
请实际生成可下载文件。
```

完成后，消息中会出现文件卡片和下载入口。下载后检查：

| 格式               | 建议检查              |
| ---------------- | ----------------- |
| Word             | 标题、段落、表格、缺失值是否正确  |
| Excel            | 工作表、列名、行数、日期和数据类型 |
| PPT              | 页数、主题、每页要点，是否有空页  |
| PDF              | 能否打开、页数、文字及表格布局   |
| Markdown/CSV/TXT | 编码、结构和文本是否完整      |

文件卡片显示成功后仍需核对内容。长文档可能经历分段草稿，等待最终文件入口出现后再下载。

任务内生成的文件归属具体执行记录。同一任务多次运行会产生各自的文件，不应混淆版本。

![中文任务交付：下载“会议待办清单”并核对事项、负责人和截止日期。](/_fern-files/_img/4d1573ba1e50ea17caf6afb501cee6cd9a92c32d5f424290d6eb6361acab5050.webp)

## 任务：创建、运行与确认验收

### 在会话中创建

```text
创建并立即执行一个任务，名称“说明检查”。
输出三条使用说明检查点，生成Markdown文件。
验收标准：恰好三条检查点，并有实际文件。
```

只要求创建时，任务可以保持待处理；要求执行后，应出现实际执行记录。

### 任务详情

从会话里的任务卡片进入。主要内容包括：

| 区域      | 内容                     |
| ------- | ---------------------- |
| 页头      | 名称、状态、积分与Token、执行Agent |
| 任务明细    | 目标、执行步骤、输出要求           |
| 执行配置    | 执行频率、时区、下次运行、调度状态      |
| 交付物     | 交付内容和文件                |
| 执行日志/历史 | 每次运行、触发方式、状态及「查看会话」    |
| 模型请求留痕  | 可用的模型调用记录              |

### 运行和验收

1. 点击「运行」启动一次执行。
2. 等待执行结束，查看输出和文件。
3. 如果任务状态为「待验收」，检查结果后点击「确认验收」。
4. 任务转为「已完成」。

执行完成与任务验收分别记录。 执行历史显示“已完成”时，任务仍可能等待用户验收；助手自行写“验收满足”也不代替你的确认。

![“会议待办整理”任务在人工复核后确认验收。](/_fern-files/_img/34dc654e9f5935c17245540f97c6d6c4d59682e1da1e8a134c182301cd257981.webp)

### 修改、步骤与取消

「编辑」用于调整目标或要求；「添加步骤」补充计划。运行中步骤可能只允许更新状态，按提示处理。

再次运行会增加执行记录。点击「查看会话」可以回看该次独立过程。

删除任务、取消运行和删除文件分别作用于不同对象，操作前确认目标。

## 定时计划

### 配置计划

1. 在任务详情「执行配置」点击「设置计划」。
2. 选择重复频率和执行时间。
3. 填写或核对时区，例如Asia/Shanghai。
4. 选择「启用」，点击「保存」。
5. 核对任务显示的下次执行时间。

### 手动与定时分别记录

手动运行和定时运行可以属于同一任务的不同记录。查看文件、用量或结果时，选择对应的一次执行。

### 停用和删除计划

在执行配置的「编辑」中停用计划，或使用该区域的「删除」。

删除确认框说明任务将不再自动运行，任务本身不受影响。确认后，执行频率恢复为「仅手动触发」，下次执行为空；历史运行和文件仍保留。

## 查看用量与账单

工作台显示的会话汇总、单次检查器和控制台账务可能有不同统计时机及覆盖范围。对账时以「用量明细」的已结算记录为准。

1. 从工作台进入「API控制台」。
2. 打开「用量」，选择时间范围和Key。
3. 切到「用量明细」。
4. 点击某条记录「详情」，核对输入、输出、缓存、推理等计量项以及当次单价。
5. 需要定位时展开「更多信息」。

金额较小时页面可能显示“\<0.01积分”；详情能显示更精确的费用。

## AIGC：生图专区

### 步骤一：新建生图任务

点击左侧导航「新建任务」，**默认进入「文生图」功能**。按以下步骤生成图片：

* **填写提示词 PROMPT**——用一句话描述想要的画面（含示例占位提示）。
* **选择风格**——国潮 / 写实摄影 / 3D 渲染 / 极简。
* **选择比例**——1:1 / 3:4 / 16:9。
* **选择生成张数**——通过 −／+ 调整，左下角显示预计消耗 Token。点击「生成 N 张」提交任务，结果在右侧「最近任务」面板展示。

![填写提示词](/_fern-files/_img/9e3c8fc351d86163f76914f5c12620e4edb04b8127af7a3ef425fa0e3fd096ac.webp)![选择风格](/_fern-files/_img/7031488f15382c2633320eb9a5116c003ec04b33fc585fa354123eecba96b500.webp)![选择比例](/_fern-files/_img/376822dd14c71e1154cd5f415d591db7f7cc6c38c411c7729e74569c6f6f7ded.webp)![选择张数并生成](/_fern-files/_img/cb2cde06d46f7645f42fd146c80f7af76077976af1736fce12bb4f6f57338e48.webp)

**图生图**：基于已有图片进行 AI 二次创作。切换到「图生图」标签页后：

1. 上传参考图（二选一）：本地上传（支持 JPG、PNG、WebP，单张最大 5 MB）或从素材库选择。
2. 填写图生图指令，如「把背景换成黄昏海边，保留人物姿势和服装」。
3. 选择输出比例（默认 1:1）。
4. 通过 −／+ 设置批量生成张数（默认 1 张）。
5. 点击「开始图生图」，系统批量生成结果，可在「任务中心」查看进度与产物。

![图生图](/_fern-files/_img/d5e0a4882f4af79d4d3ad678c0e42ac35419d1b1a15df4501a31b82769f40584.webp)

### 步骤二：查看任务进度与结果

点击生成后，可在右侧「最近任务」查看生成进度，或点击菜单「任务中心」查看。

![任务进度](/_fern-files/_img/cbf6b29f960579ca0a63565a3baedb39642a00224c522ea031d74e73901ee40a.webp)

### 任务中心

「任务中心」用于查看历史生图任务与产出结果，集中管理所有文生图 / 图生图任务，展示任务状态、生成时间、图片尺寸及产出图片，并支持搜索、按状态筛选和刷新。

**界面说明：**

* **搜索栏**：按提示词、类型或错误信息检索历史任务。
* **状态筛选**：右上角下拉可按「全部状态」等筛选（如已完成、失败）。
* **刷新按钮**：手动刷新任务列表最新状态。
* **新建任务**：右上角快捷入口，跳转创建新生图任务。
* **任务卡片**：每条任务展示提示词、生成时间、类型、尺寸（如 1024×1024）、状态标签及产出图片缩略图，右侧「详情」可查看完整结果。

**任务状态说明：** **已完成**（绿色）任务成功，展示批量生成的多张结果图；**失败**（红色）任务未成功，并显示错误原因。

![任务中心](/_fern-files/_img/5818dc164e2a6c0c3ab77ea152409a5b7eec719f03b962bbb77ed31bd93e596f.webp)

### 查看详情

「任务详情页」展示单个生图任务的完整信息，包括输出结果、提示词、执行信息与高级参数，用于查看生成图片、下载保存或复用素材，并追溯任务的执行过程。

**分区说明：**

* **输出结果**：展示生成的成品图，图片下方提供「下载」（保存到本地）与「添加到素材库」（便于后续复用）。
* **执行信息**（右侧面板）：状态、Agent（image）、类型、生成引擎、引擎任务编号，以及执行时间线（已创建 / 已开始 / 已完成的时间戳）。
* **提示词**：完整展示本次生成使用的提示词文本。
* **查看高级参数**：可展开查看生成数量、尺寸、类型等详细配置。

![任务详情](/_fern-files/_img/f8268f3c4d999a6b294872d0e465056bc4e9af9ebaf17ecac436bb21ef0c37ea.webp)

### 素材库

「素材库」用于统一归档和管理图片素材。生成图片后可手动归档到素材库，方便下载、复用与二次编辑（如作为图生图的参考图），也支持上传本地素材。

**界面说明：** 搜索栏（按名称检索）、分类筛选（全部 / 生成图片 / 已上传）、上传素材按钮、素材数量、网格 / 列表视图切换。

**素材来源：** **生成图片**（在任务详情页点击「添加到素材库」归档的结果）；**已上传**（通过「上传素材」按钮上传的本地图片）。

![素材库](/_fern-files/_img/b33e15f1e791bea854d0bff7ff8da1bcb33a7d2b8033a59b58c64ff145b74630.webp)

### 技能广场

#### 功能概述

技能广场是「一键生图 Agent」的核心入口，提供生产级图片提示模板（技能），用户从真实图片技能目录中选择模板，快速开始创作。

#### 公共技能

以卡片形式展示预置模板，每张卡片含：预览图、名称、分类来源（SOURCE 编号）、版本号（v1）、功能描述、标签、「使用技能 →」按钮。示例模板：

* **建筑与空间**：生成室内、建筑、城市地图和空间概念视觉（标签 Architecture / Interior / Map）
* **品牌触点视觉板**：生成包装、社媒、网页和展示场景里的品牌触点板（标签 Brand / Identity / Campaign）
* **品牌身份包**：生成 Logo、配色、字体、应用触点与品牌系统（标签 Brand / Logo / Identity）

![技能广场公共技能](/_fern-files/_img/6dbf07f1dec6a2ca126da10c7429ad23798379dfb3b70682e025c9c2826f1c2b.webp)

#### 点击使用技能

在技能广场点击「使用技能 →」后，页面跳转至「新建任务 - 新建生图任务」，顶部提示"已套用「建筑与空间」技能"。

已选择图片技能区（以选中的「建筑与空间」为例）：

* 显示技能名称与描述
* 主体与用途输入框（例：为春季咖啡新品制作一张社媒首发海报）
* 「应用到提示词」按钮：将主体用途结合技能模板填入提示词
* 右上角「×」可取消已选技能

其他使用步骤与一键生图 Agent 流程一致。

![使用技能](/_fern-files/_img/950165ac4d74a19b9158b157eef7daa3fc91421484dade7c35796db3df667014.webp)

#### 我的技能

展示用户自建模板；无数据时提示"还没有自定义技能"，可点击「+ 新建技能」创建。

在「我的技能」中点击「+ 新建技能」弹出此窗口，用于保存一套可复用的提示模板。该技能仅对当前租户和用户可见。顶部提供「▶ 查看填写示例」可展开参考示例。

![我的技能](/_fern-files/_img/dca220ed41f25fc4fca42484927ff61343a111a74c7cae35cee9a6c0c22362e7.webp)

##### 字段说明

* **技能名称**：自定义技能的名称
* **分类**：技能所属分类，默认 custom
* **简介**：对技能用途的简要说明
* **核心提示模板**：描述希望 Agent 始终遵循的创作方法、主体和约束（核心必填内容）
* **标签**：用逗号分隔，例如"品牌,海报"，便于检索归类
* **构图与结构**：画面构图、结构方面的约束
* **视觉风格**：整体视觉风格要求
* **细节指导**：画面细节层面的指导
* **输出要求**：对生成结果的输出规格要求
* **负面约束**：不希望出现的元素或效果（负向提示）

##### 操作按钮

* **保存技能**：保存并生成一条自定义技能，展示在「我的技能」列表
* **取消**：放弃填写并关闭弹窗
* **右上角「×」**：关闭弹窗

##### 使用步骤

1. 在「我的技能」点「+ 新建技能」打开弹窗
2. （可选）点「查看填写示例」参考格式
3. 填写技能名称、分类、简介
4. 在"核心提示模板"填写创作方法、主体与约束
5. 按需补充标签、构图与结构、视觉风格、细节指导、输出要求、负面约束
6. 点击「保存技能」完成创建，后续可在新建任务中应用

![新建技能弹窗](/_fern-files/_img/14744ab3409e78e8b33248202a40d603a1b1befe66bfd349877032c2750b8d2e.webp)

## AIGC：视频专区

### 步骤一：新建快速创作

快速创作用于通过一段文字提示词快速生成短视频，适合先把创意跑通、再决定是否精修的场景。任务提交后进入生成队列，完成后可在任务详情中预览成片，并手动添加到素材库。

**界面说明：**

* **视频提示词**：填写想要生成的画面内容，支持中文描述场景、主体、动作与镜头风格；提示词越具体，成片越贴近预期。
* **画面比例**：选择成片画幅，可选「16:9 横屏」（适合网页、大屏、横版投放）与「9:16 竖屏」（适合手机短视频、竖版信息流）。
* **分辨率**：选择生成清晰度，可选「720p（标准）」「768p（进阶）」「1080p（高清）」；清晰度越高，画面细节越好，生成耗时与消耗也越大。
* **时长**：选择成片长度，可选 4 秒、6 秒、8 秒、10 秒；时长越长，生成耗时与消耗越大。
* **开始生成**：提交任务，按当前提示词与参数发起视频生成；提交后可在任务详情查看进度与结果。

补充提示：任务完成后不会自动进入素材库，需要在任务详情中手动添加。

![新建快速创作](/_fern-files/_img/c32bcf680fd3c84d7307162c44a19ccbefe4917e0ce9364f52321fe1b24b6233.webp)

### 步骤二：查看任务进度与结果

点击生成后，可在右侧「最近任务」查看生成进度，或点击菜单「任务中心」查看。

![最近任务与生成进度](/_fern-files/_img/3aa8812c8f8df8b80ba5efc259ef8685214c2bcb68ac847cc7e16f1f7c9e1994.webp)

### 任务中心

任务中心集中展示快速创作与故事制作产生的全部任务，用于查看任务状态、检索历史记录并进入详情查看输出结果。列表按时间倒序排列，最新提交的任务排在最前。

**界面说明：**

* **新建任务**：在页面右上角，点击后直接发起新的创作任务。
* **全部任务 / 快速创作 / 故事制作**：顶部筛选标签，切换查看全部任务，或只看某一类创作来源的任务。
* **搜索框**：按提示词内容、任务类型或错误信息检索任务，便于快速定位某一条历史记录。
* **全部状态**：按任务状态筛选，可只看已完成、已取消等特定状态的任务。
* **刷新按钮**：重新拉取任务列表，获取最新状态。
* **任务条目**：每条任务显示提示词摘要、提交时间、创作方式与任务类型（如 text_to_video）、任务 ID；已完成的任务还会显示首帧缩略图，便于直接辨认成片内容。
* **状态标识**：显示任务当前状态，如「已完成」「已取消」，用于判断任务是否产出可用结果。
* **详情**：进入该任务的详情页，查看完整提示词、参数与生成结果，并可将成片手动添加到素材库。

![视频任务中心](/_fern-files/_img/9610b1779b087acf42aadd55e18a2e7528b26001a954edc516d9a4c88e3dc852.webp)

### 查看详情

任务详情用于查看单条创作任务的完整信息与输出结果，包括原始提示词、生成的视频、执行引擎与耗时等。适合在任务完成后确认成片效果、下载视频或将其加入素材库。

**界面说明：**

* **返回任务中心**：回到任务列表页，继续查看或筛选其他任务。
* **状态标识**：显示任务当前状态，如「已完成」；任务失败时会在此显示失败状态。
* **提示词标题**：以大字展示该任务使用的完整提示词，便于快速确认创作内容。
* **任务 ID 与类型**：标题下方显示任务 ID 与创作类型（如「文生视频」），用于排障与对账。
* **素材库**：将当前任务的成片加入素材库，便于后续复用。
* **刷新按钮**：重新拉取任务最新状态与结果。
* **输出结果**：展示生成的视频，可直接在页面内播放、调节音量、全屏查看。
* **下载**：将成片下载到本地。
* **添加到素材库**：把成片保存到素材库，供后续创作引用。
* **执行信息**：右侧面板展示状态、Agent、类型、生成引擎与引擎任务编号，用于确认本次生成所用的模型与任务来源。
* **执行时间线**：记录任务的创建、开始与完成时间，可据此判断生成耗时。
* **提示词**：以文本形式回显完整提示词，便于复制或微调后重新生成。
* **实际发送的提示词与参数**：展开查看最终提交给模型的提示词与参数，用于排查「所见与所发不一致」的问题。
* **查看高级参数**：展开查看本次任务的完整高级参数配置。

![视频任务详情](/_fern-files/_img/8d2a80973f778928087382781b36fa24e71f522fcd8adf178dd721181e567378.webp)

### 素材库

素材库统一管理创作过程中用到的图片、视频与故事素材，既包含用户自行上传的参考图，也包含创作生成并保存下来的成片。上传的图片可直接作为图生视频的参考素材使用。

**界面说明：**

* **上传素材**：在页面右上角，将本地图片或视频上传到素材库。
* **素材数量**：显示当前素材库中的素材总数。
* **视图切换**：在网格视图与列表视图之间切换，按需选择更便于浏览的展示方式。
* **搜索素材名称**：按素材名称检索，快速定位某个素材。
* **全部 / 角色 / 分辨 / 视频 / 已上传**：按素材来源与类型筛选，可只看全部素材、角色素材、分辨类素材、视频素材或用户上传的素材。
* **素材卡片**：以缩略图展示素材内容，卡片下方标注素材名称、来源（如「系统生成」「用户上传」）与时间；鼠标悬停时可通过右上角菜单进行更多操作。
* **用于图生视频**：上传的图片素材可直接作为参考图发起图生视频创作。
* **分页与每页条数**：底部显示当前展示条数与素材总量，可切换每页条数并翻页浏览。

![视频素材库](/_fern-files/_img/4b877589efe4823749a38525821acaa9ca5614969701f35da74adc7da464a7b3.webp)

### 技能广场

#### 功能概述

技能广场提供视频创作模板，帮助用户从现成的创作方向开始制作视频。用户可浏览技能封面、名称、简介及标签，选择合适的技能后点击「使用技能」进入创作。

**界面说明：**

* 左侧导航栏提供「快速创作」「故事制作」「任务中心」「技能广场」和「素材库」入口，当前位于「技能广场」。
* 页面右上角可在「公共技能」和「我的技能」之间切换。
* 技能以卡片形式展示封面、名称、简介和标签；点击卡片中的「使用技能」即可选用该技能。
* 顶部「运行正常」标识展示当前服务状态，旁边提供设置入口。

![视频技能广场](/_fern-files/_img/424edacb70f92d8e27d5483d9c6c90ab7c2dd42066511e6777517989e16e006c.webp)

#### 点击使用技能

点击「使用技能」后，页面跳转至「快速创作」，并启用所选技能。用户可以填写视频主题和视频提示词，设置画面比例、分辨率及时长，然后开始生成视频。

**界面说明：**

* 顶部提示技能已启用；创作区显示所选技能的名称与简介。
* 在「视频主题」中输入想要制作的内容，可点击「应用到提示词」，将主题用于编写视频提示词。
* 在「视频提示词」中描述画面内容、镜头运动等具体要求。
* 下方可选择画面比例、分辨率和视频时长；截图中分别为 16:9 横屏、720p（标准）和 4 秒。
* 确认内容与参数后，点击「开始生成」提交任务。

![使用视频技能](/_fern-files/_img/2fac47aa03a1020395f8d1f2d28110c56fff6d89ebf541fc0916fcef6ab6b066.webp)

#### 我的技能

「我的技能」用于查看和创建仅对当前用户可见的自定义视频技能。点击「新建技能」后，可填写创作方法与提示词要求，并保存为可复用的技能。

**界面说明：**

* 切换至「我的技能」后，页面显示已有的自定义技能；截图中尚无技能，可点击页面右上角或空状态区域的「新建技能」。
* 新建窗口提供「查看填写示例」，可在填写前参考。
* 填写技能名称、简介、核心提示模板等内容；还可设置分类、标签、适用类型，以及构图与结构、视觉风格、细节指导、输出要求和负面约束。
* 填写完成后点击「保存技能」；如不保存，可点击「取消」或关闭窗口。

![我的视频技能与新建技能](/_fern-files/_img/5ef85e12b120f5d05bb3989617ae543ff5432bd43229c0aecaa10cda8fb5350a.webp)

在「我的技能」中点击「新建技能」，可将常用的视频创作要求保存为个人技能，供后续创作时复用。新建的技能仅对当前用户可见。

**界面说明：**

* **查看填写示例**：展开示例，参考各项内容的填写方式。
* **技能名称**：填写便于识别的名称，例如「产品展示短片」。
* **分类**：填写技能类别；截图中显示为「custom」。
* **简介**：简要说明技能的用途和适用场景，方便日后查找。
* **核心提示模板**：描述希望创作时遵循的方法、主体和约束，是技能的主要内容。例如说明要突出产品外观与使用场景。
* **标签**：填写便于识别的关键词；输入框提示使用逗号分隔，例如「品牌, 海报」。
* **适用类型**：选择技能对应的创作类型；截图中当前显示「text_to_video」。
* **构图与结构**：说明画面布局及内容展开顺序，例如先展示全景，再切换至产品细节。
* **视觉风格**：描述色调、光线、材质或整体氛围。
* **细节指导**：补充镜头运动、主体动作、环境细节等具体要求。
* **输出要求**：说明希望生成的画面效果或呈现重点。
* **负面约束**：填写希望避免出现的内容或效果，例如画面模糊、主体变形。
* 完成填写后点击「保存技能」；若不继续创建，可点击「取消」或右上角关闭按钮。

## FAQ

<dl>
  <dt>
    已有Key为什么不能发消息？
  </dt>

  <dd>
    检查是否属于当前环境、是否选为默认或专属Key、是否保存，以及余额、预算和模型权限。
  </dd>

  <dt>
    为什么没有先安装就有JoyToken Agent？
  </dt>

  <dd>
    它是平台内置通用助手。市场安装的是其他可复用助手或个人副本。
  </dd>

  <dt>
    知识库显示0个文件，却能回答资料内容？
  </dt>

  <dd>
    配置选择器的统计可能与知识库详情不同。以文件详情的状态和实际检索结果核对，不凭一个计数下结论。
  </dd>

  <dt>
    任务已执行完为什么还是待验收？
  </dt>

  <dd>
    还需要检查结果并点击「确认验收」。
  </dd>

  <dt>
    计划删了，任务会消失吗？
  </dt>

  <dd>
    删除计划停止未来自动触发，任务及历史仍保留。
  </dd>

  <dt>
    为什么会话汇总与用量不一致？
  </dt>

  <dd>
    统计时机和覆盖范围可能不同；核对同一时间、Key和调用，最终以已结算明细为准。
  </dd>

  <dt>
    Skill描述有很多功能，是不是全部能用？
  </dt>

  <dd>
    描述还依赖模型、工具和运行环境，必须结合实际配置验证。
  </dd>

  <dt>
    模型或工具失败应该提供什么？
  </dt>

  <dd>
    环境、时间、助手、步骤、错误和请求定位。不要提供完整Key、验证码或密码。
  </dd>
</dl>