DeckFlow Logo 开发者 DeckFlow 文档
开发者指南API 参考MCPCLI

MCP 示例场景

AI 智能体使用 DeckFlow MCP 的提示词示例与期望工具调用流。

以下示例均作为产品文档草案编写。在最终的 MCP Schema 规范确定前,工具名称及参数皆为占位符。

根据研究资料生成演示文稿

用户提示词:

使用 DeckFlow 将这份 PDF 研究报告生成为一个 12 页的投资路演幻灯片。保持技术图表清晰易读,使用简洁的决策层语气,并导出为 PPTX 格式。

智能体期望的工作流:

  1. 确认附件文件是支持的创建 (Create) 数据源。
  2. 调用 create_deck 工具,传入源文件、要求的幻灯片页数、目标受众、语气和 PPTX 输出格式。
  3. 轮询调用 get_task,直至任务执行完成。
  4. 返回 PPTX 临时签名下载链接,并指出任何告警信息(如缺失字体或图表失真问题)。

用户或智能体应当提供的参数:

参数示例值
source_typefile
source随附的 PDF 文件
slide_count12
audienceinvestors
toneexecutive, concise
output_formatpptx

根据网页链接 (URL) 生成演示文稿

用户提示词:

根据这个网页链接生成一个简短的产品概述演示文稿,并同时导出为 PPTX 和 PDF。

智能体期望的工作流:

  1. 检查当前是否支持 URL 链接导入功能。
  2. 调用 create_deck,传入参数 source_type=url。
  3. 如果支持单次任务返回多种格式则直接请求;否则在创建完成后依次调用导出工具。
  4. 返回生成的这两个临时签名下载链接。

待确定的参数:

参数待确认的开放问题
source_url是仅支持公开网页 URL,还是也支持导入需要登录验证的页面?
output_format单个任务能否同时返回多种输出文件格式?
crawl_depth网页导入是仅限单页,还是能顺着链接爬取子页面?

翻新现有演示文稿

用户提示词:

使用 DeckFlow 并应用我们已保存的品牌 DNA 配置翻新这份 PPTX 演示文稿。不要重写其文字内容。保持最终输出文件为可编辑格式。

智能体期望的工作流:

  1. 如果用户未指定品牌 DNA 配置,则调用 list_brand_profiles。
  2. 调用 revamp_deck,传入所选的品牌配置和 preserve_content=true。
  3. 轮询任务状态。
  4. 以临时下载链接的形式返回可编辑的输出文件。

用户或智能体应当提供的参数:

参数示例值
file随附的 PPTX 文件
style_modebrand_dna
brand_profile_id所选的配置 ID
preserve_contenttrue
output_formatpptx

保留排版版式进行翻译

用户提示词:

将此 Keynote 演示文稿翻译为日语。保持排版完整,并使用我们的产品术语表。

智能体期望的工作流:

  1. 验证是否支持 Keynote 文件输入。
  2. 如果用户未指明术语表 ID,则调用 list_glossaries。
  3. 调用 translate_deck,传入目标语言和术语表。
  4. 轮询直至任务完成。
  5. 以临时下载链接的形式返回翻译后的文件,以及任何排版相关的警告信息。

用户或智能体应当提供的参数:

参数示例值
file随附的 Keynote 文件
target_languageja
glossary_id所选的术语表 ID
preserve_layouttrue
output_format如果支持,与输入格式相同

将 HTML 转换为 PPTX

用户提示词:

使用 DeckFlow 将此 HTML 页面转换为可编辑的 PowerPoint 演示文稿。

智能体期望的工作流:

  1. 使用 convert_file,传入 operation=html_to_pptx。
  2. 传递上传的 HTML 文件或粘贴的 HTML 内容。
  3. 以临时下载链接的形式返回生成的 PPTX。

用户或智能体应当提供的参数:

参数示例值
operationhtml_to_pptx
file 或 contentHTML 文件或粘贴的 HTML 内容
output_formatpptx

从 PPTX 中提取文本形状

用户提示词:

提取此 PPTX 第 3 至 10 页的所有文本框,并返回结构化的 JSON 数据。

智能体期望的工作流:

  1. 调用 extract_file_content,传入 operation=pptx_text_extractor。
  2. 将 page_range 或 slide_range 设置为幻灯片 3 到 10。
  3. 请求结构化输出。
  4. 返回内联 JSON 或可下载的 JSON 文件。

待确定的参数:

参数待确认的开放问题
page_range 与 slide_rangeAPI/MCP 应该统一使用哪个名称?
include_coordinates默认情况下是否应该返回形状位置坐标?
output_format是返回内联 JSON 响应,还是生成可下载的 JSON 文件?

合并多个 PPTX 文件

用户提示词:

按照上传顺序合并这三个 PPTX 文件。尽可能保留每个演示文稿的原始格式。

智能体期望的工作流:

  1. 保留上传顺序,或请求用户确认排序。
  2. 调用 compose_files,传入 operation=pptx_merge |
  3. 轮询直至任务完成。
  4. 以临时下载链接的形式返回合并后的演示文稿。

用户或智能体应当提供的参数:

参数示例值
operationpptx_merge
files有序的 PPTX 文件引用列表
preserve_stylestrue
output_name可选的文件名

压缩交付包体积

用户提示词:

压缩此 PPTX 文件以便我可以通过邮件发送,但要保持高图片质量。

智能体期望的工作流:

  1. 调用 optimize_file,传入 operation=file_compress。
  2. 选择一个保守的压缩预设。
  3. 以临时下载链接的形式返回压缩后的文件,并在可用时返回压缩前后的文件大小。

待确定的参数:

参数待确认的开放问题
quality预设枚举值还是数值?
target_size_mb用户是否应该能够请求最大限制体积?
size_report结果中是否应该包含前后字节大小对比?

智能体行为规范

智能体应在以下情况下提出追加提问:

  • 缺失源文件。
  • 用户请求了品牌 DNA 配置、模板或术语表,但未指明具体是哪一个,且不存在默认配置。
  • 输出格式不受支持或含糊不清。
  • 任务执行可能会覆盖或删除现有的工作区资产。
  • 附加了多个文件且文件顺序至关重要。

智能体应当在以下情况下直接执行,无需追加提问:

  • 用户附加了恰好一个兼容的文件。
  • 请求的操作和输出格式清晰明确。
  • 可以通过 get_deckflow_capabilities 发现 DeckFlow 的各项能力。
  • 最终的 Schema 中定义了合理的默认值。

能力发现示例 Prompt

使用 DeckFlow MCP 检查可用的能力,然后告诉我哪些操作支持 PPTX 输入,以及每个操作可以生成哪些输出格式。

智能体期望的工作流:

  1. 调用 get_deckflow_capabilities。
  2. 筛选输入格式中包含 PPTX 的能力。
  3. 总结支持的输出格式及限制。