Google AI Studio artık tam yığın geliştirmeyi destekleyerek istemci tarafı prototiplerin ötesine geçen uygulamalar oluşturmanıza olanak tanır. Sunucu tarafı çalışma zamanı sayesinde gizli anahtarları yönetebilir, harici API'lere bağlanabilir ve gerçek zamanlı çok oyunculu deneyimler oluşturabilirsiniz.
Sunucu tarafı çalışma zamanı
Google AI Studio uygulamaları artık sunucu tarafı bileşeni (Node.js) içerebilir. Böylece aşağıdakileri yapabilirsiniz:
- Sunucu tarafı mantığını yürütme: İstemciye gösterilmemesi gereken kodu çalıştırın.
- npm paketlerine erişme: Antigravity Agent, geniş npm ekosistemindeki paketleri yükleyip kullanabilir.
- Gizli anahtarları işleme: API anahtarlarını ve kimlik bilgilerini güvenli bir şekilde kullanın.
npm paketlerini kullanma
npm install aracını manuel olarak çalıştırmanız gerekmez. Temsilci'den paket gerektiren bir işlev eklemesini istemeniz yeterlidir. Temsilci, yükleme ve içe aktarma işlemlerini gerçekleştirir.
Örnek: > "Harici API'den veri almak için axios kullanın."
Gizli anahtarları güvenli bir şekilde yönetme
Sunucu tarafı kod ve gizli anahtar yönetimi sayesinde artık dünyayla etkileşim kuran uygulamalar geliştirebilirsiniz.
Gemini API anahtarı
Gemini API'yi kullanan yeni bir uygulama oluşturduğunuzda AI Studio, GEMINI_API_KEY anahtarınızı otomatik olarak sunucu tarafı gizli anahtarı olarak yapılandırır. Manuel kurulum gerekmez. Bu anahtarı Ayarlar'daki Gizli anahtarlar panelinde görüntüleyebilirsiniz. Uygulamanızın Gemini API çağrıları, bu anahtar kullanılarak sunucu tarafı kodundan yapıldığından tarayıcıda hiçbir zaman gösterilmez.
Üçüncü taraf API anahtarları
Diğer hizmetler için API anahtarlarını manuel olarak ekleyebilirsiniz:
- Üçüncü taraf API'leri: Stripe, SendGrid veya özel REST API'leri gibi hizmetlere bağlanma
- Veritabanları: Oturum sonrasında verileri saklamak için harici veritabanlarına (ör. Supabase, Firebase veya MongoDB Atlas aracılığıyla) bağlanın.
Gerçek hayatta kullanılan uygulamalar geliştirirken genellikle API anahtarları gerektiren üçüncü taraf hizmetlerine (ör. Twilio, Slack veya veritabanları) bağlanmanız gerekir. Anahtarları aşağıdaki adımları uygulayarak manuel olarak ekleyebilirsiniz:
- Gizli anahtar ekleme: Google AI Studio'da Ayarlar menüsüne gidip Gizli anahtarlar bölümünü bulun.
- Anahtarınızı saklama: API anahtarlarınızı veya gizli jetonlarınızı buraya ekleyin.
- Kodda erişim: Temsilci, bu gizli anahtarlara güvenli bir şekilde erişen (genellikle ortam değişkenleri aracılığıyla) sunucu tarafı kod yazabilir ve bunların istemci tarafı tarayıcıya hiçbir zaman gösterilmemesini sağlayabilir.
Gerektiğinde temsilci, sohbette yeni bir gizli anahtar gerektiğinde veya projenin ortam değişkenlerinde yeni bir anahtar algılandığında anahtar eklemenizi isteyen bir kart da gösterir.
Veritabanı ve kimlik doğrulama için Firebase entegrasyonu
Google AI Studio, Firebase entegrasyonu aracılığıyla uygulamanıza veritabanı veya kimlik doğrulama eklemeyi kolaylaştırıyor. Antigravity Agent, aşağıdaki hizmetleri sizin için otomatik olarak sağlayabilir ve ayarlayabilir:
- Firestore veritabanı: İstemci ve sunucu tarafı geliştirme için verileri depolayıp senkronize eden esnek, ölçeklenebilir bir NoSQL bulut veritabanıdır.
- Firebase Authentication: Kullanıcılarınızın "Google ile oturum aç" akışlarını kullanarak uygulamanızda güvenli bir şekilde oturum açmasına olanak tanır.
Temsilciden "uygulamama veritabanı eklemesini" veya "Google ile oturum açma özelliğini ayarlamasını" istemeniz yeterlidir. Gerekli yapılandırma ve kod oluşturma işlemlerini sizin için yapar. Android uygulamaları oluştururken Firebase entegrasyonu, istemci tarafında güvenli Gemini API çağrıları için Firebase AI Logic ve Firebase App Check'i de sağlar.
Firebase'i ücretsiz olarak kullanmaya başlayabilir ve daha fazla kota veya ücretli özellikleri kullanmaya hazır olduğunuzda ücretli bir hesaba geçebilirsiniz.
Google Workspace API'leri
Google AI Studio, Google Workspace API'lerine bağlanan uygulamalar geliştirmenize olanak tanır. Böylece kullanıcılarınız, uygulamanızda e-postalar, e-tablolar, dokümanlar, takvim etkinlikleri ve daha fazlası gibi gerçek verileriyle çalışabilir. Artık Google Cloud projesi oluşturmanız, OAuth'u yapılandırmanız veya API'nizi manuel olarak yönetmeniz gerekmez.
İşleyiş şekli
Workspace entegrasyonunu iki şekilde ekleyebilirsiniz:
- Sohbet panelinde açıklama: Alt kısımdaki sohbet panelinde temsilciye ne istediğinizi söylemeniz yeterlidir. Örneğin, "Makbuzları Google E-Tablolar'a kaydeden bir harcama takip aracı oluştur" veya "Okunmamış Gmail iletilerimi özetleyen bir kontrol paneli oluştur" diyebilirsiniz.
- Entegrasyonlar panelinden seçme: Build modunun sağ kenar çubuğundaki Entegrasyonlar panelini açın ve bağlamak istediğiniz Workspace uygulamasını etkinleştirin.
Bir Workspace uygulaması eklediğinizde AI Studio otomatik olarak:
- Uygulamanız için gerekli Google API'sini bağlar.
- API'yi çağırmak için sunucu tarafı kodunu oluşturur.
- Uygulamanızın son kullanıcılarının kendi verilerine erişim yetkisi verebilmesi için güvenli bir "Google ile oturum aç" akışı ekler.
Desteklenen uygulamalar
Aşağıdaki Google Workspace uygulamaları kullanılabilir:
| Uygulama | Neler oluşturabilirsiniz? |
|---|---|
| Google Takvim | Etkinlikleri ve takvimleri okuma, oluşturma ve yönetme |
| Google Chat | Görüşmeleri ve grup alanlarını okuma ve bunlarla etkileşim kurma |
| Google Dokümanlar | Doküman oluşturma, okuma, güncelleme ve biçimlendirme |
| Google Drive | Dosya ve klasörleri düzenleme, arama ve yönetme |
| Google Formlar | Anket oluşturma, soruları güncelleme ve yanıtları alma |
| Gmail | E-posta içeriğini okuma, gönderme ve yönetme |
| Google Keep | Notları, listeleri ve ekleri yönetme |
| Google Meet | Görüntülü görüşmeleri planlama ve yönetme |
| Kişiler | Kişileri senkronize etme ve yönetme |
| Google E-Tablolar | E-tablo verilerini okuma, yazma ve biçimlendirme |
| Google Slaytlar | Sunu oluşturma ve değiştirme |
| Google Görevler | Görev oluşturma, yönetme ve düzenleme |
Kimlik doğrulama ve izinler
Geliştirici olarak OAuth istemcilerini yapılandırmanız, kimlik bilgilerini yönetmeniz veya Google Cloud projesi oluşturmanız gerekmez. AI Studio tüm bu işlemleri sizin için gerçekleştirir.
Workspace API'lerinin entegre edildiği uygulamalar, son kullanıcıların kimliğini doğrulamak için "Google ile oturum açma" özelliğini kullanır. Kullanıcı uygulamanızı açtığında oturum açması ve uygulamanızın ihtiyaç duyduğu belirli izinleri (ör. takvimine salt okuma erişimi veya bir e-tabloyu düzenleme olanağı) vermesi istenir. Uygulamanız yalnızca uygulamayı kullanan kişinin verilerine erişir. Her kullanıcı kendi hesabına erişim yetkisi verir.
Örnek istemler
Workspace entegrasyonlarını kullanmaya başlamak için birkaç öneri:
- "Google Takvim'imi okuyan ve her toplantı için Gmail'de hazırlık e-postaları taslağı oluşturan bir uygulama geliştir."
- "Bir Google Dokümanı'nı alıp Google Slaytlar'da 5 slaytlık bir özet sunu oluşturan bir araç oluştur."
- "Yüklediğim makbuzlardaki bilgileri Gemini'ın ayıklayıp Google E-Tablolar'da yeni bir satıra kaydettiği bir harcama takip aracı oluştur."
OAuth'u ayarlama
Secret Manager'ın önemli kullanım alanlarından biri, diğer web sitelerine veya uygulamalara bağlanmak için OAuth'u ayarlamaktır. İsteminizde OAuth kimlik doğrulaması gerektiren bir üçüncü taraf uygulamasına bağlanmayla ilgili talimatlar varsa temsilci, söz konusu uygulama için OAuth'un nasıl ayarlanacağıyla ilgili talimatlar verir. Bu talimatlar, OAuth uygulamanızı yapılandırmak için gerekli geri çağırma URL'lerini içerir. Geri çağırma URL'lerini Ayarlar panelindeki Entegrasyonlar bölümünde de bulabilirsiniz.
Çok oyunculu deneyimler oluşturma
Tam yığın çalışma zamanı, gerçek zamanlı ortak çalışma özelliklerini etkinleştirir.
- Gerçek zamanlı durum: Temsilciden "canlı sohbet", "ortak çalışma beyaz tahtası" veya "çok oyunculu oyun" gibi özellikler oluşturmasını isteyebilirsiniz.
- Senkronize oturumlar: Sunucu, durumu yöneterek birden fazla kullanıcının aynı uygulama örneğiyle gerçek zamanlı olarak etkileşim kurmasına olanak tanır.
Örnek istem: > "Bunu, oyuncuların birbirlerinin imleçlerini görebileceği çok oyunculu bir oyun haline getir."
Çok oyunculu uygulamaları test etmeyle ilgili ipuçları
Uygulamanızı dağıtmadan önce çok oyunculu modu iki şekilde test edebilirsiniz.
- Uygulamanızı Google AI Studio'nun Build modunda birden fazla sekmede açın. Derleme modunda geliştirme yaparken uygulamanız bir geliştirme container'ında bulunur. Uygulamayı birden fazla sekmede açarak uygulamanızı kullanan birden fazla oyuncuyu simüle edebilirsiniz.
- Sağ üstteki Paylaş menüsünü kullanarak uygulamayı başkalarıyla paylaşın. Ardından, uygulamayı paylaştığınız oyuncularla birlikte kullanmak için Paylaş menüsünün Entegrasyonlar sekmesindeki Paylaşılan URL'yi kullanın.
En iyi uygulamalar
- Gemini API çağrıları:
GEMINI_API_KEY, otomatik olarak sunucu tarafı gizli anahtarı olarak yapılandırılır. Bu anahtarı kullanarak sunucu tarafı kodunuzdan Gemini API çağrıları yapın. Bu değeri Secrets (Gizli anahtarlar) panelinde görebilirsiniz. - Gizli anahtar güvenliği: Hassas anahtarlar için her zaman Secret Manager'ı kullanın. Bunları hiçbir zaman dosyalarınıza sabit kodlamayın.
- İşlevlerin ayrılması: Kullanıcı arayüzü mantığınızı istemci tarafı çerçevesinde (React/Angular) ve iş mantığınızı/veri işleme işlemlerinizi sunucu tarafında tutun.
- Hata yönetimi: Uygulamanın kilitlenmesini önlemek için sunucu tarafı kodunuzun harici API çağrılarından kaynaklanan hataları etkili bir şekilde yönettiğinden emin olun.