Odoo 19: qarşılıqlı yoxlama ilə süni intellekt tərcüməsi — bir neçə süni intellekt modelinin bir-birini yoxladığı ai_translation_consensus modulu

Bir süni intellekt vasitəsilə veb-səhifəni on, iyirmi və ya qırx dilə tez tərcümə etmək mümkündür. Daha çətin məsələ nəticəyə etibar edib-etməməkdir. Tək bir dil modeli bəzən söz uydurur, məhsul adlarını da tərcümə edir və ya hansısa rəqəmi dəyişir, özü də bunu fərq etmir. Buna görə Odoo 19 üçün elə bir modul hazırlamışıq ki, burada bir neçə süni intellekt və tərcümə xidməti eyni mətn üzərində işləyir, bir-birinin nəticələrini anonim qiymətləndirir və həm dəqiq, həm də təbii səslənən ifadə üzərində razılığa gəlir. Birmənalı olmayan hallarda qərarı insan verir.

Modul ai_translation_consensus adlanır və GitHub-da AGPL-3 lisenziyası ilə azad proqram təminatı kimi təqdim olunur:

github.com/Alex0176/odoo-ai-translation-consensus

İdeya: etibar etmək əvəzinə qarşılıqlı yoxlama

Modul iki işi yerinə yetirə bilir:

• Tərcümə: Odoo-da tərcümə edilə bilən hər sahənin çatışmayan və ya köhnəlmiş tərcümələrini tamamlayır: bloq yazıları, veb-səhifələr, menyular, məhsullar və Odoo-nun bir neçə dildə saxladığı bütün digər məzmunlar. Süni intellekt modelləri yalnız ayrı-ayrı cümlələri deyil, qonşu blokları və bütöv səhifədən bir hissəni də görür. Beləliklə, ayrı-ayrı sözlər düzgün kontekstdə başa düşülür.
• Korrektə: Mətni öz dilində yoxlayır, daha yaxşı ifadələr və ya düzəlişlər təklif edir. Orijinal mətn həmişə namizəd variantlardan biri olur. Orijinal qalib gəlsə, heç nə dəyişmir.

Əsas prinsip qarşılıqlı yoxlamadır. Hər süni intellekt modeli bəzən özü səhv etsə də, başqalarının mətnlərini yaxşı qiymətləndirə bilir. Modul bundan istifadə edir: bir neçə provayder hərəsi bir variant hazırlayır, sonra həmin provayderlər variantların kimə məxsus olduğunu bilmədən onların hamısını qiymətləndirir. Heç bir provayder öz variantını qiymətləndirmir.

Tərcümə təklifi necə hazırlanır

1. Tərcümə. Hər tərcüməçi paralel olaraq bir variant hazırlayır.
2. Sabit yoxlamalar. HTML teqlərinin, xüsusi simvol kodlarının, %s və ya {} kimi yer tutucuların, rəqəmlərin və keçidlərin dəyişməz qaldığı süni intellektdən istifadə edilmədən yoxlanılır. Bu tələbləri pozan variant nə qədər axıcı səslənsə də, qalib gələ bilməz.
3. Qiymətləndirmə. Qalan variantlar qarışdırılır və anonimləşdirilir. Hər yoxlayıcı hər varianta dəqiqlik və təbiilik üzrə 1-dən 10-a qədər bal verir, ən yaxşı hesab etdiyi variantı seçir və təkmilləşdirmə təklif edə bilir.
4. Razılaşma. Variantın yekun balı belə hesablanır: 0,5 × orta bal + 5 × üstünlük səslərinin payı. Ən yaxşı variant üstünlük səslərinin ən azı 60 %-ni toplayıbsa və orta balı ən azı 7,0-dırsa, razılaşma əldə edilmiş sayılır.
5. İkinci mərhələ. Razılaşma əldə edilməzsə, ən yaxşı variantlar yoxlayıcıların təkmilləşdirmə təklifləri ilə birlikdə yenidən qiymətləndirilir.
6. İnsan qərarı. Bundan sonra da aydın nəticə əldə olunmazsa, təklif qərar verilməsini gözləyir.

Yalnız yoxlama funksiyası olmayan tərcümə xidmətlərindən (məsələn, DeepL) istifadə edilirsə, nəticə ancaq ən azı iki xidmət tam eyni mətn təqdim etdikdə razılaşdırılmış sayılır. Korrektə zamanı nəticələr orijinala nəzərəçarpacaq dərəcədə oxşar qalmalıdır: oxşarlıq ən azı 0,6 olmalı, rəqəmlər dəyişməməlidir. Kiçik pulsuz modellər bəzən mətn paketinə cavab olaraq sırası qarışmış və ya əlaqəsiz mətnlər qaytarır. Belə cavablar səsverməyə çıxarılmadan rədd edilir. Terminlər lüğəti brend adlarını və sabit terminləri müəyyənləşdirir.

