Gemini API function calling ilə Blender iş axınının qurulması üzrə bələdçi

Bu bələdçidə nə öyrənəcəksiniz?

Gemini API function calling modelin sadəcə mətn yaratması əvəzinə, əvvəlcədən müəyyənləşdirilmiş funksiyalardan birini seçib həmin funksiyaya aid parametrləri qaytarmasına imkan verən üsuldur. Tətbiq bu çıxışı qəbul edib müvafiq xarici əməliyyatı yerinə yetirə bilər. Bu yanaşmadan xarici sistemlərdə əməliyyat aparmaq, xarici mənbələrdən məlumat almaq və ya hesablama kimi alətlərdən yararlanmaq üçün istifadə etmək mümkündür.

Blender-də isə Python skriptləri proqramın bir çox imkanını genişləndirə bilər. Blender-in rəsmi təlimatında obyekt yaratmaq, animasiya, render, idxal və ixrac, eləcə də təkrarlanan işləri avtomatlaşdırmaq nümunə istifadə sahələri kimi göstərilir. Məqsəd Gemini-nin Blender-i birbaşa idarə etdiyini fərz etmək deyil; iki sistem arasında hazırlanacaq tətbiqin iş axınının necə qurula biləcəyini anlamaqdır.

Tələblər və məhdudiyyətlər

Google-un Gemini API təlimatında function calling üçün funksiya adı, təsviri və parametrlərdən ibarət tərif istifadə olunur. Nümunələrdə Python müştərisi ilə genai kitabxanasından istifadə edilir; REST nümunəsində API sorğusu GEMINI_API_KEY adlı açarla göndərilir. Mənbə mətndə tələb olunan API hesabının şərtləri, qiymətlər və ya istifadə edilməli minimum proqram versiyası açıqlanmır. Buna görə tətbiqə başlamazdan əvvəl cari giriş şərtləri ayrıca yoxlanmalıdır.

Blender təlimatında Python skriptləri ilə işləmək üçün Text Editor və Python Console kimi sahələr göstərilir; istinad mənbəyi kimi Blender Python API sənədləri də tövsiyə olunur. Bununla belə, nəzərdən keçirilən sənədlərdə Gemini üçün hazır Blender əlavəsi, birbaşa bağlantı üsulu və ya konkret Blender versiyası ilə uyğunluq barədə məlumat yoxdur. Bu bələdçi hazır inteqrasiyanı izah etmir; hazırlanacaq prototip üçün yanaşma təklif edir.

İş axınını addım-addım qurmaq

1. Kiçik bir tapşırıq seçin. İlk sınaqda geniş təlimatı avtomatlaşdırmaq əvəzinə, əhatə dairəsi asanlıqla yoxlanıla bilən iş seçin. Məsələn, interyer səhnəsində seçilmiş obyektlərin adlarını hesabat şəklində vermək və ya sadə obyekt yaratmaq istəyini parametrlərə ayırmaq olar. Bunlar Blender-də hazır Gemini funksiyaları deyil; tətbiqdə hazırlanacaq nümunə ssenarilərdir.

2. Funksiyanın nə etdiyini aydın şəkildə müəyyənləşdirin. Gemini API-də funksiya tərifi ad, təsvir və parametr sxemindən ibarətdir. Parametrlər modelin sorğunu strukturlaşdırılmış şəkildə ötürməsinə imkan verir. Memarlıq səhnəsi ssenarisində tərtibatçı obyekt növü, ölçü və ya mövqe kimi sahələrin lazım olub-olmadığına qərar verə bilər. Bu sahələr mənbədə Blender üçün təqdim edilmiş hazır sxem deyil, layihəyə uyğun hazırlanmalı nümunə girişlərdir.

3. Təbii dildəki sorğunu parametrlərə çevirməyə çalışın. Aşağıdakı nümunə istifadəçi istəyinin necə məhdudlaşdırıla biləcəyini göstərir. Prompt özü-özlüyündə Blender-də əməliyyat aparmır; tətbiqdə uyğun funksiya tərifi və onu icra edəcək kod olmalıdır.

İnteryer səhnəsində jurnal masası yaratmaq istəyini qiymətləndir. Yalnız jurnal masasının növünü, enini, dərinliyini və hündürlüyünü bildirən sahələri strukturlaşdırılmış parametrlər kimi hazırla. Çatışmayan ölçüləri təxmin etmə; məlumat yoxdursa, bunu bildir.

Bu nümunənin məqsədi modelin qeyri-müəyyən ölçüləri uydurmasının qarşısını almaq və tələb olunan məlumatı məhdudlaşdırmaqdır. Tətbiqin funksiya tərifində hansı parametrlərin qəbul edildiyi əvvəlcədən göstərilməlidir.

1. Qaytarılan çağırışı tətbiq tərəfində yoxlayın. Google-un nümunələrində qarşılıqlı əlaqə addımları nəzərdən keçirilir; addım function_call olduqda funksiyanın adı və arqumentləri oxunur. Memarlıq avtomatlaşdırma prototipində də tətbiq gələn çağırışın müəyyən edilmiş funksiyalardan biri olub-olmadığını və arqumentlərin gözlənilən quruluşa uyğunluğunu yoxlamalıdır. Bu yoxlama yanlış və ya natamam girişlərin birbaşa səhnəyə tətbiqi riskini azaltmaq üçün dizayn tövsiyəsidir.

