Gemini CLI için Agent Skills oluşturma

1. Giriş

Bu laboratuvarda, LLM'lere özel bilgi ve iş akışlarına erişim sağlamak için nasıl Agent Skills oluşturacağınızı öğreneceksiniz. Bu beceriyi, Gemini 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.
Beceri sorgulamak için Gemini CLI'ı kullanın.
Firebase için resmi Agent Skills'i yükleyin ve bunları kullanarak uygulama oluşturup dağıtın.

Neler öğreneceksiniz?

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

2. Proje Ayarları

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.
Google Cloud Console'da oturum açın.
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 ödememek 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.
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

Doğrudan Cloud Shell Düzenleyici'ye gitmek için bu bağlantıyı tıklayın.
Bugün herhangi bir noktada yetkilendirmeniz istenirse devam etmek için Yetkilendir'i tıklayın.
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.
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}'
```
Şu mesajı görmeniz gerekir:
```
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, Enter tuşuna basın ve gcloud config set project komutunu tekrar çalıştırmayı deneyin.

4. "En sevdiklerim" 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, Gemini CLI'ya en sevdiğiniz şeyler hakkında bilgi veren bir beceri oluşturacaksınız.

Beceri dosyanızı depolayacak bir dizin oluşturun:
```
mkdir -p ~/.gemini/skills/my-favorite-things
```
Beceri için yeni bir SKILL.md dosyası oluşturup açın:
```
cloudshell edit ~/.gemini/skills/my-favorite-things/SKILL.md
```
cloudshell edit komutu, SKILL.md dosyasını terminalin üstündeki düzenleyicide açar.

SKILL.md dosyasına aşağıdaki içeriği ekleyin:

---
name: my-favorite-things
description: Information about my favorite things. Use this skill to answer questions about my favorite color, food, or programming language.
---

My favorite color is blue.
My favorite food is pizza.
My favorite programming language is 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 Gemini CLI'da kullanmanın zamanı geldi.

5. Gemini CLI'daki becerinizi kullanma

Bir beceriyi başarıyla oluşturduğunuza göre artık Gemini CLI ile kullanabilirsiniz. ~/.gemini/skills içine yerleştirilen beceriler, Gemini KSA tarafından otomatik olarak keşfedilir.

Cloud Shell'de Gemini CLI'yi başlatma
```
gemini
```
Bazı varsayılan ayarları kabul etmek için Enter tuşuna basmanız gerekebilir.
Gemini'ın bağlamı dahilinde kullanabileceği becerileri listelemesini sağlama
```
/skills
```
Kullanılabilir beceriler listesinde my-favorite-things simgesini görmeniz gerekir.
Gemini'a en sevdiğiniz renk hakkında soru sorun:
```
What is my favorite color?
```
Gemini CLI, sorunuzu yanıtlamak için my-favorite-things becerisini kullanmalıdır. İstenirse Gemini KSA'nın beceriyi kullanmasına izin verin.

Çıkış, Gemini CLI'ın becerinizi kullandığını ve "Mavi" yanıtını verdiğini göstermelidir.

Başardınız! Gemini CLI'yi kullanarak bir beceri oluşturup test etmeyi başardınız.

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

6. Firebase için Agent Skills'i yükleyin

Kendi becerilerinizi oluşturmanın yanı sıra başkaları tarafından oluşturulan becerileri de yükleyebilirsiniz. Firebase için Agent Skills (GitHub), Firebase'e özgü bilgiler, talimatlar ve iş akışlarından oluşan taşınabilir ve bağımsız modüllerdir. 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.

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

npx skills add firebase/agent-skills

Bu komut, firebase-basics, firebase-auth-basics, firebase-firestore-basics ve firebase-app-hosting-basics gibi becerileri indirip yükleyerek my-favorite-things becerinizin yanı sıra Gemini CLI'da kullanılabilir hâle getirir.

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

7. Firebase için Temsilci Becerileri'ni keşfedin

Firebase için Temsilci Becerileri artık yüklendi ve Gemini CLI'da kullanıma hazır. Gemini CLI'yı çalıştırıp /skills firebase yazarak bunları görebilirsiniz:

gemini

Ardından Gemini CLI'da:

/skills firebase

firebase-basics, firebase-auth-basics, firebase-firestore-basics ve firebase-app-hosting-basics gibi yüklü Firebase becerilerinin listesini görürsünüz.

8. (İsteğe bağlı) Uygulama oluşturmak ve dağıtmak için Firebase'e yönelik Temsilci Becerileri'ni kullanın.

Şimdi, kullanıcı kimlik doğrulaması ve veritabanı içeren bir "Yapılacaklar" web uygulaması oluşturmak için yüklenen Firebase için Agent Skills'i kullanın ve uygulamayı Firebase App Hosting'e dağıtın.

Hâlâ Gemini CLI'daysanız çıkmak için /quit yazın.
Projeniz için yeni bir dizin oluşturun ve bu dizine gidin:
```
mkdir todo-app && cd todo-app
```
Google Hesabınızı kullanarak Firebase'e giriş yapın. Cloud Shell'de veya tarayıcısı olmayan başka bir ortamdaysanız --no-localhost işaretini kullanın.
```
firebase login --no-localhost
```
Firebase CLI'yı yetkilendirme talimatlarını uygulayın.
Gemini CLI'yı başlatın:
```
gemini
```

Şimdi Gemini'dan uygulama kodu oluşturmasını isteyin:

Generate HTML, CSS, and Javascript for a single page  application. It should use Google Sign-in with Firebase Authentication, and 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.

Gemini, index.html, style.css ve script.js gibi dosyalar oluşturmanızı isteyebilir. Buna izin verin.

Son olarak, uygulamayı Firebase App Hosting'e dağıtın:
```
/firebase-app-hosting-basics deploy my web app to Firebase App Hosting.
```
Uygulama barındırmayı yapılandırmak ve dağıtımı tamamlamak için talimatları uygulayın. Dağıtım tamamlandıktan sonra canlı uygulamanızın URL'sini alırsınız.

9. Sonuç

Tebrikler! Başarıyla bir beceri oluşturdunuz ve Gemini 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 gereksiz kaynakları cloudshell diskinizden de silebilirsiniz. Şunları yapabilirsiniz:

Beceri dizinini silin:

rm -rf ~/.gemini/skills/my-favorite-things

Uyarı! Bu işlem geri alınamaz. Yer açmak için Cloud Shell'inizdeki her şeyi silmek istiyorsanız tüm ana dizininizi silebilirsiniz. Saklamak istediğiniz her şeyin başka bir yere kaydedildiğinden emin olun.
```
sudo rm -rf $HOME
```