Yapay Zeka Ajanı Becerilerini Kullanma (Antigravity CLI ve Firebase için Ajan Becerileri ile)

1. Giriş

Bu laboratuvarda, yapay zeka temsilcilerine özel bilgi ve iş akışlarına erişim sağlamak için Ajan Becerileri oluşturmayı öğreneceksiniz. Bu beceriyi, Antigravity CLI'dan erişilebilen yerel bir beceri olarak oluşturursunuz.

Yapacaklarınız

• En sevdiğiniz şeyler için kendi Agent Skills'inizi oluşturun.
• Becerinizi sorgulamak için Antigravity CLI'ı kullanın.
• Firebase için resmi Agent Skills'i yükleyin ve bunları kullanarak bir uygulama oluşturup dağıtın.

Neler öğreneceksiniz?

• Becerileri yapılandırma
• SKILL.md dosyası nasıl yazılır?
• Antigravity CLI ile yerel becerileri kullanma

2. Proje Ayarları

1. Henüz bir Google Hesabınız yoksa Google Hesabı oluşturmanız gerekir.
   • İş veya okul hesabı yerine kişisel hesap kullanıyorsanız. İş ve okul hesaplarında, bu laboratuvar için gereken API'leri etkinleştirmenizi engelleyen kısıtlamalar olabilir.
2. Google Cloud Console'da oturum açın.
3. Cloud Console'da faturalandırmayı etkinleştirin.
   • Bu laboratuvarı tamamlamak için 1 ABD dolarından daha az tutarda bulut kaynağı kullanmanız gerekir.
   • Daha fazla ücret alınmaması için bu laboratuvarın sonundaki adımları uygulayarak kaynakları silebilirsiniz.
   • Yeni kullanıcılar 300 ABD doları değerinde ücretsiz deneme sürümünden yararlanabilir.
4. Yeni bir proje oluşturun veya mevcut bir projeyi yeniden kullanmayı seçin.
   • Proje kotasıyla ilgili bir hata görürseniz yeni bir proje oluşturmak için mevcut bir projeyi yeniden kullanın veya mevcut bir projeyi silin.

3. Cloud Shell Düzenleyici'yi açma

1. Doğrudan Cloud Shell Düzenleyici'ye gitmek için bu bağlantıyı tıklayın.
2. Bugün herhangi bir noktada yetkilendirmeniz istenirse devam etmek için Yetkilendir'i tıklayın.
3. Terminal ekranın alt kısmında görünmüyorsa açın:
   • Görünüm'ü tıklayın.
   • Terminal'i tıklayın.
4. Terminalde şu komutla projenizi ayarlayın:
   • Biçim:

     gcloud config set project [PROJECT_ID]
     

   • Örnek:

     gcloud config set project lab-project-id-example
     

   • Proje kimliğinizi hatırlamıyorsanız:
     • Tüm proje kimliklerinizi şu komutla listeleyebilirsiniz:

       gcloud projects list | awk '/PROJECT_ID/{print $2}'
       

     
5. Şu mesajı görmeniz gerekir:

   Updated property [core/project].
   

   WARNING simgesini görüyorsanız ve Do you want to continue (Y/n)? sorusuyla karşılaşıyorsanız proje kimliğini yanlış girmiş olabilirsiniz. n ve Enter tuşlarına basıp gcloud config set project komutunu tekrar çalıştırmayı deneyin.

4. Özel becerinizi oluşturma

Aracı becerileri, bir yapay zeka aracısına talimat ve bilgi sağlayan en az bir SKILL.md dosyası içeren dizinlerdir. Bu bölümde, Antigravity CLI'ya en sevdiğiniz şeyler hakkında bilgi veren bir beceri oluşturacaksınız.

1. Bu laboratuvar için bir dizin oluşturun ve bu dizine gidin:

   mkdir ~/agent-skills-lab && cd ~/agent-skills-lab
   

2. Proje beceriniz için bir dizin oluşturun:

   mkdir -p ~/agent-skills-lab/.agents/skills/my-favorite-things
   

3. Beceri için yeni bir SKILL.md dosyası oluşturup açın:

   cloudshell edit ~/agent-skills-lab/.agents/skills/my-favorite-things/SKILL.md
   

   cloudshell edit komutu, SKILL.md dosyasını terminalin üstündeki düzenleyicide açar.
