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.
Artikel zum Thema:
Alle Schlagwörter