概述
本文记录一次智能体模板的使用过程:在应用市场中体验模板、开通 MCP 扩展能力、配置 API 凭证、调整指令与参数,并完成对话测试。核心链路为文案生成、形象查询、视频任务提交、进度轮询。
流程概览
用户输入 → 生成文案 → queryPersonaList → submitVideoTask → getTaskResult(轮询)→ 输出视频
一、体验应用模板
-
控制台 → 应用 → 应用广场
-
选择「数字人视频类」应用模板并进入体验页
-
在对话区输入测试需求(需包含目标形象或场景描述)
-
观察工具调用顺序:
- queryPersonaList:返回可用形象列表
- 生成口播文本
- submitVideoTask:创建异步视频任务
- getTaskResult:返回 progress 与 status
入参变量:Personaname(string),用于指定形象名称;未填写时可能提示变量不完整。
二、复制模板的前置条件
复制前需在配置清单中确认两项可用:
| 项 | 要求 |
|----|------|
| 大语言模型 | 已开通 |
| MCP:数字人视频 | 已开通 |
若 MCP 未开通,需先在 MCP 管理页完成开通,并填入第三方服务所需的 api-key。
凭证获取:在 MCP 开通弹窗指引的账号中心 → 设置 → API 密钥,复制后填入,勿写入公开仓库。
开通完成后,配置清单显示全部可用,即可将模板复制到业务空间。
三、指令与参数
参数示例
| 项 | 值 |
|----|-----|
| temperature | 0.85 |
| max_tokens | 2048 |
| context_rounds | 10 |
指令中的任务拆分
-
生成口播文案(建议限制字数,如 ≤100)
-
queryPersonaList:按Personaname或用户条件选形象 -
submitVideoTask:传入personaBizId与text -
getTaskResult:轮询任务,向用户反馈进度
MCP 工具
| 工具 | 输入要点 |
|------|----------|
| queryPersonaList | 无必填;返回 personaBizId |
| submitVideoTask | personaBizId、text(约 300 字上限) |
| getTaskResult | 任务 ID |
| submitIntelligentVideoTask | 智能生成场景(可选) |
四、测试要点
-
对话区输入需求,确认形象推荐与文案输出
-
选定形象后检查是否返回 Task ID
-
发送「查询进度」类指令,验证
getTaskResult返回的 JSON(如progress: 0.4, status: running) -
任务结束后在预览区核对视频
指令调试:在应用配置 → 指令区修改提示词,右侧对话区反复验证;可调整温度、上下文轮数等参数。
五、发布
填写版本说明,对比待发布与已发布版本的模型、指令差异后确认发布。对外集成可通过 API(应用 ID + 凭证)完成,具体字段以控制台文档为准。
要点归纳
-
视频生成为异步任务,需通过
getTaskResult轮询,不宜在单次对话中假设即时完成。 -
MCP 与 API 凭证是复制模板的前置项,缺一则配置清单不完整。
-
指令中应明确工具调用顺序、字数限制及进度反馈方式,减少歧义。