4. SKILL.md dosyasına aşağıdaki içeriği ekleyin:

   ---
   name: my-favorite-things
   description: Provides personal information about my favorite color, food, and programming language. Use this skill when the user asks questions about my personal preferences or favorite things.
   ---
   
   # Knowledge
   
   - **Favorite Color:** Blue
   - **Favorite Food:** Pizza
   - **Favorite Programming Language:** Python
   
   If asked about one of my favorite things, please respond with the information provided above.
   

Yalnızca bir SKILL.md dosyasıyla ilk becerinizi oluşturdunuz. Bu beceriyi Antigravity CLI'da kullanma zamanı geldi.

5. Antigravity CLI'deki becerinizi kullanma

Başarıyla beceri oluşturduğunuz için bu beceri, .agents/skills dizininde bulunduğundan Antigravity CLI tarafından zaten bulunabilir.

1. Antigravity CLI'yı başlatın:

   agy
   

Not: Antigravity CLI, Cloud Shell'e önceden yüklenmiştir.

1. Antigravity CLI ile kimlik doğrulama: İlk başlatma sırasında kimlik doğrulama gereklidir. OAuth'u seçin (Enter tuşuna basın).
2. Bağlantıyı tıklayın (tıklanamıyorsa Cloud Shell'deki URL'yi vurgulayarak kopyalayın ve tarayıcınıza yapıştırın).
3. Google Hesabınızda oturum açın
4. Kodu kopyala
5. Kodu Cloud Shell Editor terminaline yapıştırın.
6. Enter tuşuna basın.
7. Bazı varsayılan ayarları kabul etmek için Enter tuşuna basın.
8. Antigravity CLI'nin, bağlamında kullanabileceği becerileri listelemesini sağlama

   /skills
   

   Kullanılabilir beceriler listesinde my-favorite-things simgesini görmelisiniz.
9. Beceri görünümünden çıkmak için ESC tuşuna basın
10. Antigravity CLI'ya en sevdiğiniz renk hakkında soru sorun:

    What is my favorite color?
    

    Antigravity CLI, sorunuzu yanıtlamak için my-favorite-things becerisini kullanmalıdır. İstenirse Antigravity CLI'nın beceriyi kullanmasına izin verin.

Çıkışta, Antigravity CLI'nın becerinizi kullandığı ve "Mavi" veya "En sevdiğim renk mavi" gibi bir yanıt verdiği gösterilmelidir.

Başardınız! Başarıyla bir beceri oluşturdunuz ve Antigravity CLI kullanarak bu beceriyi test ettiniz.

Oturumunuzu sonlandırmaya hazır olduğunuzda /exit yazıp Enter tuşuna basarak Antigravity CLI'dan çıkın.

6. (İsteğe bağlı) Firebase Hosting'e uygulama oluşturma ve dağıtma

Kendi becerilerinizi oluşturmanın yanı sıra başkaları tarafından oluşturulan becerileri de yükleyebilirsiniz. Bu, kolayca paylaşılabilen ve yeniden kullanılabilen, bilgi, talimat ve iş akışlarından oluşan bağımsız modüller olan taşınabilir becerilerin kullanımını gösterir.

Firebase için Temsilci Becerileri, bu taşınabilir modüllere iyi bir örnektir. Bu işlevler, yapay zeka asistanlarının Firebase'deki en iyi uygulamaları anlamasına ve karmaşık görevleri daha yüksek doğrulukla ve daha düşük jeton maliyetiyle gerçekleştirmesine yardımcı olmak için tasarlanmıştır.

Artık kullanıcı kimlik doğrulaması ve veritabanı içeren bir "Yapılacaklar" web uygulaması oluşturmak ve bunu Firebase Hosting'e dağıtmak için Firebase için Agent Skills'i kullanabilirsiniz.

Projenizi oluşturma

1. Hâlâ Antigravity CLI'daysanız çıkmak için /exit yazın.
2. Projeniz için yeni bir dizin oluşturun ve bu dizine gidin:

   mkdir ~/todo-app && cd ~/todo-app
   

