以下示例均作为产品文档草案编写。在最终的 MCP Schema 规范确定前,工具名称及参数皆为占位符。
根据研究资料生成演示文稿
用户提示词:
使用 DeckFlow 将这份 PDF 研究报告生成为一个 12 页的投资路演幻灯片。保持技术图表清晰易读,使用简洁的决策层语气,并导出为 PPTX 格式。
智能体期望的工作流:
- 确认附件文件是支持的创建 (
Create) 数据源。 - 调用
create_deck工具,传入源文件、要求的幻灯片页数、目标受众、语气和PPTX输出格式。 - 轮询调用
get_task,直至任务执行完成。 - 返回
PPTX临时签名下载链接,并指出任何告警信息(如缺失字体或图表失真问题)。
用户或智能体应当提供的参数:
| 参数 | 示例值 |
|---|---|
source_type | file |
source | 随附的 PDF 文件 |
slide_count | 12 |
audience | investors |
tone | executive, concise |
output_format | pptx |
根据网页链接 (URL) 生成演示文稿
用户提示词:
根据这个网页链接生成一个简短的产品概述演示文稿,并同时导出为 PPTX 和 PDF。
智能体期望的工作流:
- 检查当前是否支持 URL 链接导入功能。
- 调用
create_deck,传入参数source_type=url。 - 如果支持单次任务返回多种格式则直接请求;否则在创建完成后依次调用导出工具。
- 返回生成的这两个临时签名下载链接。
待确定的参数:
| 参数 | 待确认的开放问题 |
|---|---|
source_url | 是仅支持公开网页 URL,还是也支持导入需要登录验证的页面? |
output_format | 单个任务能否同时返回多种输出文件格式? |
crawl_depth | 网页导入是仅限单页,还是能顺着链接爬取子页面? |
翻新现有演示文稿
用户提示词:
使用 DeckFlow 并应用我们已保存的品牌 DNA 配置翻新这份 PPTX 演示文稿。不要重写其文字内容。保持最终输出文件为可编辑格式。
智能体期望的工作流:
- 如果用户未指定品牌 DNA 配置,则调用
list_brand_profiles。 - 调用
revamp_deck,传入所选的品牌配置和preserve_content=true。 - 轮询任务状态。
- 以临时下载链接的形式返回可编辑的输出文件。
用户或智能体应当提供的参数:
| 参数 | 示例值 |
|---|---|
file | 随附的 PPTX 文件 |
style_mode | brand_dna |
brand_profile_id | 所选的配置 ID |
preserve_content | true |
output_format | pptx |
保留排版版式进行翻译
用户提示词:
将此 Keynote 演示文稿翻译为日语。保持排版完整,并使用我们的产品术语表。
智能体期望的工作流:
- 验证是否支持 Keynote 文件输入。
- 如果用户未指明术语表 ID,则调用
list_glossaries。 - 调用
translate_deck,传入目标语言和术语表。 - 轮询直至任务完成。
- 以临时下载链接的形式返回翻译后的文件,以及任何排版相关的警告信息。
用户或智能体应当提供的参数:
| 参数 | 示例值 |
|---|---|
file | 随附的 Keynote 文件 |
target_language | ja |
glossary_id | 所选的术语表 ID |
preserve_layout | true |
output_format | 如果支持,与输入格式相同 |
将 HTML 转换为 PPTX
用户提示词:
使用 DeckFlow 将此 HTML 页面转换为可编辑的 PowerPoint 演示文稿。
智能体期望的工作流:
- 使用
convert_file,传入operation=html_to_pptx。 - 传递上传的 HTML 文件或粘贴的 HTML 内容。
- 以临时下载链接的形式返回生成的 PPTX。
用户或智能体应当提供的参数:
| 参数 | 示例值 |
|---|---|
operation | html_to_pptx |
file 或 content | HTML 文件或粘贴的 HTML 内容 |
output_format | pptx |
从 PPTX 中提取文本形状
用户提示词:
提取此 PPTX 第 3 至 10 页的所有文本框,并返回结构化的 JSON 数据。
智能体期望的工作流:
- 调用
extract_file_content,传入operation=pptx_text_extractor。 - 将
page_range或slide_range设置为幻灯片 3 到 10。 - 请求结构化输出。
- 返回内联 JSON 或可下载的 JSON 文件。
待确定的参数:
| 参数 | 待确认的开放问题 |
|---|---|
page_range 与 slide_range | API/MCP 应该统一使用哪个名称? |
include_coordinates | 默认情况下是否应该返回形状位置坐标? |
output_format | 是返回内联 JSON 响应,还是生成可下载的 JSON 文件? |
合并多个 PPTX 文件
用户提示词:
按照上传顺序合并这三个 PPTX 文件。尽可能保留每个演示文稿的原始格式。
智能体期望的工作流:
- 保留上传顺序,或请求用户确认排序。
- 调用
compose_files,传入operation=pptx_merge| - 轮询直至任务完成。
- 以临时下载链接的形式返回合并后的演示文稿。
用户或智能体应当提供的参数:
| 参数 | 示例值 |
|---|---|
operation | pptx_merge |
files | 有序的 PPTX 文件引用列表 |
preserve_styles | true |
output_name | 可选的文件名 |
压缩交付包体积
用户提示词:
压缩此 PPTX 文件以便我可以通过邮件发送,但要保持高图片质量。
智能体期望的工作流:
- 调用
optimize_file,传入operation=file_compress。 - 选择一个保守的压缩预设。
- 以临时下载链接的形式返回压缩后的文件,并在可用时返回压缩前后的文件大小。
待确定的参数:
| 参数 | 待确认的开放问题 |
|---|---|
quality | 预设枚举值还是数值? |
target_size_mb | 用户是否应该能够请求最大限制体积? |
size_report | 结果中是否应该包含前后字节大小对比? |
智能体行为规范
智能体应在以下情况下提出追加提问:
- 缺失源文件。
- 用户请求了品牌 DNA 配置、模板或术语表,但未指明具体是哪一个,且不存在默认配置。
- 输出格式不受支持或含糊不清。
- 任务执行可能会覆盖或删除现有的工作区资产。
- 附加了多个文件且文件顺序至关重要。
智能体应当在以下情况下直接执行,无需追加提问:
- 用户附加了恰好一个兼容的文件。
- 请求的操作和输出格式清晰明确。
- 可以通过
get_deckflow_capabilities发现 DeckFlow 的各项能力。 - 最终的 Schema 中定义了合理的默认值。
能力发现示例 Prompt
使用 DeckFlow MCP 检查可用的能力,然后告诉我哪些操作支持 PPTX 输入,以及每个操作可以生成哪些输出格式。
智能体期望的工作流:
- 调用
get_deckflow_capabilities。 - 筛选输入格式中包含 PPTX 的能力。
- 总结支持的输出格式及限制。