create_outline_by_doc
Generate PowerPoint outlines from documents to structure presentation content. Upload PDF, DOC, DOCX, TXT, or MD files to create organized outlines for PPT generation.
Instructions
从文档创建PPT大纲。
使用说明：
1. 用于根据文档内容生成PPT大纲。
2. 支持通过file_url或file_path上传文档。
3. 文档格式支持：pdf(不支持扫描件)、doc、docx、txt、md。
4. 文档大小限制：10M以内，字数限制8000字以内。
5. 生成的大纲可用于create_ppt_by_outline工具。
6. 需先设置环境变量AIPPT_APP_ID和AIPPT_API_SECRET。
参数：
- file_name: 文档文件名，必须包含文件后缀名。
- file_url: 文档文件的URL地址，与file_path二选一必填。
- file_path: 文档文件的本地路径，与file_url二选一必填。
- text: 补充的文本内容，用于指导大纲生成。
- language: 大纲生成的语言，目前支持cn(中文)。
- search: 是否联网搜索，True表示联网搜索补充内容，False表示不联网。
返回：
包含生成的大纲内容的字典。Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| file_name | Yes | ||
| text | Yes | ||
| file_url | No | ||
| file_path | No | ||
| language | No | cn | |
| search | No |
Implementation Reference
- src/zwppt_mcp/server.py:215-265 (handler)The handler function for the 'create_outline_by_doc' tool. It constructs a multipart form data request to the xfyun API endpoint to generate a PPT outline from a provided document (via URL or local path), with optional text guidance, language, and search settings. The @mcp.tool() decorator registers it as an MCP tool, and parameters define the input schema.
@mcp.tool() def create_outline_by_doc( ctx: Context, file_name: str, text: str, file_url: Optional[str] = None, file_path: Optional[str] = None, language: str = "cn", search: bool = False ) -> Dict[str, Any]: """ 从文档创建PPT大纲。 使用说明： 1. 用于根据文档内容生成PPT大纲。 2. 支持通过file_url或file_path上传文档。 3. 文档格式支持：pdf(不支持扫描件)、doc、docx、txt、md。 4. 文档大小限制：10M以内，字数限制8000字以内。 5. 生成的大纲可用于create_ppt_by_outline工具。 6. 需先设置环境变量AIPPT_APP_ID和AIPPT_API_SECRET。 参数： - file_name: 文档文件名，必须包含文件后缀名。 - file_url: 文档文件的URL地址，与file_path二选一必填。 - file_path: 文档文件的本地路径，与file_url二选一必填。 - text: 补充的文本内容，用于指导大纲生成。 - language: 大纲生成的语言，目前支持cn(中文)。 - search: 是否联网搜索，True表示联网搜索补充内容，False表示不联网。 返回： 包含生成的大纲内容的字典。 """ url = "https://zwapi.xfyun.cn/api/ppt/v2/createOutlineByDoc" fields = { "fileName": file_name, "query": text, "language": language, "search": str(search) } if file_url: fields["fileUrl"] = file_url elif file_path: fields["file"] = (file_name, open(file_path, 'rb'), 'text/plain') form_data = MultipartEncoder(fields=fields) headers = get_headers(form_data.content_type) response = requests.post(url, data=form_data, headers=headers) if response.status_code != 200: raise Exception(f"调用失败: {response.text}") return response.text