3. Google Hesabınızı kullanarak Firebase'e giriş yapın. Cloud Shell'de olduğunuz için --no-localhost işaretini kullanın:

   firebase login --no-localhost
   

   1. KSA istemleriyle etkileşim kurun:
      • Enable Gemini in Firebase features? sorulduğunda Y (Evet için) yazın ve Enter tuşuna basın.
      • Allow Firebase to collect CLI and Emulator Suite usage and error reporting information? sorulduğunda Y (Evet için) yazın ve Enter tuşuna basın.
   2. Tarayıcıda yetkilendirme:
      • Terminalde bir URL görürsünüz. Giriş sayfasını yeni bir tarayıcı sekmesinde açmak için bağlantıyı tıklayın (tıklanamıyorsa Cloud Shell'deki URL'yi kopyalamak için vurgulayın, ardından tarayıcınıza yapıştırın).
      • Adım 1/3 (Komutu onaylayın): Evet, bu komutu az önce çalıştırdım'ı tıklayın.
      • Adım 2/3 (Oturum kimliğini onaylayın): Oturum kimliğinin terminalinizde gösterilenle eşleştiğinden emin olun ve Evet, bu benim oturum kimliğim'i tıklayın.
      • 3/3. adım (Kodu kopyalayın): Yetkilendirme kodunu panonuza kopyalamak için Kopyala'yı tıklayın.
   3. Giriş işlemini tamamlayın:
      • Cloud Shell terminaline dönün ve ? Enter authorization code: istemine yetkilendirme kodunu yapıştırın.
      • Enter tuşuna basın.
   İşlemin başarılı olduğunu belirten bir mesaj görmeniz gerekir: ✔ Success! Logged in as .

İpucu: Yetkilendirme kodunu Cloud Shell'e yapıştırırken pano izinleri isteyen bir Chrome iletişim kutusu olup olmadığını kontrol edin ve bu iznin etkinleştirildiğinden emin olun. Kodu terminale yapıştırmak için Ctrl+Shift+V (Windows) veya CMD+Shift+V (Mac) tuşunu kullanabilirsiniz.

Firebase için Agent Skills'i yükleme

Proje dizininizi oluşturduğunuza göre, Firebase için Agent Skills'i bu dizine yüklemeniz gerekir.

Firebase için Agent Skills'i terminalinizdeki skills CLI ile yükleyebilirsiniz:

npx skills add firebase/agent-skills

Yükleme sırasında hangi becerilerin yükleneceğini seçmeniz istenir. Listede gezinmek için ok tuşlarınızı, bu becerileri seçmek için boşluk çubuğunu kullanın.

• firebase-auth-basics
• firebase-basics
• firebase-firestore
• firebase-hosting-basics
• firebase-security-rules-auditor

Sonraki istemlerde Enter tuşuna basarak varsayılanları güvenle kabul edebilirsiniz.

Bu komut, firebase-basics ve firebase-hosting-basics gibi becerileri indirip yükleyerek my-favorite-things becerinizin yanı sıra Antigravity CLI'da kullanılabilir hale getirir.

Firebase için Agent Skills hakkında daha fazla bilgi edinmek üzere kullanılabilir beceriler başlıklı makaleyi inceleyin.

Temel bir web uygulaması oluşturma ve dağıtma

1. Projeniz için gerekli API'leri etkinleştirin:

   gcloud services enable \
     cloudresourcemanager.googleapis.com \
     firebase.googleapis.com
   

2. Mevcut Google Cloud projenizde Firebase'i etkinleştirin:

   firebase projects:addfirebase ${GOOGLE_CLOUD_PROJECT}
   

3. Antigravity CLI'yı başlatın:

   agy
   

4. Antigravity CLI'dan temel bir index.html oluşturmasını isteyin:

   Generate an index.html file with the content "Hello Firebase Hosting" and
   deploy the application to Firebase Hosting using the current Google Cloud
   Project.
   

   Antigravity CLI, uygulamayı oluşturup dağıtırken izin isteyecektir. Bunu yapmasına izin vermek için Enter tuşuna basın. "Onayla" yazıp Enter tuşuna basmanız gerekebilir.Antigravity CLI, web sitenizi oluşturup dağıtmak için Firebase'e yönelik Agent Skills'i kullanmalıdır. Gerekirse onaylarla ilgili olarak temsilciye yol gösterin.

Dağıtım tamamlandığında web uygulamanızın URL'si sağlanır. Bağlantıları Cloud Shell Editor terminalinde açmak için ctrl+click (Windows/Linux) veya cmd+click (Mac) tuşunu kullanın. Dağıtılan uygulamanızın URL'sini ziyaret edin.

