> ## Documentation Index
> Fetch the complete documentation index at: https://docs.coze.cn/llms.txt
> Use this file to discover all available pages before exploring further.

[iSlide 插件](https://www.coze.cn/store/plugin/7579887576128028687?from=store_search_suggestion)通过调用 [iSlide](https://www.islide.cc/) 接口实现 PPT 生成功能，深度融合 AI 大模型与专业设计资源，助力用户以最短时间制作出专业级 PPT。 iSlide 插件包含四个工具，支持根据 PPT 关键信息生成 PPT大纲；支持预生成 PPT 以查看总页数、首页图、单页缩略图等信息；支持生成 PPTX 源文件下载到本地；支持查询 iSlide 所提供的 PPT 模板 ID。

* generate_outline 工具：根据输入的 PPT 关键信息（主题、风格等），由大模型生成结构化的 PPT 大纲。
* get_themes 工具：获取 iSlide 所支持的主题模板 ID、缩略图、关键字等信息。
* generate_presentation 工具：根据输入的 PPT 大纲，结合模板生成 PPT，并返回 PPT 名称、总页数、首页图、单页缩略图等内容，供用户预览与确认。
* download_presentation 工具：基于 generate_presentation 工具生成的任务 ID，生成对应的 PPTX 源文件并提供下载链接，支持下载到本地进行编辑或保存。

## 计费说明 {#d246316b}

iSlide 插件为三方插件，generate_outline 工具、generate_presentation 工具和 get_themes 工具完全免费，download_presentation 工具将根据调用次数收费。定价说明，请参考[插件费用](/coze_pro/plugin_fee)。

:::notice 注意
download_presentation 工具为付费工具，每次调用将扣除 9900 积分（9.9 元），请谨慎操作。
:::

## generate_outline 工具 {#a1f80d9d}

### 配置说明 {#3bbcbb87}

generate_outline 工具能够根据输入的 PPT 关键信息（主题、风格等），由大模型生成结构化的 PPT 大纲。在配置 generate_outline 工具时，你仅需设置 `topic` 参数，用于指定 PPT 的主题等关键信息。

#### 输入参数 {#83d9ae90}

<!-- @cols-width: 198,654 -->
|**界面参数** |**说明** |
|---|---|
|topic |PPT 的关键信息，例如主题、风格等，例如`新媒体行业年终总结`、`我是小学五年级学生，要在科学课上做 “动物的生存本领” 主题分享，请帮我制作一份 PPT`。 |\
| | |\
| |描述的越清晰，生成的 PPT 大纲将越符合你的需求。 |

#### 输出参数 {#843cce9d}

<!-- @cols-width: 351,487 -->
|**参数** |**说明** |
|---|---|
|code |执行插件时的状态码。 |
|data.status |PPT 大纲生成过程的状态，例如 completed。 |
|data.id |PPT 大纲 ID。 |
|data.outline.title |PPT 主标题。 |
|data.outline.subtitle |PPT 副标题 |
|data.outline.sections.title |PPT 章节标题。 |
|data.outline.sections.subtitle |PPT 章节副标题。 |
|data.outline.sections.contents.title |每页 PPT 的标题。 |
|data.outline.sections.contents.subtitle |每页 PPT 的副标题。 |
|data.outline.sections.contents.items.items |每页 PPT 中的内容条目。 |
|data.outline.sections.contents.items.title |每页 PPT 中的内容标题。 |

## get_themes 工具 {#a15e68bf}

### 配置说明 {#6dbfbd54}

get_themes 工具支持设置不同的查询条件，查询 iSlide 所支持的 PPT 模板，并返回模板 ID、缩略图、关键字等信息。你在调用 iSlide 插件节点（generate_presentation）生成 PPT 时，可输入PPT 模板 ID，以满足用户对 PPT 风格、设计等方面的个性化需求，让生成的 PPT 更符合用户预期。

#### 输入参数 {#d8afc8f7}

<!-- @cols-width: 198,654 -->
|**界面参数** |**说明** |
|---|---|
|ids |PPT 模板 ID，最多指定 100 个，需以英文逗号（,）分隔。 |\
| | |\
| |设置模板 ID 后，表示精准查询，其余查询字段不生效。 |
|keywords |用于查询 PPT 的关键字，字符数需小于等于 100。 |
|size |每次查询的 PPT 模板数量，默认值为 10，最大值 100。 |
|start |指定查询的起始位置，例如 1000。 |
|tags |PPT 模板标签，可为空。 |\
| | |\
| |标签包含标签类型和标签 ID，格式为`标签类型.标签 ID`。若输入多个标签，需以英文逗号（,）分隔。 例如 `category.conference,color.blue`。 |

#### 输出参数 {#fa4d0454}

<!-- @cols-width: 201,645 -->
|**参数** |**说明** |
|---|---|
|code |执行插件时的状态码。 |
|data.size |本次查询到的 PPT 模板数量。 |
|data.start |本次查询的起始位置。 |
|data.total |符合查询条件的 PPT 模板数量。 |
|data.items.id |PPT 模板 ID。 |
|data.items.keywords |PPT 模板关键字。 |
|data.items.thumbnail |PPT 模板缩略图 URL。 |
|data.items.title |PPT 模板标题。 |
|data.items.type |PPT 模板类型。 |
|data.items.gallery |PPT 模板图集，Array 类型，包含多张图片 URL 。 |

### 示例 {#fe854815}

在工作流中添加 iSlide 插件节点（get_themes），用于搭建一个获取 iSlide PPT 模板 ID 的工作流。示例中的节点说明如下：

* 在**开始**节点，使用默认输入参数 `input`，用于动态输入查询 PPT 的关键词。
* 在插件（**get_themes**）节点，设置 `keywords` 引用开始节点的`input` 参数，其他参数保持默认配置。
* 在**结束**节点，设置输出变量 `output`引用 **get_themes** 节点输出结果中的 `data` 参数，展示查询到的 PPT 模板信息。

![Image=733x398](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/e07a7634d8a241da8e1e45248f76faa6~tplv-goo7wpa0wc-image.image)

## generate_presentation 工具 {#32359352}

### 配置说明 {#40d74a23}

generate_presentation 工具能够基于标准的 PPT 大纲及 PPT 模板生成完整的 PPT，并返回 PPT 名称、总页数、首页图、单页缩略图等内容，供用户预览与确认。在配置该工具时，你需要设置 `outline` 参数，用于输入 PPT 大纲 ID。另外，还可以设置 `themeId` 参数，用于输入 PPT 模板 ID，以满足用户对 PPT 风格、设计等方面的个性化需求，让生成的 PPT 更符合用户预期。

#### 输入参数 {#e547ca5f}

<!-- @cols-width: 198,654 -->
|**界面参数** |**说明** |
|---|---|
|outline |PPT 大纲 ID。 |
|historyId |PPT 生成任务 ID。 |
|themeId |PPT 模板 ID，不设置时，使用随机匹配到的模板。 |\
| | |\
| |你可以调用 iSlide 插件中的 get_themes 工具获取模板 ID，也可以在[iSlide 官网](https://www.islide.cc/ppt)获取。 |

#### 输出参数 {#3eb5b365}

<!-- @cols-width: 199,647 -->
|**参数** |**说明** |
|---|---|
|code |执行插件时的状态码。 |
|data.status |PPT 生成过程的状态，例如 completed。 |
|data.thumbnail |PPT 首页缩略图 URL，有效期 2 小时。 |
|data.title |PPT 标题。 |
|data.totalPage |PPT 总页数。 |
|data.historyId |PPT 生成任务 ID。 |
|data.pages.index |`data.pages` 为 Array 类型，罗列了各页 PPT 的缩略图 URL 和版式。 `index` 为 PPT 页码索引。 |
|data.pages.slideLayout |PPT 版式。例如 title 表示当前页只包含标题。 |
|data.pages.thumbnail |每页 PPT 的缩略图 URL，有效期 2 小时。 |

###  {#a2dd6833}

## download_presentation 工具 {#474a7e93}

### 配置说明 {#75f82ef5}

download_presentation 工具支持基于 generate_presentation 工具生成的任务 ID，生成对应的 PPTX 源文件并提供下载链接，便于用户将文件下载到本地进行编辑或保存。在配置 download_presentation 工具时，你仅需设置 `historyId` 参数，用于指定 PPT 生成任务 ID。

#### 输入参数 {#6640a7f4}

<!-- @cols-width: 198,654 -->
|**界面参数** |**说明** |
|---|---|
|historyId |PPT 生成任务 ID。 |

#### 输出参数 {#54fbbcdd}

<!-- @cols-width: 196,655 -->
|**参数** |**说明** |
|---|---|
|code |执行插件时的状态码。 |
|data.file |PPT 文件，有效期 2 小时，请及时转存。 |
|data.historyId |PPT 生成任务 ID。 |
|data.status |PPT 生成过程的状态。 |

## 示例 {#d1b7554c}

例如你可以搭建一个生成 PPT 的智能体，用户仅需输入 PPT 关键信息和模板偏好信息，即可通过运行工作流生成 PPT。工作流运行时，首先通过 iSlide 插件的 get_themes 工具筛选出所需的 PPT 模板，接着通过 generate_outline 工具生成 PPT 大纲，然后由 generate_presentation 工具基于模板 ID 和 PPT 大纲生成 PPT 并返回缩略图 URL。在生成过程中，用户可以确认生成效果，如果满意，工作流将运行 download_presentation 工具返回 PPTX 源文件，不满意则会提示用户重新输入 PPT 关键信息及模板信息，再次生成 PPT。具体操作，请参考[制作 PPT](/tutorial/create_a_ppt)。

![Image=6158x1658](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/05a74b02e5434200906d3918385a69b5~tplv-goo7wpa0wc-image.image)

> * iSlide插件 ID：7525010731419484195