Özel AI sağlayıcısı ekleme

ONLYOFFICE düzenleyicileri, özel bir AI sağlayıcısı eklemenize ve bunu tercihlerinize göre yapılandırmanıza olanak tanır.

Ön koşullar

Özel bir sağlayıcı eklemeden önce aşağıdaki adımları tamamladığınızdan emin olun:

1. Seçtiğiniz sağlayıcıdan gerekli kimlik bilgilerini edinin:

   • Base URL: API isteklerinin gönderildiği web adresi. Bazı durumlarda temel URL, kullanılan modeli belirten bir uç nokta içerebilir, örneğin:

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

   • Model Version: Eriştiğiniz modelin sürümünü belirtir. Bazen model sürümü temel URL'ye dahildir, örneğin aşağıdaki URL'deki v1:

     https://api.moonshot.cn/v1

   • API Key: Hizmet sağlayıcı tarafından verilen ve kimlik doğrulamada kullanılan benzersiz anahtar.

Harici JavaScript dosyasını oluşturma

Özel bir sağlayıcı ekleyip AI eklentisindeki kullanılabilir sağlayıcılar listesinde görüntülemek için harici bir JS dosyası oluşturup yüklemeniz gerekir.

Bu dosyadan ayrıştırılan özel sağlayıcılar, AI.Provider sınıfını genişleten Provider sınıfının örnekleridir. Bu sınıf, eklenti içindeki tüm kullanılabilir sağlayıcıları yönetir.

Aşağıda Provider sınıfının parametreleri verilmiştir:

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 = [];
    }
}

Örnek olarak Tongyi Qianwen hizmetinin uygulanmasına bakalım:

"use strict";

class Provider extends AI.Provider {

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

}

Burada:

• Alibaba Cloud, eklentide görüntülenecek sağlayıcı adıdır.
• https://dashscope.aliyuncs.com/compatible-mode, API isteğini gönderdiğimiz web adresidir.
• yourAPIKey, sağlayıcı tarafından verilen API anahtarıdır.
• v1, API isteğini gönderdiğimiz modelin sürümüdür.

Özel sağlayıcı ekleme

1. Seçili herhangi bir kelimeye sağ tıklayın ve bağlam menüsünde AI → Settings seçeneğine gidin.
2. AI Configuration penceresinde Edit AI models seçeneğini belirleyin.
3. AI Models list penceresinde modelleri düzenlemek için kalem simgesine tıklayın.
4. Edit AI Model penceresinde, pencerenin sol alt köşesindeki custom providers seçeneğine tıklayın.
5. Artı simgesine tıklayın ve özel sağlayıcı ayarlarınızı içeren JavaScript dosyasını yükleyin.
6. Add AI Model penceresinden çıkmak için Back düğmesine tıklayın.
7. Add AI Model penceresindeki listeden özel sağlayıcınızı seçin ve OK düğmesine tıklayın.
8. AI Models list penceresinden çıkmak için Back düğmesine tıklayın.
9. AI Configuration penceresinde özel sağlayıcı modelinizi belirli bir görev için ayarlayın.