如何在ONLYOFFICE插件中添加自定义AI提供商：以通义千问和Kimi为例

news2025/4/25 13:02:45

随着 ONLYOFFICE AI 插件的发布，我们极大地提升了编辑器的默认功能。在ONLYOFFICE，我们致力于提供强大且灵活的解决方案，以满足您的特定需求。其中一项便是能够在 AI 插件中添加自定义提供商。在这篇文章中，我们将展示如何将通义千问和Kimi 服务集成到 AI 插件中。

(no title)

关于通义千问和 Kimi

通义千问和 Kimi 是专为自然语言处理和文本生成而设计的先进 AI 语言模型。

通义千问：由阿里云开发，是一款功能强大的大型语言模型，它支持各类由 AI 驱动的应用，包括内容创作、聊天机器人以及企业解决方案。
Kimi：由月之暗面（Moonshot AI）开发，是另一个大型语言模型，它以在处理复杂查询、生成类似人类撰写的文本以及辅助完成各类任务方面的高效性而闻名。

这两种模型都具备强大的 AI 能力，使其适合集成到 ONLYOFFICE 人工智能插件中，从而提升文档编辑和自动化水平。

前提条件

在添加自定义提供商之前，请确保完成以下步骤：

获取必要的凭证：从您选择的提供商处获取基本路径、模型版本和 API 密钥
创建专用的 JavaScript 文件：将基本路径、模型版本和 API 密钥存储在一个单独的 JavaScript 文件中

在集成自定义提供商之前，让我们先梳理一下所需的关键凭证：

基本路径：这是发送 API 请求的网址。在某些情况下，基本路径可能包含一个端点，指示了所使用的模型。

 https://dashscope.aliyuncs.com/compatible-mode/

模型版本：它表明了您正在访问的模型的版本。有时，能在基本路径中找到模型版本。

https://api.moonshot.cn/v1

在这个例子中，模型版本是 v1。

API 密钥：这是来自服务提供商的唯一密钥，用于进行身份验证。

创建外部 JavaScript 文件

要添加一个自定义提供商，并让它出现在 AI 插件的提供商列表中，您需要创建并上传一个外部 JS 文件。

从此文件中解析出的自定义提供商是 Provider 类的实例，该类继承自 AI.Provider。这个类负责管理插件内的所有可用提供商。

以下是 Provider 类的参数：

class Provider {
        /**
         * Provider base class.
         * @param {string} name  Provider name.
         * @param {string} url   Url to service.
         * @param {string} key   Key for service. This is an optional field. Some providers may require a key for access.
         * @param {string} addon Addon for url. For example: v1 for many providers. 
         */
        constructor(name, url, key, addon) {
            this.name  = name  || "";
            this.url   = url   || "";
            this.key   = key   || "";
            this.addon = addon || "";
    
            this.models = [];
            this.modelsUI = [];
        }

现在，让我们来看看针对通义千问服务的实现方式：

"use strict";


class Provider extends AI.Provider {


    constructor() {
        super("Alibab Cloud", "https://dashscope.aliyuncs.com/compatible-mode", "yourAPIKey", "v1");
    }


}

其中:

Alibaba Cloud: 这是将显示在插件中的提供商名称。
https://dashscope.aliyuncs.com/compatible-mode: 这是我们发送 API 请求的网址。
yourAPIKey: 我们发送 API 请求所针对的模型版本。
v1: 我们向这个模型的版本发送 API 请求。

Kimi 服务的实现方式如下：

"use strict";


class Provider extends AI.Provider {


    constructor() {
        super("Kimi", " https://api.moonshot.cn", "yourAPIkey", "v1");
    }


}

添加自定义提供商