create_ppt_by_outline
Convert structured outlines into PowerPoint presentations with customizable templates, automatic image insertion, and speaker notes generation.
Instructions
根据大纲创建PPT。
使用说明:
1. 用于根据已生成的大纲创建PPT。
2. 大纲需通过create_outline或create_outline_by_doc工具生成。
3. template_id需通过get_theme_list工具获取。
4. 工具会返回任务ID(sid),需用get_task_progress轮询查询进度。
5. 任务完成后,可从get_task_progress结果中获取PPT下载地址。
6. 需先设置环境变量AIPPT_APP_ID和AIPPT_API_SECRET。
参数:
- text: PPT生成的内容描述,用于指导PPT生成。
- outline: 大纲内容,需从create_outline或create_outline_by_doc工具返回的JSON响应中提取['data']['outline']字段的值。该字段包含生成的大纲内容,格式为dict。
- template_id: PPT模板ID,需通过get_theme_list工具获取。
- author: PPT作者名称,将显示在生成的PPT中。
- is_card_note: 是否生成PPT演讲备注,True表示生成,False表示不生成。
- search: 是否联网搜索,True表示联网搜索补充内容,False表示不联网。
- is_figure: 是否自动配图,True表示自动配图,False表示不配图。
- ai_image: AI配图类型,仅在is_figure为True时生效。可选值:normal-普通配图(20%正文配图),advanced-高级配图(50%正文配图)。
返回:
成功时返回包含sid的字典,失败时抛出异常。
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| text | Yes | ||
| outline | Yes | ||
| template_id | Yes | ||
| author | No | XXXX | |
| is_card_note | No | ||
| search | No | ||
| is_figure | No | ||
| ai_image | No | normal |
Implementation Reference
- src/zwppt_mcp/server.py:267-327 (handler)The @mcp.tool()-decorated handler function implementing the create_ppt_by_outline tool. It constructs a request body from parameters including the outline dict, sends a POST to the xfyun API endpoint, and returns the task sid on success.@mcp.tool() def create_ppt_by_outline( ctx: Context, text: str, outline: dict, template_id: str, author: str = "XXXX", is_card_note: bool = True, search: bool = False, is_figure: bool = True, ai_image: str = "normal" ) -> Dict[str, Any]: """ 根据大纲创建PPT。 使用说明: 1. 用于根据已生成的大纲创建PPT。 2. 大纲需通过create_outline或create_outline_by_doc工具生成。 3. template_id需通过get_theme_list工具获取。 4. 工具会返回任务ID(sid),需用get_task_progress轮询查询进度。 5. 任务完成后,可从get_task_progress结果中获取PPT下载地址。 6. 需先设置环境变量AIPPT_APP_ID和AIPPT_API_SECRET。 参数: - text: PPT生成的内容描述,用于指导PPT生成。 - outline: 大纲内容,需从create_outline或create_outline_by_doc工具返回的JSON响应中提取['data']['outline']字段的值。该字段包含生成的大纲内容,格式为dict。 - template_id: PPT模板ID,需通过get_theme_list工具获取。 - author: PPT作者名称,将显示在生成的PPT中。 - is_card_note: 是否生成PPT演讲备注,True表示生成,False表示不生成。 - search: 是否联网搜索,True表示联网搜索补充内容,False表示不联网。 - is_figure: 是否自动配图,True表示自动配图,False表示不配图。 - ai_image: AI配图类型,仅在is_figure为True时生效。可选值:normal-普通配图(20%正文配图),advanced-高级配图(50%正文配图)。 返回: 成功时返回包含sid的字典,失败时抛出异常。 """ url = "https://zwapi.xfyun.cn/api/ppt/v2/createPptByOutline" headers = get_headers() if isinstance(outline, str): outline = json.loads(outline) body = { "query": text, "outline": outline, "templateId": template_id, "author": author, "isCardNote": is_card_note, "search": search, "isFigure": is_figure, "aiImage": ai_image } response = requests.post(url, json=body, headers=headers) if response.status_code != 200: raise Exception(f"调用失败: {response.text}") resp = json.loads(response.text) if resp['code'] == 0: return {"sid": resp['data']['sid']} else: raise Exception(f"根据大纲创建PPT失败: {response.text}")