ONLYOFFICEのAIプラグインにカスタムプロバイダを追加する方法

2025年03月26日著者:Denis

ONLYOFFICEのAIプラグインのリリースにより、エディターの基本機能が大幅に強化されました。ONLYOFFICE では、お客様の特定のニーズに適応する強力かつ柔軟なソリューションの提供に努めています。その一環として、AI プラグインに任意のカスタムプロバイダーを追加するオプションをご用意しました。このブログ記事では、Tongyi Qianwen と Kimi サービスを AI プラグインに統合する方法を、ステップバイステップでご紹介します。

How to add a custom provider to the ONLYOFFICE AI plugin

Tongyi Qianwen と Kimi について

Alibaba Cloud Tongyi QianwenKimi は、自然言語処理およびテキスト生成のために設計された先進的な AI 言語モデルです。

  • Tongyi Qianwen は、Alibaba Cloud により開発された強力な大規模言語モデルで、コンテンツ作成、チャットボット、企業向けソリューションなど、さまざまな AI 主導のアプリケーションをサポートします。
  • Kimi は、Moonshot AI によって開発された大規模言語モデルで、複雑な問い合わせへの対応、人間らしいテキスト生成、各種タスクの支援に優れた効率を発揮します。

両モデルは堅牢な AI 機能を提供しており、ONLYOFFICE AI プラグインに統合することで、ドキュメント編集や自動化をより一層強化できます。

事前準備

カスタムプロバイダーを追加する前に、以下のステップを完了してください:

  1. 必要な認証情報を取得する: 選択したプロバイダーから、base URLmodel version、および API key を取得します。
  2. 専用の JavaScript ファイルを作成する: base URL、model version、および API key を別の JavaScript ファイルに保存します。

カスタムプロバイダーを統合する前に、必要となる主要な認証情報を以下に示します:

  • Base URL: API リクエストを送信するウェブアドレスです。場合によっては、使用するモデルを指定するエンドポイントが含まれることもあります:
 https://dashscope.aliyuncs.com/compatible-mode/
  • Model Version: アクセスしているモデルのバージョンを識別します。場合によっては、モデルバージョンが base URL に含まれることもあります:
https://api.moonshot.cn/v1

この例では、モデルバージョンは v1 です。

  • API Key: サービスプロバイダーから提供される固有のキーで、認証に使用されます。

外部 JavaScript ファイルの作成

カスタムプロバイダーを追加し、AI プラグイン内の利用可能なプロバイダー一覧に表示するためには、外部 JS ファイルを作成してアップロードする必要があります。

このファイルから解析されたカスタムプロバイダーは、AI.Provider を拡張した 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 = [];
        }
}

それでは、Tongyi Qianwen サービスの実装例を見てみましょう:

"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");
    }


}

カスタムプロバイダーの追加

  • 任意の選択された単語を右クリックし、AI > Settings に移動します.

How to add a custom provider to the ONLYOFFICE AI plugin

  • 「AI Configuration」ウィンドウで、Edit AI Models を選択します.

How to add a custom provider to the ONLYOFFICE AI plugin

  • 「AI Models list」ウィンドウで、モデルを編集するために鉛筆アイコンをクリックします.

How to add a custom provider to the ONLYOFFICE AI plugin

  • 「Edit AI Model」ウィンドウで、custom providers をクリックします.

How to add a custom provider to the ONLYOFFICE AI plugin

  • プラスアイコンをクリックして、カスタムプロバイダー設定を含む JavaScript ファイルをアップロードします.

How to add a custom provider to the ONLYOFFICE AI plugin

  • 「Add AI Model」ウィンドウを終了するために Back をクリックします.

How to add a custom provider to the ONLYOFFICE AI plugin

  • 「Add AI Model」ウィンドウのリストからカスタムプロバイダーを選択し、OK をクリックします.

Tongyi Qianwen:

How to add a custom provider to the ONLYOFFICE AI plugin

Kimi:

How to add a custom provider to the ONLYOFFICE AI plugin

  • 「AI Models list」ウィンドウを終了するために Back をクリックします.

How to add a custom provider to the ONLYOFFICE AI plugin

  • 「AI Configuration」ウィンドウで、特定のタスクに対してカスタムプロバイダーモデルを設定します.

How to add a custom provider to the ONLYOFFICE AI plugin

これらのステップを完了すると、AI プラグインは完全に構成され、幅広いタスクを支援する準備が整います!

ONLYOFFICE では、お客様の特定のニーズに応じた多機能な機能を提供することに努めています。この新機能は、私たちの革新への取り組みを反映しています。このチュートリアルがカスタムプロバイダーの設定を簡単にする一助となれば幸いです。ご質問やご提案がございましたら、お問い合わせください。皆様からのフィードバックやご協力を心よりお待ちしております!

ONLYOFFICEの無料アカウントを登録する

オンラインでドキュメント、スプレッドシート、スライド、フォーム、PDFファイルの閲覧、編集、共同作業