Ajouter un fournisseur d'IA personnalisé

Les éditeurs ONLYOFFICE vous permettent d'ajouter un fournisseur d'IA personnalisé et de le configurer selon vos préférences.

Prérequis

Avant d'ajouter un fournisseur personnalisé, assurez-vous d'avoir effectué les étapes suivantes :

1. Obtenez les identifiants nécessaires auprès du fournisseur de votre choix :

   • URL de base : L'adresse web à laquelle les requêtes API sont envoyées. Dans certains cas, l'URL de base peut inclure un point de terminaison qui indique le modèle utilisé, par exemple :

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

   • Version du modèle : Elle identifie la version du modèle auquel vous accédez. Parfois, la version du modèle est incluse dans l'URL de base, par exemple v1 dans l'URL suivante :

     https://api.moonshot.cn/v1

   • Clé API : Une clé unique fournie par le fournisseur de services, utilisée pour l'authentification.

Création du fichier JavaScript externe

Pour ajouter un fournisseur personnalisé et l'afficher dans la liste des fournisseurs disponibles dans le plugin d'IA, vous devez créer et télécharger un fichier JS externe.

Les fournisseurs personnalisés analysés à partir de ce fichier sont des instances de la classe Provider, qui étend AI.Provider. Cette classe gère tous les fournisseurs disponibles dans le plugin.

Voici les paramètres de la classe 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 = [];
    }
}

Prenons comme exemple l'implémentation du service Tongyi Qianwen :

"use strict";

class Provider extends AI.Provider {

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

}

Où :

• Alibaba Cloud est le nom du fournisseur qui sera affiché dans le plugin.
• https://dashscope.aliyuncs.com/compatible-mode est l'adresse web à laquelle nous envoyons la requête API.
• yourAPIKey est la clé API délivrée par le fournisseur.
• v1 est la version du modèle à laquelle nous envoyons la requête API.

Ajout d'un fournisseur personnalisé

1. Cliquez avec le bouton droit sur n'importe quel mot sélectionné et accédez à IA → Paramètres dans le menu contextuel.
2. Dans la fenêtre Configuration de l'IA, sélectionnez Modifier les modèles d'IA.
3. Dans la fenêtre Liste des modèles d'IA, cliquez sur l'icône en forme de crayon pour modifier les modèles.
4. Dans la fenêtre Modifier le modèle d'IA, cliquez sur Fournisseurs personnalisés dans le coin inférieur gauche de la fenêtre.
5. Cliquez sur l'icône plus et téléchargez le fichier JavaScript contenant les paramètres de votre fournisseur personnalisé.
6. Cliquez sur Retour pour quitter la fenêtre Ajouter un modèle d'IA.
7. Sélectionnez votre fournisseur personnalisé dans la liste de la fenêtre Ajouter un modèle d'IA et cliquez sur OK.
8. Cliquez sur Retour pour quitter la fenêtre Liste des modèles d'IA.
9. Définissez le modèle de votre fournisseur personnalisé pour une tâche spécifique dans la fenêtre Configuration de l'IA.