官方插件使用会单独收费，不同官方插件的定价说明见 托管智能体定价。
插件与 MCP 的关系：插件中的 MCP 服务需要访问凭据时，通过凭据库（Vault）注入；工具开关规则与智能体自行配置的 MCP 服务相同。详见 MCP。
官方插件与自定义插件
官方插件目录
官方插件目录中只展示已上架的插件。每个插件包含：
通过 API 可以列出当前已上架的官方插件。默认同时返回官方插件与当前项目的自定义插件，使用
scope=official 可只返回官方插件。以下示例中的 API Key 从环境变量 KIMI_API_KEY 读取：
列表响应是分页结构：插件在
items 中返回，响应中的 next_page_token 用于翻页。创建和管理自定义插件
自定义插件可以通过 kha CLI、控制台或 API 创建。以下示例提供 cURL 与 kha CLI 两种写法，介绍校验、创建、发布版本、下载和归档；kha CLI 的自然语言操作见 kha CLI，控制台操作见 控制台。准备插件包
插件压缩包的根目录必须包含清单文件kimi.plugin.json。清单中的主要字段如下：
interface 必须包含以下字段：
使用
skills 时，还要在 interface.skillOverrides 中按技能目录名为每个技能提供 displayName 和 description；使用 mcpServers 时，在 interface.mcpOverrides 中按 MCP 服务键提供这两个字段。
interface 中的文案以 defaultLocale 为基准，还需要在 locales/ 中提供另一种语言的翻译文件：defaultLocale=en-US 时为 zh-CN.json，defaultLocale=zh-CN 时为 en-US.json。本地化文件要包含界面文本以及 skillOverrides、mcpOverrides 中对应内容的完整翻译。
插件包和项目还有以下限制：
- ZIP 最大 64 MiB，展开后最大 128 MiB，最多 500 个条目；
- 每个项目最多 50 个 active 自定义插件；
- 每个插件保留最近 20 个版本。
校验并创建插件
先调用校验接口检查插件包，再创建插件并发布首个版本：report.ok 为 false，按 issues 逐项修改。
plugin、version 和 report。从 .plugin.id 保存插件 ID，后续命令使用 PLUGIN_ID 表示。需要查看当前项目的插件时，运行：
发布新版本
版本号取自插件包清单文件kimi.plugin.json 的 version 字段，不在发布请求中单独指定。更新该字段和插件包内容后，发布新的不可变版本：
version 必须未被发布过，重复时返回 409 conflict_error。新版本的 name 必须与原插件一致，改名需要创建新插件。每次发布都会生成一个不可变版本，版本列表按语义化版本从新到旧排列。
latest 取已发布版本中最高的语义化版本。预发布版本通常不参与计算；没有任何正式版本时，取最高的预发布版本。
下载与归档
下载指定版本的插件包：在智能体中使用插件
官方智能体：开箱即用
平台提供的官方智能体（如 PPT 助手）已经配置好所需插件，无需任何配置。直接用官方智能体创建会话，插件中的 MCP 服务与技能就会在运行时自动生效。在控制台中选择官方智能体创建会话即可开始使用，见 控制台；PPT 助手的配置说明见 官方 PPT 智能体。自定义智能体：按 ID 引用
自定义智能体通过plugins 列表中的 plugin_id 引用插件。官方插件必须已上架，自定义插件需要先创建并发布版本。
官方插件的引用只需给出 plugin_id，不能显式指定 version。自定义插件的引用规则如下：
- 省略
version：在写入智能体版本时固定为当时的最新发布版本； - 指定已发布的精确版本：固定使用该版本；
- 传入
latest：不固定版本，每次唤醒时重新解析为当前版本。
version 或指定精确版本时，响应中的 version 字段可以看到固定结果；传入 latest 时保留该取值，每次唤醒重新解析。官方插件可在控制台的“智能体”页表单中勾选；通过 API 创建或更新智能体时，在 plugins 列表中填入相应的 plugin_id 即可。
官方插件的版本固定规则
官方插件版本由平台维护。每次生成智能体版本时会固定当时的插件版本，已有智能体不会自动升级；需要使用新版本时，更新智能体并重新提交插件引用。在控制台中使用插件
控制台支持浏览官方插件和创建自定义插件，也可以在创建或配置智能体时选择插件。具体入口和操作步骤见 控制台。下一步
为智能体挂载插件
创建与更新智能体，为智能体引用插件。
管理插件版本与归档
发布、下载和归档自定义插件。
管理插件访问凭据
管理插件与 MCP 服务所需的访问凭据。