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

1. Giriş

Bu laboratuvarda, yapay zeka ajanlarına ö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 Ajan Becerilerinizi oluşturun.
• Becerinizi sorgulamak için Antigravity CLI'ı kullanın.
• Firebase için resmi aracı becerilerini yükleyin ve bunları kullanarak bir uygulama oluşturup dağıtın.

Neler öğreneceksiniz?

• Becerileri yapılandırma
• SKILL.md dosyası yazma
• Antigravity CLI ile yerel becerileri kullanma

2. Proje Ayarları

1. Google Hesabınız yoksa Google Hesabı oluşturmanız gerekir.
   • İş veya okul hesabı yerine kişisel hesap kullanın. İş 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örürsünüz:

   Updated property [core/project].
   

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

4. Özel becerinizi oluşturma

Aracı becerileri, en az bir SKILL.md dosyası içeren dizinlerdir. Bu dosya, yapay zeka aracısına talimatlar ve bilgi sağlar. 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'daki becerinizi kullanma

Bir beceriyi başarıyla oluşturduğunuzda, .agents/skills dizininde bulunduğu için Antigravity CLI tarafından keşfedilebilir.

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

   agy
   

Not: Antigravity CLI, Cloud Shell'de önceden yüklü olarak gelir.

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ı dahilinde kullanabileceği becerileri listelemesini sağlama

   /skills
   

   Kullanılabilir beceriler listesinde my-favorite-things simgesini görmelisiniz.
9. Beceriler 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şturup Antigravity CLI kullanarak 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, kendi kendine yeten bilgi, talimat ve iş akışı modülleri olan taşınabilir becerilerin kullanımını gösterir.

Firebase için aracı becerileri, bu taşınabilir modüllere mükemmel bir örnektir. Bu işlevler, yapay zeka asistanlarının Firebase en iyi uygulamalarını anlamasına ve karmaşık görevleri daha yüksek doğrulukla ve daha düşük jeton maliyetiyle yürütmesine 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. Antigravity CLI'da kalmaya devam ediyorsanı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 vurgulayarak kopyalayın ve 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.
      • Adım 3/3 (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.
   Başarı mesajını görmeniz gerekir: ✔ Success! Logged in as .

İpucu: Yetkilendirme kodunu Cloud Shell'e yapıştırırken Chrome'un, pano izinleri isteyen bir iletişim kutusu gösterip göstermediğine dikkat edin ve bu izinlerin 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 aracı becerilerini yükleme

Proje dizininizi oluşturduktan sonra 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ılan değerleri 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 da kullanılabilir hale getirir.

Firebase için aracı becerileri hakkında daha fazla bilgi edinmek için 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şturmak ve dağıtmak için Firebase'e yönelik Agent Skills'i kullanmalıdır. Gerekirse onaylarla birlikte temsilciye yol gösterin.

Dağıtım tamamlandığında web uygulamanız için bir URL 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ı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 için bir URL 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 "sert 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ünceller. Buna izin verin.

Dağıtım tamamlandığında web uygulamanız için bir URL 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 "sert 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 istiyorsanız 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. Lab 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 yapmayla ilgili talimatlar için resmi belgelere göz atabilirsiniz.