2. Blender skriptini ayrıca məsuliyyət kimi qurun. Gemini-nin verdiyi parametrlər Blender Python API-dən istifadə edən skriptə ötürülə bilər; lakin bu ötürmə və skriptin icrası hazırlanacaq tətbiqin məsuliyyətidir. Blender təlimatına görə xüsusi skriptlər birdəfəlik işlər üçün Text Editor vasitəsilə istifadə oluna bilər. API-dən istifadə etmək üçün rəsmi Blender Python API sənədlərinə müraciət etmək də tövsiyə olunur. Sadə prototipdə əvvəlcə parametrləri yoxlayıb, sonra skripti sınaq səhnəsində işə salmaq daha idarəolunan yanaşmadır.

3. Nəticəni yoxlayın və əhatə dairəsini məhdud saxlayın. Modelin seçdiyi funksiya adını və arqumentlərini qeyd edin, skriptin yaratdığı nəticəni isə ayrıca yoxlayın. İlk sınaqlarda bütün səhnəni dəyişən geniş səlahiyyətli əməliyyatlar əvəzinə, geri qaytarıla bilən və konkret məqsədli əməliyyatlar seçin. Bu, mənbələrdə təsvir olunan məcburi təhlükəsizlik xüsusiyyəti deyil; avtomatlaşdırma hazırlayarkən tətbiq oluna biləcək iş axını tədbiridir.

Memarlıq və vizuallaşdırma iş axınına təsiri

Bu yanaşma təkrarlanan səhnə hazırlığı addımlarını və ya təbii dildə verilən tapşırıqları strukturlaşdırılmış girişlərə çevirmək istəyən tərtibatçılar və vizuallaşdırma komandaları üçün faydalı ola bilər. Məsələn, komanda daxilində tez-tez təkrarlanan səhnə redaktəsi tələbi müəyyən edilmiş parametrlərə çevrilə, həmin parametrlərdən istifadə edən Blender skripti isə ayrıca hazırlana bilər. Burada function calling təbii dil ilə tətbiq funksiyası arasında interfeys rolunu oynayır; özü modelləşdirmə aləti deyil.

Mənbələrdə aparat tələbləri, lisenziya xərci və Blender versiyalarının uyğunluğu göstərilmir. Buna görə mövcud kompüterlərin kifayət edəcəyi, inteqrasiyanın konkret versiyada işləyəcəyi və ya əlavə ödəniş tələb olunmayacağı nəticəsinə gəlmək olmaz. Ofislər üçün əvvəlcə kiçik səhnədə prototip yaratmaq, API girişini, parametrlərin yoxlanmasını, skriptin davranışını və lisenziya şərtlərini ayrı-ayrılıqda nəzərdən keçirmək daha məqsədəuyğundur.

Tez-tez edilən səhvlər

• Function calling-i hazır əlavə hesab etmək: Model müəyyən edilmiş funksiya üçün çağırış və parametrlər yarada bilər; bu, Blender bağlantısının avtomatik qurulduğu demək deyil.

• Funksiya tərifini qeyri-müəyyən saxlamaq: Təsvir və parametrlər tətbiqin hansı girişləri qəbul edəcəyini dəqiqləşdirməlidir. Ölçü və ya mövqe kimi məlumatlar çatışmırsa, onları təxmin etmək əvəzinə qeyri-müəyyənliyi nəzərə alın.

• Modelin çıxışını yoxlamadan icra etmək: Qaytarılan funksiya adını və arqumentləri tətbiq tərəfində yoxlayın. Skripti əvvəlcə sınaq səhnəsində sınayın.

• Versiya və giriş şərtlərini fərz etmək: Mənbələr konkret Blender versiyası, API qiyməti və ya hesab şərti göstərmir. Layihəyə başlamazdan əvvəl cari sənədləri nəzərdən keçirin.

Növbəti addımlar

Əvvəlcə Blender-də müstəqil işləyən, əhatə dairəsi məhdud Python skripti hazırlayın və onun hansı girişləri gözlədiyini yazılı şəkildə müəyyənləşdirin. Sonra bu girişlərə uyğun funksiya tərifini Gemini API tərəfində yaradıb modelin çağırış və parametr çıxışını müşahidə edin. Son mərhələdə tətbiqin çağırışı yoxlayıb Blender skriptinə ötürdüyü prototipi sınayın. Kodlaşdırma üçün Blender Python API sənədlərini, Gemini tərəfində funksiya tərifi və çağırış axını üçün isə Gemini API function calling təlimatını əsas götürün.

Mənbə və lisenziya

Gemini API function calling təlimatı (Google, CC BY 4.0) və Blender Python skriptlərinə giriş təlimatı (Blender, CC BY-SA 4.0) əsas götürülərək Azərbaycan dilinə uyğunlaşdırılıb. Memarlıq ssenariləri və prompt nümunələri bu bələdçi üçün orijinal hazırlanıb.