Xidmət təminatçıları: açarla və açarsız

Pulsuz və ödənişli xidmətlər eyni səsvermədə iştirak edə bilər. Modul bir çox provayder üçün əvvəlcədən hazırlanmış parametrlərlə gəlir; quraşdırmadan sonra onların hamısı deaktivdir.

Açarı və ya onu saxlayan mühit dəyişəninin adını daxil edin, Bağlantını yoxla düyməsini basın və provayderi aktivləşdirin. İlkin parametrlərdəki model adları başlanğıc nöqtəsidir; onlardan istifadə edənlər bu adları provayderin cari siyahısı ilə tutuşdurmalıdır. İki və ya daha çox provayder olduqda həqiqi qarşılıqlı yoxlama aparılır; yalnız bir provayder olduqda isə onun işini heç kim yoxlamır. Köməkçi bu barədə xəbərdarlıq edir.

Bütöv veb-səhifənin bir dəfəyə tərcüməsi

İlkin sazlama köməkçisi (Süni intellektlə tərcümə → Buradan başlayın menyusu) addımları izah edir və ilk qaydanı yaradır. website modulu quraşdırılıbsa, ai_translation_consensus_website inteqrasiya modulu da avtomatik quraşdırılır. O, “Bütün məzmunu ilə birlikdə bütöv veb-sayt” əhatə dairəsini əlavə edir: veb-saytı seçirsiniz və sistem uyğun məzmunu təklif edir. Modul veb-sayta aid tərcümə edilə bilən sahələri olan bütün modelləri — səhifələri, menyuları, bloqları, məhsulları, tədbirləri, forumları, kursları və digərlərini — nəzərdən keçirir və hədəf dillər kimi veb-saytın dillərini götürərək hər məzmun növü üçün bir qayda təklif edir.

• Quraşdırılmamış funksiyalar (forumlar, kurslar, qalereyalar) göstərilmir; sonradan quraşdırılan kimi siyahıya əlavə olunur.
• Mağaza modelləri yalnız veb-saytda mağaza olduqda təklif edilir. Yalnız dərc edilmiş qeydlər nəzərə alınır.
• Modul kontaktları, şirkətləri, ödəniş provayderlərini, qiymət siyahılarını, çatdırılma üsullarını, loyallıq proqramlarını və məzmun bloku filtrlərini bilərəkdən təklif etmir.
• Səhifələrin ünvan adları (seo_name) tərcümə edilmir.
• İstəmədiyiniz növləri qaydalar yaradılmazdan əvvəl çıxara bilərsiniz.

Yaratma və axtarış heç bir xərc yaratmır: qayda yalnız hansı mətnlər üzərində işləmək lazım olduğunu siyahıya alır. Provayderlərə yalnız emal zamanı sorğu göndərilir və xərc yaranır.

İdarəetmə paneli, xərclər və avtomatik başlatma

İdarəetmə paneli hər qayda üzrə neçə mətnin hazır olduğunu, təsdiq və ya insan qərarı gözlədiyini, növbədə olduğunu və ya emalının uğursuz bitdiyini göstərir. Burada dil və provayder üzrə bölgü, indiyədək çəkilmiş və gözlənilən xərclər, təxmini qalan vaxt və planlı emalı aktivləşdirən seçim də var.

Bu şəkildəki rəqəmlər nümunə məlumatlardır və real xərcləri əks etdirmir.

• Xərclər provayderlərin faktiki bildirdiyi istifadəyə əsasən hesablanır: tokenlər (OpenAI, Anthropic, Gemini, Cohere) və ya simvollar (DeepL, Google, Azure). Tokenlər həmişə göstərilir, pul məbləği isə yalnız provayder üçün hər milyon tokenə və ya simvola düşən qiyməti daxil etdiyiniz halda göstərilir. Qiymətlər dəyişdiyi üçün ilkin parametrlərdə qiymət yoxdur. Token sayını bildirməyən xidmətlər üçün bu say mətnin uzunluğuna əsasən təxmin edilir və təxmini göstərici kimi işarələnir.
• Proqnoz: Hər mətn üçün orta xərc və emal müddəti növbədəki mətnlərin sayına vurulur. Bu, ilk paketlər emal olunduqca daha dəqiq olan təxmini hesablamadır.
• Avtomatik başlama: Qeyd dəyişdikdə avtomatik başlat seçimi aktiv olan qaydalar planlaşdırılmış əməliyyatın hər icrasında yalnız son axtarışdan sonra dəyişdirilmiş qeydləri axtarır. Beləliklə, planlaşdırılmış əməliyyat aktivdirsə, redaktə edilmiş veb-sayt əlavə müdaxilə olmadan yenidən tərcümə edilir.
• Tamamlanma bildirişi: Qaydanın son gözləyən mətni emal edildikdə AI Translation kanalında bir dəfə “Bütün dillərə tərcümə tamamlandı” (korrektə zamanı “Bütün mətnlər yoxlanıldı”) mesajı görünür.

