كيفية إضافة مزود مخصص إلى إضافة ONLYOFFICE AI

٢٧ مارس ٢٠٢٥بواسطة Moncif MEFTAH

مع إطلاق إضافة ONLYOFFICE AI، قمنا بتعزيز الوظائف الافتراضية لمحرراتنا بشكل ملحوظ. في ONLYOFFICE، نلتزم بتوفير حلول قوية ومرنة تتكيف مع احتياجاتكم الفريدة. أحد هذه الحلول هو إمكانية إضافة أي مزود مخصص إلى إضافة الذكاء الاصطناعي الخاصة بنا. في هذه المدونة، سنوضح بالتفصيل كيفية دمج خدمات Tongyi Qianwen و Kimi في إضافة الذكاء الاصطناعي، مع تقديم دليل خطوة بخطوة خلال العملية.

How to add a custom provider to the ONLYOFFICE AI plugin

حول Tongyi Qianwen و Kimi

Alibaba Cloud Tongyi Qianwen و Kimi هما نموذجان لغويان متقدمان للذكاء الاصطناعي، مصممان لمعالجة اللغة الطبيعية وتوليد النصوص.

Tongyi Qianwen, هو نموذج لغوي كبير وقوي يدعم تطبيقات متنوعة تعتمد على الذكاء الاصطناعي، بما في ذلك إنشاء المحتوى، وروبوتات المحادثة، وحلول المؤسسات.
Kimi, هو نموذج لغوي كبير آخر معروف بكفاءته في التعامل مع الاستعلامات المعقدة، وتوليد نصوص شبيهة بالنصوص البشرية، والمساعدة في مهام متنوعة.

يقدم كلا النموذجين قدرات ذكاء اصطناعي قوية، مما يجعلهما مناسبين للدمج في إضافة ONLYOFFICE AI لتعزيز تحرير المستندات والأتمتة.

المتطلبات الأساسية

قبل إضافة مزود مخصص، تأكدوا من إكمال الخطوات التالية:

الحصول على بيانات الاعتماد اللازمة: استرداد عنوان URL الأساسي، وإصدار النموذج، ومفتاح API من المزود الذي اخترتموه.
إنشاء ملف JavaScript مخصص: تخزين عنوان URL الأساسي، وإصدار النموذج، ومفتاح API في ملف JavaScript منفصل.

قبل دمج مزود مخصص، دعونا نحلل بيانات الاعتماد الرئيسية التي ستحتاجونها:

عنوان URL الأساسي: هذا هو عنوان الويب الذي يتم إرسال طلبات API إليه. في بعض الحالات، قد يتضمن عنوان URL الأساسي نقطة نهاية تحدد النموذج المستخدم:

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

إصدار النموذج: يحدد إصدار النموذج الذي تستخدمونه. في بعض الأحيان، يتم تضمين إصدار النموذج في عنوان URL الأساسي:

https://api.moonshot.cn/v1

إصدار النموذج هو v1 في هذا المثال.

مفتاح API: مفتاح فريد مقدم من مزود الخدمة، يستخدم للمصادقة.

إنشاء ملف JavaScript خارجي

لإضافة مزود مخصص وعرضه في قائمة المزودين المتاحين داخل إضافة الذكاء الاصطناعي، تحتاجون إلى إنشاء وتحميل ملف JS خارجي.

المزودون المخصصون الذين يتم تحليلهم من هذا الملف هم نسخ من فئة Provider، التي توسع AI.Provider. تدير هذه الفئة جميع المزودين المتاحين داخل الإضافة.

فيما يلي معلمات فئة 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 = [];
        }

الآن دعونا نلقي نظرة على تطبيقنا لخدمة Tongyi Qianwen:

"use strict";


class Provider extends AI.Provider {


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


}

حيث:

Alibaba Cloud: اسم المزود الذي سيتم عرضه في الإضافة.
https://dashscope.aliyuncs.com/compatible-mode: عنوان الويب الذي نرسل إليه طلب API.
yourAPIKey: مفتاح API الصادر عن المزود.
v1: إصدار النموذج الذي نرسل إليه طلب API.

تطبيق خدمة Kimi هو التالي:

"use strict";


class Provider extends AI.Provider {


    constructor() {
        super("Kimi", " https://api.moonshot.cn", "yourAPIkey", "v1");
    }


}

إضافة المزود المخصص

انقر بزر الماوس الأيمن على أي كلمة محددة وانتقلوا إلى AI > الإعدادات.

How to add a custom provider to the ONLYOFFICE AI plugin

في نافذة AI Configuration، حددوا Edit AI models.

How to add a custom provider to the ONLYOFFICE AI plugin

في نافذة قائمة نماذج الذكاء الاصطناعي، انقروا على أيقونة قلم الرصاص لتحرير النماذج.

How to add a custom provider to the ONLYOFFICE AI plugin

في نافذة Edit AI Model، انقروا على custom providers.

How to add a custom provider to the ONLYOFFICE AI plugin

انقروا على أيقونة علامة الجمع وقوموا بتحميل ملف JavaScript الذي يحتوي على إعدادات المزود المخصص الخاص بكم.

How to add a custom provider to the ONLYOFFICE AI plugin

انقروا على رجوع للخروج من نافذة إضافة نموذج الذكاء الاصطناعي.

How to add a custom provider to the ONLYOFFICE AI plugin

حددوا المزود المخصص الخاص بكم من القائمة في نافذة Add AI Model وانقروا على موافق.

:Tongyi Qianwen

How to add a custom provider to the ONLYOFFICE AI plugin

:Kimi

How to add a custom provider to the ONLYOFFICE AI plugin

انقروا على رجوع للخروج من نافذة قائمة نماذج الذكاء الاصطناعي.

How to add a custom provider to the ONLYOFFICE AI plugin

قوموا بتعيين نموذج المزود المخصص الخاص بكم لمهمة معينة في AI Configuration.

How to add a custom provider to the ONLYOFFICE AI plugin

بعد إكمال هذه الخطوات، يتم تكوين إضافة الذكاء الاصطناعي بالكامل وتكون جاهزة للمساعدة في مجموعة متنوعة من المهام!

في ONLYOFFICE، نلتزم بتوفير وظائف متعددة الاستخدامات تلبي احتياجاتكم الفريدة. تعكس هذه الميزة الجديدة تفانينا في الابتكار. نأمل أن يساعدكم هذا الدليل في إعداد المزود المخصص الخاص بكم بسهولة. إذا كانت لديكم أي أسئلة أو اقتراحات، فلا تترددوا في التواصل,، نرحب بتعليقاتكم وتعاونكم!