Hinzufügen eines benutzerdefinierten KI-Anbieters

Die ONLYOFFICE-Editoren ermöglichen es Ihnen, einen benutzerdefinierten KI-Anbieter hinzuzufügen und ihn nach Ihren Wünschen zu konfigurieren.

Voraussetzungen

Bevor Sie einen benutzerdefinierten Anbieter hinzufügen, stellen Sie sicher, dass Sie die folgenden Schritte abgeschlossen haben:

1. Beschaffen Sie die notwendigen Zugangsdaten vom Anbieter Ihrer Wahl:

   • Basis-URL: Die Webadresse, an die API-Anfragen gesendet werden. In einigen Fällen kann die Basis-URL einen Endpunkt enthalten, der das verwendete Modell angibt, zum Beispiel:

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

   • Modellversion: Diese identifiziert die Version des Modells, auf das Sie zugreifen. Manchmal ist die Modellversion in der Basis-URL enthalten, zum Beispiel v1 in der folgenden URL:

     https://api.moonshot.cn/v1

   • API-Schlüssel: Ein eindeutiger Schlüssel, der vom Dienstanbieter bereitgestellt wird und zur Authentifizierung dient.

Erstellen der externen JavaScript-Datei

Um einen benutzerdefinierten Anbieter hinzuzufügen und ihn in der Liste der verfügbaren Anbieter im KI Plugin anzuzeigen, müssen Sie eine externe JS-Datei erstellen und hochladen.

Benutzerdefinierte Anbieter, die aus dieser Datei ausgelesen werden, sind Instanzen der Provider-Klasse, die AI.Provider erweitert. Diese Klasse verwaltet alle verfügbaren Anbieter innerhalb des Plugins.

Nachfolgend sind die Parameter der Provider-Klasse aufgeführt:

class Provider {
    /**
     * Basisklasse des Anbieters.
     * @param {string} name  Name des Anbieters.
     * @param {string} url   URL zum Dienst.
     * @param {string} key   Schlüssel für den Dienst. Dies ist ein optionales Feld. Einige Anbieter benötigen einen Schlüssel für den Zugriff.
     * @param {string} addon Zusatz für die URL. Zum Beispiel: v1 für viele Anbieter.
     */
    constructor(name, url, key, addon) {
        this.name  = name  || "";
        this.url   = url   || "";
        this.key   = key   || "";
        this.addon = addon || "";

        this.models = [];
        this.modelsUI = [];
    }
}

Schauen wir uns als Beispiel die Implementierung des Tongyi Qianwen-Dienstes an:

"use strict";

class Provider extends AI.Provider {

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

}

Dabei gilt:

• Alibaba Cloud ist der Name des Anbieters, der im Plugin angezeigt wird.
• https://dashscope.aliyuncs.com/compatible-mode ist die Webadresse, an die wir die API-Anfrage senden.
• yourAPIKey ist der vom Anbieter ausgestellte API-Schlüssel.
• v1 ist der URL-Zusatz, der den API-Endpunkt angibt.

Hinzufügen eines benutzerdefinierten Anbieters

1. Klicken Sie mit der rechten Maustaste auf ein beliebiges ausgewähltes Wort und navigieren Sie im Kontextmenü zu KI → Einstellungen.
2. Wählen Sie im Fenster KI-Konfiguration KI-Modelle bearbeiten aus.
3. Klicken Sie im Fenster Liste der KI-Modelle auf das Stiftsymbol, um Modelle zu bearbeiten.
4. Klicken Sie im Fenster KI-Modell bearbeiten unten links auf benutzerdefinierte Anbieter.
5. Klicken Sie auf das Plus-Symbol und laden Sie die JavaScript-Datei mit Ihren benutzerdefinierten Anbietereinstellungen hoch.
6. Klicken Sie auf Zurück, um das Fenster KI-Modell hinzufügen zu verlassen.
7. Wählen Sie Ihren benutzerdefinierten Anbieter aus der Liste im Fenster KI-Modell hinzufügen aus und klicken Sie auf OK.
8. Klicken Sie auf Zurück, um das Fenster Liste der KI-Modelle zu verlassen.
9. Stellen Sie Ihr benutzerdefiniertes Anbietermodell für eine bestimmte Aufgabe im Fenster KI-Konfiguration ein.