İnsan tərəfindən təsdiq

Standart olaraq modul razılığınız olmadan qeydlərinizə heç nə yazmır. Hər təklifdə variantlar, onları kimin hazırladığı, ballar və yoxlayıcıların qeydləri göstərilir. Təklifi qəbul edə, başqa variantı seçə, öz mətninizi yaza və ya təklifi rədd edə bilərsiniz.

Bu şəkildəki mətn və provayder adları görünüşü nümayiş etdirmək üçün uydurulub.

Qaydaya etibar edirsinizsə, Razılaşdırılmış nəticəni avtomatik qəbul et seçimini aktivləşdirə bilərsiniz. Bu halda da razılaşma əldə olunmayan təkliflər insan qərarını gözləyir. Qəbul zamanı modul mənbə mətnin bu müddətdə dəyişib-dəyişmədiyini yenidən yoxlayır, işarələmə yoxlamalarını təkrarlayır və dəyişiklikləri izləmə qeydi yaratmadan, izləyicilərə bildiriş göndərmədən yazır.

Təhlükəsizlik və məlumatların qorunması

• Quraşdırmadan sonra hər şey deaktivdir. Provayderlər və planlaşdırılmış əməliyyat söndürülüb. Sizin müdaxiləniz olmadan heç nə göndərilmir.
• Xarici serverdə yerləşən xidmət prosesə qoşulan kimi mətnlər serverinizdən kənara ötürülür. Qaydanı Məxfi kimi işarələmək olar; bu halda mətni yalnız öz infrastrukturunda işlədiyi qeyd olunan provayderlər görür.
• Açarlar yalnız administratorların görə bildiyi sahədə və ya yalnız adı ilə istinad edilən mühit dəyişənində saxlanılır. Xəta mesajlarında gizlədilir və sorğu başlıqları vasitəsilə göndərilir. İstisna: MyMemory-nin istəyə bağlı açarı yalnız sorğu parametri kimi ötürülə bilir.
• Lokal əmr proqram işə saldığı üçün ai_translation_consensus.allow_command sistem parametri True olaraq təyin edilənədək bloklanır. Əmr əmr qabığı olmadan çağırılır və boş müvəqqəti qovluqda işləyir.
• Prompt inyeksiyası: Tapşırıqlarda mətnin məlumat olduğu bildirilir. Tərcümə olunan mətnin daxilindəki göstərişlərə əməl edilmir, teqləri və ya yer tutucuları pozan nəticə isə rədd edilir.
• Pulsuz xidmətlərin məhdudiyyətləri var. Pollinations anonim istifadə zamanı hər 45 saniyədə bir cavaba icazə verir. Provayderin min_interval seçimi bu intervalı qoruyur və “Daha sonra yenidən cəhd edin” cavabları nəzərə alınır.

Quraşdırma

git clone https://github.com/Alex0176/odoo-ai-translation-consensus.git
ln -s /pfad/odoo-ai-translation-consensus/ai_translation_consensus /pfad/addons/
ln -s /pfad/odoo-ai-translation-consensus/ai_translation_consensus_website /pfad/addons/
odoo-bin -c odoo.conf -d <datenbank> -i ai_translation_consensus --stop-after-init

Odoo 19 və requests Python paketi tələb olunur. Alman dilinə tərcümə daxildir. website mövcuddursa, ai_translation_consensus_website inteqrasiya modulu da avtomatik quraşdırılır. Modulda Python kodu olduğuna görə quraşdırmadan sonra Odoo xidməti yenidən başladılmalıdır. Sistemdən real iş mühitində istifadə edənlər modulu əvvəlcə verilənlər bazasının surətində quraşdırmalıdır.

İlk addımlar: Süni intellektlə tərcümə → Provayderlər menyusunu açın, xidmətləri yoxlayıb aktivləşdirin, sonra Buradan başlayın bölməsində ilk qaydanı yaradın. Mətnləri axtar təklifləri yaradır, Bir paketi emal et isə provayderlərə sorğu göndərir. Bütöv veb-saytı növbəyə əlavə etməzdən əvvəl kiçik bir qayda ilə, məsələn, bir bloq yazısı və iki dillə başlayın, nəticəyə və xərclərə baxın.

