火山引擎插件
1. 简介
1.1 插件简介
火山引擎插件基于豆包大语言模型，支持用户设定模型角色、选择豆包模型和思考模式等豆包的基本信息。用户可通过文字和上传图片进行提问，也可直接生成图片，全面提升企业管理中的业务协作效率和创意表达能力。
1.2 使用场景
适用于各类需要文字处理、图片总结、图片生成的场景中。如
- 撰写项目总结、工作规划、培训内容等；
- 公文润色、语言翻译、用户服务中的对话模拟、个人工作助手等；
- 品牌物料设计、海报制作、视觉内容生成等创意场景。
1.3 预期效果
以撰写简道云十周年宣传文案为例，效果如下所示：
1.4 使用说明
火山引擎插件中，官方接口为付费函数，需付费调用。详情如下：
在使用插件时自动扣除云币数量，当云币余额可支付的识别次数为 0 时，将无法使用火山引擎插件。
2. 获取插件配置参数
2.1 火山引擎平台配置
2.1.1 创建API Key
登录 火山方舟管理控制台，在「API Key 管理」中点击「创建 API Key」，在创建页面中，输入名称及权限后，点击「创建」即可创建成功。
2.1.2 获取API Key
创建成功后，在「API Key 管理」页面中，查看并复制保存对应的 API Key 值。
2.1.3 开通大语言模型
在「开通管理 >> 大语言模型」中，开通如下所示 15 个大语言模型服务：
- deepseek-v4-flash-260425
- deepseek-v4-pro-260425
- doubao-seed-1-6-vision-250815
- doubao-seed-1-6-flash-250828
- doubao-seed-1-6-250615
- doubao-1-5-vision-pro-32k-250115
- doubao-seed-2-0-code-preview-260215
- doubao-seed-1-8-251228
- doubao-seed-2-0-lite-260428
- doubao-seed-2-0-lite-260215
- doubao-seed-2-0-mini-260428
- doubao-seed-2-0-pro-260215
- doubao-seed-character-251128
- glm-4-7-251222
- deepseek-v3-2-251201
以开通 deepseek-v4-flash-260425 大语言模型服务为例，如下所示：
2.2 获取简道云API KEY
在「开放平台 >> 密钥管理 >> API Key」处，创建并获取简道云 API Key。
3. 插件安装及启用
3.1 安装插件
1）直接安装
- 您可点击右方链接直接安装插件：火山引擎插件。
- 安装成功后，可参考本文【3.2 配置插件】和【3.3 启用插件】，前往「开放平台 >> 插件管理」处启用插件。
2）插件市场处安装
在简道云「插件市场」处，安装「火山引擎」插件。插件市场处安装方法可参见文档：插件市场中【2.3插件安装】。
3.2 配置插件
在「插件管理」处，点击插件右侧的「设置」按钮，进行如下所示配置：
- ApiKey：将【2.1.2 获取 API Key】中获取到的 API Key 的值配置进去；
- 简道云 API KEY：将【2.2 获取简道云 API KEY】中获取到的简道云 API KEY 配置进去。
注：
1）若插件配置时选择官方接口，则 ApiKey 无需填写；仅选择自定义配置时进行填写。
2）若需要使用「图片生成」函数，需要填写简道云 API KEY，否则将导致插件执行失败。
3.3 启用插件
在插件管理中，打开「火山引擎」插件右侧开关，启用插件。
4. 表单搭建
插件使用可先安装：火山引擎插件应用模板，本文将按照示例表单进行讲解。
插件配置需要如下 2 张表单：
- 智能对话：填写豆包模型、用户提问等基本信息，并将 AI 推理过程、回答内容和 token 用量回填至表单中；
- 图片生成：填写图片提示词和参考图，并将 AI 生成的图片回填至表单中。
5. 前端事件配置
「单次问答-官方接口」和「单次问答-自定义配置」的插件配置内容相同，本节以「单次问答-官方接口」为例进行讲解。
5.1 添加按钮执行动作
点击「是否开始提问」按钮，在「字段属性 >> 执行动作」处点击「设置」，添加前端事件：
5.2 设置事件名称和说明
添加好前端事件后，首先设置前端事件的基础信息，即事件名称和事件说明，用于区分前端事件：
5.3 设置执行动作
设置执行动作如下：
- 选择插件：选择「火山引擎 >> 单次问答-官方接口」插件；
- 模型选择：设置为字段值，即「豆包模型选择」字段；
- 模型角色设定：设置为字段值，即「模型角色设定」字段；
- 图片：选择赋值方式为「按子表单赋值」，并选择「图片内容」子表单：
- 链接：设置为字段值，即「图片内容.上传图片」字段；
- 精细度：选择自定义，用户可根据企业实际需求选择 high、low、auto；
- 用户问题：设置为字段值，即「问题」字段；
- 思考模式：设置为字段值，即「思考模式」字段；
- 字段存储关系：点击添加按钮，设置字段存储关系如下所示：
- 将提问 Token 用量的值存储到「提问所用 token」中；
- 将回答 Token 用量的值存储到「生成回答所用 token」中；
- 将总 Token 消耗量的值存储到「本次问答总 token 用量」中；
- 将 AI 推理过程的值存储到「AI 推理过程」中；
- 将 AI 回复内容的值存储到「AI 回复内容」中；
全部设置完成后，点击「保存」按钮。
6. 智能助手配置
- 图片生成主要通过智能助手来实现，「图片生成-官方接口」和「图片生成-自定义配置」的插件配置内容相同，本节以「图片生成-官方接口」为例进行讲解。
- 开始配置前，请确保在「插件管理 >> 插件配置」处填写了简道云 API KEY。
6.1 新建智能助手
进入「图片生成」表单中，在「扩展功能 >> 智能助手」处新建智能助手「生成 AI 图片」，设置触发方式为「表单触发」，触发表单设置为「图片生成表」。
6.2 设置触发动作
设置表单触发动作如下：
- 触发动作：勾选「新增数据时」；
6.3 配置插件节点
点击节点连接线上的加号按钮，添加插件节点，插件节点设置如下：
- 执行插件：选择「火山引擎 >> 图片生成-官方接口」；
- 模型：设置为自定义，企业可根据需求在下拉框中进行选择，如 doubao-seedream-4-0-250828；
- 提示词：设置为字段值，即「触发数据-图片需求提示词」；
- 参考图片：选择赋值方式为「逐行赋值」，添加链接字段设置如下：
- 设置为「组合」，即「触发数据-参考图（可选）（URL）」字段；
- 图片尺寸：设置为自定义，企业可自定义设置，如 2K；
- 返回格式：设置为自定义，插件支持 url、b64_json 两种格式；
- 添加水印：设置为自定义，企业可根据需求选择 false 或者 true；
- 图片回填字段：设置为组合，即「触发数据-图片生成结果（ID）」；
- 应用 ID：设置为字段值，即「触发数据-应用 ID」；
- 表单 ID：设置为字段值，即「触发数据-表单 ID」；
- 数据 ID：设置为字段值，即「触发数据-数据 ID」。
7. 注意事项
选择如下 5 个模型时，不支持将思考模式设置为 auto，否则插件将执行失败：
- doubao-seed-2-0-code-preview-260215
- doubao-seed-1-8-251228
- doubao-seed-2-0-lite-260428
- doubao-seed-2-0-mini-260428
- doubao-seed-2-0-pro-260215
400-111-0890
在线咨询