PopAI Presentation Slides — PopAI 演示幻灯片

PopAI PPT 技能 通过 PopAI 的 API 编程方式创建演示文稿。该 API 具有强大的内置研究和信息收集能力 —— 它将自动搜索、收集和组织相关内容。可选上传文件作为参考材料或模板。如果提供 .pptx 模板，输出将完全保留模板的布局、样式和设计 —— 100%忠实地根据模板进行复制。 初始生成后，可以通过相同的 channel ID 发送后续修改指令。

设置 要求用户在 https://www.popai.pro/popai-skill 注册并获取 Access Token。一旦用户提供 Token，就将其设置在环境中：export POPAI_ACCESS_TOKEN= 提示：可以将密钥保存在 TOOLS.md 中以便日后参考。

脚本 generate_ppt.py - 通过 PopAI API 生成 PPT（上传文件 → 创建 channel → SSE 流 → 获取 pptx）；也支持多轮修改通过 --channel-id

用法示例 # 仅从主题生成 PPT python3 generate_ppt.py --query "AI 开发趋势报告" # 带有参考文件（最多 5 个） python3 generate_ppt.py --query "特斯拉财报 PPT" --file data.pdf chart.png # 带有 PPT 模板文件（作为布局模板） python3 generate_ppt.py --query "特斯拉年度报告" --tpl template.pptx # 同时带有模板和参考文件 python3 generate_ppt.py --query "特斯拉年度报告" --tpl template.pptx --file data.pdf chart.png # 多轮修改：修改现有的 PPT（模板不能更改） python3 generate_ppt.py --channel-id "CHANNEL_ID" --query "添加竞争分析幻灯片并将配色方案改为蓝色" # 带有 URL 作为参考材料（包含在查询中） python3 generate_ppt.py --query "创建一个总结此文章的 PPT：https://example.com/report.html" # 多轮修改，带有额外的参考文件 python3 generate_ppt.py --channel-id "CHANNEL_ID" --query "更新财务数据以使用此新报告" --file new_data.pdf

代理步骤 初始生成 从用户获取 PPT 主题 如果用户提供参考材料： 本地文件：作为 --file（最多 5 个）和/或 --tpl（PPT 模板用于布局）传递 URL：直接包含在 --query 文本中 —— API 将自动获取和处理它们 运行脚本（超时：1200000）：python3 generate_ppt.py --query "主题" [--file 文件 1 文件 2 ...] [--tpl 模板.pptx] 告诉用户："正在生成您的 PPT，预计 5 分钟..." 在脚本运行期间，监视 stdout JSON 行并实时向用户报告进度（例如任务状态更新、搜索操作、工具结果） 当生成完成时，向用户呈现最终结果： 显示摘要文本（来自 NODE_END 事件）作为生成摘要 显示 pptx_url 作为下载链接："下载 PPT：" 显示 web_url 作为网站链接："在线查看/编辑：" 如果用户直接请求 pptx 文件，从 pptx_url 下载并将文件交付给用户 保存 channel_id 从 web_url（https://www.popai.pro/agentic-pptx/ 的最后路径段）以便潜在的后续修改

多轮修改 用于用户想要修订或改进已经生成的 PPT（例如"添加幻灯片"、"更改标题"、"使用较暗的主题"）。 规则： 必需：--channel-id（来自之前的生成）+ --query（修改指令） 可选：--file 供修订使用新的参考文件 不支持：--tpl 在修改模式下被忽略 —— 原始模板不能更改 确认之前生成的 channel_id（存储从 web_url） 从用户获取修改指令 如果用户提供额外的参考文件，将其作为 --file 传递 运行脚本（超时：1200000）：python3 generate_ppt.py --channel-id "CHANNEL_ID" --query "修改指令" [--file 文件 1 ...] 告诉用户："正在应用您的修改，预计 3-5 分钟..." 解析并以与初始生成相同的方式呈现结果（新的 pptx_url 和 web_url）

输出 事件类型（stdout，每行一个 JSON）： {"type": "task", "id": "1", "content": "搜索特斯拉最新财报数据", "status": "progressing"} {"type": "search", "action": "Web 搜索", "results": [{"title": "...", "url": "...", "snippet": "...", "date": "..."}]} {"type": "tool_result", "event": "TOOL_CALLS-xxx", "action": "...", "result": "..."} {"type": "summary", "text": "特斯拉财报 PPT 已创建..."} {"type": "stream_end"} 最终结果（is_end：true）： { "type": "pptx_ready", "is_end": true, "pptx_url": "https://popai-file-boe.s3-accelerate.amazonaws.com/.../xxx.pptx", "file_name": "xxx.pptx", "preview_images": ["https://...0.jpeg"], "preview_count": xx, "web_url": "https://www.popai.pro/agentic-pptx/" } pptx_url：.pptx 文件的下载链接 web_url：PopAI 网站链接，用于在线查看和编辑 preview_images：生成的 PPT 的逐页截图（每张幻灯片一张图像） preview_count：预览图像的总数（即幻灯片数量） summary：最终摘要文本