Məhdudiyyətlər

• Keyfiyyət aktivləşdirdiyiniz modellərdən asılıdır. Qarşılıqlı yoxlama ayrı-ayrı modellərin səhvlərini azaldır, lakin zəmanət vermir. Hüquqi və ya təhlükəsizlik baxımından həssas mətnlərdə modul ana dili daşıyıcısını əvəz etmir.
• Xərclər sürətlə artır. Bir mətn üçün hər tərcüməçiyə bir sorğu, hər yoxlayıcıya bir yoxlama sorğusu göndərilir; səslər bölünərsə, ikinci mərhələ də keçirilir. Səhifə konteksti hər sorğunun giriş həcmini artırır. 45 hədəf dili olan qayda mətnlərin sayını dəfələrlə artırır. Hər axtarışda qeyd sayı, Hər axtarışda yeni təklif sayı və Hər Cron icrasında təklif sayı parametrləri ilə emal həcmini məhdudlaşdırın, yoxlayıcı kimi ucuz və ya lokal modellər də əlavə edin.
• Yalnız translate=True olan sahələr. Formatlanmış mətn bloklar üzrə emal olunur (Odoo-nun termin mexanizmi).
• Qiymətlər və model adları dəyişir. İlkin parametrlər mütəmadi yenilənən qiymət siyahısı deyil.
• Odoo 19.0 Community üçün hazırlanıb. Digər versiyalar dəstəklənmir.

Tez-tez verilən suallar

Razılığım olmadan nəsə tərcümə edilir və ya üzərinə yazılır?

Xeyr, Razılaşdırılmış nəticəni avtomatik qəbul et seçimini aktivləşdirmədiyiniz müddətdə belə bir hal baş vermir. Həmin seçim aktiv olduqda da yalnız razılaşma əldə edilmiş təkliflər yazılır. Quraşdırmadan sonra provayderlər və planlaşdırılmış əməliyyat deaktivdir.

Ödənişli provayderlər üçün açar lazımdır?

Yalnız açar tələb edən provayderlər üçün. Pollinations, MyMemory və ya lokal işləyən modellə (məsələn, Ollama) açarsız işləmək mümkündür. Pulsuz xidmətlər çox vaxt məhdud və yavaş olur; bütöv veb-sayt üçün onlar adətən yalnız əlavə vasitə kimi uyğundur.

Tərcümə neçəyə başa gəlir?

Bu, provayderdən, modeldən, mətnin uzunluğundan və dillərin sayından asılıdır, ona görə modul sabit rəqəmlər göstərmir. Qiymətləri daxil etdikdən sonra idarəetmə paneli istifadə həcmini və xərcləri göstərir, növbədəki mətnlərin qalan xərclərini isə təxmin edir.

Mətnləri məxfi saxlaya bilərəm?

Bəli, qaydanın Məxfi seçimi ilə. Bu halda yalnız sizin öz infrastrukturunuzda işlədiyi qeyd olunan provayderlər, məsələn, lokal Ollama istifadə olunur.

Bu, Odoo-nun öz tərcümə mexanizmini əvəz edir?

Xeyr. Modul Odoo-nun çoxdilli imkanlarından istifadə edir və adətən əl ilə redaktə etdiyiniz eyni tərcümələrə yazır.

Hansı lisenziya ilə təqdim olunur?

AGPL-3 lisenziyası ilə. Xətalar və təkmilləşdirmələr barədə bildirişlərin Issue kimi GitHub repozitoriyasında göndərilməsini alqışlayırıq.

Biricon IT Services dəstəyi

Kiçik və orta müəssisələrin Odoo sistemlərinə dəstək veririk: tətbiqdən tutmuş fərdiləşdirmə və miqrasiyalara, gündəlik istismara qədər. Odoo veb-saytınızı bir neçə dildə işlətmək, süni intellektlə tərcümələrin etibarlılığını artırmaq və ya modulu real iş mühitinizə təhlükəsiz şəkildə quraşdırmaq istəyirsinizsə, məmnuniyyətlə kömək edərik. Hazırladığımız digər həllər: Şirkətin portal istifadəçiləri ilə birlikdə arxivləşdirilməsi, Prefiks, il və sayğac əsasında sənəd nömrələri və Avstriyalı müştərilər üçün şirkətlər reyestri və ünvan yoxlaması.

İndi əlaqə saxlayın

Son yenilənmə: 3 noyabr 2026. Modul versiyası 19.0.1.0.0. Şəkillərdə uydurma nümunə məlumatlar göstərilir.