Aggiungere un fornitore di IA personalizzato

Gli editor di ONLYOFFICE permettono di integrare un fornitore di intelligenza artificiale personalizzato, configurabile in base alle proprie esigenze.

Prerequisiti

Prima di aggiungere un fornitore personalizzato, assicurati di aver completato i seguenti passaggi:

1. Ottieni le credenziali necessarie dal fornitore che hai scelto:

   • URL di base: L'indirizzo web a cui vengono inviate le richieste API. In alcuni casi, l'URL di base può includere un endpoint che specifica il modello utilizzato, ad esempio:

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

   • Versione del modello: Identifica la versione del modello a cui accedi. A volte la versione del modello è inclusa nell'URL di base, ad esempio v1 nel seguente URL:

     https://api.moonshot.cn/v1

   • Chiave API: Una chiave univoca fornita dal fornitore del servizio, utilizzata per l'autenticazione.

Creazione del file JavaScript esterno

Per aggiungere un fornitore personalizzato e visualizzarlo nell'elenco dei fornitori disponibili nel plugin IA, devi creare e caricare un file JS esterno.

I fornitori personalizzati analizzati da questo file sono istanze della classe Provider, che estende AI.Provider. Questa classe gestisce tutti i fornitori disponibili nel plugin.

Di seguito sono riportati i parametri della 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 = [];
    }
}

Vediamo come esempio l'implementazione del servizio Tongyi Qianwen:

"use strict";

class Provider extends AI.Provider {

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

}

Dove:

• Alibaba Cloud è il nome del fornitore che verrà visualizzato nel plugin.
• https://dashscope.aliyuncs.com/compatible-mode è l'indirizzo web a cui inviamo la richiesta API.
• yourAPIKey è la chiave API rilasciata dal fornitore.
• v1 è la versione del modello a cui inviamo la richiesta API.

Aggiunta di un fornitore personalizzato

1. Fai clic con il pulsante destro del mouse su una qualsiasi parola selezionata e vai su IA → Impostazioni nel menu contestuale.
2. Nella finestra Configurazione dell'IA, seleziona Modifica modelli IA.
3. Nella finestra Elenco dei modelli IA, fai clic sull'icona della matita per modificare i modelli.
4. Nella finestra Modifica modello IA, fai clic su Provider personalizzati nell'angolo in basso a sinistra della finestra.
5. Fai clic sull'icona più e carica il file JavaScript contenente le impostazioni del tuo fornitore personalizzato.
6. Fai clic su Indietro per uscire dalla finestra Aggiungi modello IA.
7. Seleziona il tuo fornitore personalizzato dall'elenco nella finestra Aggiungi modello IA e fai clic su OK.
8. Fai clic su Indietro per uscire dalla finestra Elenco dei modelli IA.
9. Imposta il modello del tuo fornitore personalizzato per un'attività specifica nella finestra Configurazione dell'IA.