pptx-minio-upload

PPT 生成与 MinIO 下载

核心原则

当用户要求“生成 PPT、做一个演示稿、提供可下载链接”时，优先使用本 MCP 的高层工具，不要直接调用底层 MinIO 全量工具。

默认生产推荐：

{
  "layout_engine": "design_system",
  "theme": "dark_tech",
  "language": "zh-CN"
}

不要默认使用 upstream_templates，也不要让 Agent 自行传递上游 template_id。上游模板库保留为实验模式，默认可能出现 Image 1、Metric/Q1/Q2、默认 Contact 等占位泄露。

复杂 PPT 先规划各页类型（如 timeline、metrics、process、comparison、section）再生成，不要全部写成 bullets。

工具推荐

场景	建议工具
简单生成并返回下载链接	generate_pptx_upload_minio
复杂 PPT、长 PPT、多风格、需要先生成后上传	create_pptx_artifact -> upload_pptx_artifact_to_minio
已生成本地 artifact，需要重试上传	upload_pptx_artifact_to_minio
查询本地 artifact 状态	get_pptx_artifact_info
清理本地 artifact	cleanup_pptx_artifact

如果 generate_pptx_upload_minio 返回 generated_upload_failed 且带 artifact_id，说明 PPT 已经生成成功，上传失败，此时只重试 upload_pptx_artifact_to_minio，不要重新生成。

推荐入参示例

{
  "title": "人工智能发展历程",
  "topic": "从早期符号主义到大模型时代",
  "language": "zh-CN",
  "user_id": "default-user",
  "filename": "人工智能发展历程.pptx",
  "layout_engine": "design_system",
  "theme": "dark_tech",
  "slides": [
    {
      "type": "cover",
      "title": "人工智能发展历程",
      "content": "从图灵测试到大模型时代"
    },
    {
      "type": "agenda",
      "title": "目录",
      "items": [
        "起源与奠基",
        "寒冬与复苏",
        "深度学习革命",
        "大模型时代",
        "AGI 展望"
      ]
    },
    {
      "type": "timeline",
      "title": "AI 关键节点",
      "items": [
        {"label": "1950", "text": "图灵提出机器智能问题"},
        {"label": "1956", "text": "达特茅斯会议正式提出 AI"},
        {"label": "2012", "text": "AlexNet 引爆深度学习浪潮"},
        {"label": "2022", "text": "ChatGPT 推动大模型应用普及"}
      ]
    },
    {
      "type": "comparison",
      "title": "传统 AI 与大模型对比",
      "left_title": "传统 AI",
      "right_title": "大模型",
      "left": ["任务专用", "可解释性较强", "上线迁移成本较高"],
      "right": ["通用性更强", "生态更快扩展", "部署链路更标准"]
    },
    {
      "type": "closing",
      "title": "谢谢",
      "content": "从演进中学习，在业务中稳健落地。"
    }
  ]
}