Firebase Authentication'ı ekleme

1. Henüz başlatılmadıysa Antigravity CLI'yı başlatın:

   agy
   

   Antigravity CLI, "Bu klasöre güveniyor musunuz?" gibi sorular sorabilir. Varsayılanları kabul etmek için Enter tuşuna basın.
2. Şimdi Antigravity CLI'dan Google ile oturum açma özelliğini eklemesini isteyin:

   Generate HTML, CSS, and Javascript for a single page application.
   It should use Google Sign-in with Firebase Authentication.
   A user should be able to sign in with their Google Account.
   Deploy when you are done and give the URL to me.
   

   Antigravity CLI, index.html, style.css ve script.js gibi dosyaların oluşturulmasını veya güncellenmesini isteyebilir. Buna izin verin. Antigravity CLI, Firebase konsolunda bazı işlemler yapmanızı isteyebilir. CLI, denemesini isterseniz bu işlemlerin çoğunu yapabilir ancak Cloud Shell örneğinizde Firebase CLI'ın eski bir sürümü yüklüyse adımları manuel olarak (ör. Google OAuth'u etkinleştirme) tamamlamanız gerekebilir.

Dağıtım tamamlandığında web uygulamanızın URL'si sağlanır. Bağlantıları Cloud Shell Editor terminalinde açmak için ctrl+click (Windows/Linux) veya cmd+click (Mac) tuşunu kullanın. Dağıtılan uygulamanızın URL'sini ziyaret edin.

En son değişikliklerinizin görünmesi için ctrl+shift+R (Windows/Linux) veya cmd+shift+R (Mac) ile "önbelleği kullanmadan yenileme" yapmanız gerekebilir.

Cloud Firestore ekleme

1. Henüz başlatılmadıysa Antigravity CLI'yı başlatın:

   agy
   

   Antigravity CLI, "Bu klasöre güveniyor musunuz?" gibi sorular sorabilir. Varsayılanları kabul etmek için Enter tuşuna basın.
2. Antigravity CLI'dan görevleri kaydetmek için Firestore'u eklemesini isteyin:

   Update the application to save tasks in Cloud Firestore for the signed-in user.
   A user should be able to add new tasks and see a list of their tasks.
   Deploy when you are done and give the URL to to me.
   

   Antigravity CLI, dosyaları güncelleyecektir. Buna izin verin.

Dağıtım tamamlandığında web uygulamanızın URL'si sağlanır. Bağlantıları Cloud Shell Editor terminalinde açmak için ctrl+click (Windows/Linux) veya cmd+click (Mac) tuşunu kullanın. Dağıtılan uygulamanızın URL'sini ziyaret edin.

En son değişikliklerinizin görünmesi için ctrl+shift+R (Windows/Linux) veya cmd+shift+R (Mac) ile "önbelleği kullanmadan yenileme" yapmanız gerekebilir.

Uygulamanız beklendiği gibi çalışmıyorsa beklediğiniz işlevselliği elde etmek için Antigravity CLI ile çalışmaya devam edin. Örnek: shell Hide the task form when the user is logged out. Update the security rules so the user can see their TODOs.

Yeni Firebase uygulamanızda görmek istediğiniz özellikleri eklemek için laboratuvarla denemeler yapmaya devam edin.

7. Sonuç

Tebrikler! Başarıyla bir beceri oluşturdunuz ve Antigravity CLI için ek becerileri nasıl yükleyeceğinizi öğrendiniz.

(İsteğe bağlı) Temizleme

Temizleme yapmak isterseniz ek ücret ödememek için Cloud projenizi silebilirsiniz.

İsterseniz projeyi silebilirsiniz:

gcloud projects delete $GOOGLE_CLOUD_PROJECT

Ayrıca, yer açmak için Cloud Shell diskinizdeki gereksiz kaynakları da silebilirsiniz.

1. Laboratuvar dizinini silin (bu işlem hem beceriyi hem de uygulamayı kaldırır):

   rm -rf ~/agent-skills-lab
   

2. "Yapılacaklar" uygulama dizinini silin (dışarıda oluşturduysanız):

   rm -rf ~/todo-app
   

Cloud Shell'inizi varsayılan durumuna sıfırlamanız gerekirse bunu güvenli bir şekilde nasıl yapacağınızla ilgili talimatlar için resmi belgelere göz atabilirsiniz.