Google AI Studio'da uygulama geliştirme

Bu sayfada, Google AI Studio'yu kullanarak Gemini'ın en yeni özelliklerini (ör. Nano Banana ve Live API) test eden uygulamaları hızlıca oluşturma (veya "vibe code") ve dağıtma açıklanmaktadır. Google AI Studio artık tam yığın çalışma zamanlarını destekliyor. Bu sayede, sunucu tarafı mantığı, güvenli sır yönetimi ve npm paketi desteği içeren sağlam uygulamaları doğal dil istemleriyle oluşturabilirsiniz.

Başlayın

Google AI Studio'nun Build mode'unda sezgisel kodlamaya başlayın. İnşa etmeye başlamanın birkaç yolu vardır:

  • İstemle başlayın: Oluşturma modunda, giriş kutusunu kullanarak oluşturmak istediğiniz öğenin açıklamasını girin. İsteminize görüntü üretme veya Google Haritalar verileri gibi belirli özellikler eklemek için Yapay Zeka Çipleri'ni seçin. Hatta sesle yazma düğmesini kullanarak ne istediğinizi söyleyebilirsiniz.
  • "Kendimi Şanslı Hissediyorum" düğmesi: Yaratıcı bir başlangıca ihtiyacınız varsa "Kendimi Şanslı Hissediyorum" düğmesini kullanın. Gemini, başlamanıza yardımcı olacak bir proje fikri içeren istem oluşturur.
  • Galerideki bir projeyi remiksleme: Uygulama Galerisi'nden bir proje açın ve Uygulamayı Kopyala'yı seçin.

İstemi çalıştırdıktan sonra gerekli kod ve dosyaların oluşturulduğunu görürsünüz. Uygulamanızın canlı önizlemesi sağ tarafta gösterilir.

Ne oluşturulur?

İsteminizi çalıştırdığınızda AI Studio, eksiksiz bir uygulama oluşturur. Varsayılan olarak, şunları içerebilen tam yığınlı bir ortam oluşturur:

  • İstemci tarafı: Bir web ön ucu (varsayılan olarak React kullanılır).
  • Sunucu tarafı: Güvenli API çağrılarına, veritabanı bağlantılarına ve npm paketi kullanımına olanak tanıyan bir Node.js çalışma zamanı.

Sağdaki önizleme bölmesinde Kod sekmesini seçerek oluşturulan kodu görüntüleyebilirsiniz. Antigravity Agent, yığınınızdaki birden fazla dosyayı akıllıca yöneterek değişikliklerin doğru şekilde yayılmasını sağlar.

The Antigravity Agent

Antigravity Agent, Google Antigravity'deki temel yapay zeka işlevidir. Artık aracının temel bileşenleri, Google AI Studio'daki Oluşturma modu deneyimine güç veriyor. Tüm projenizin bağlamını koruyarak, birden fazla dosyayı yöneterek ve karmaşık talimatları anlayarak basit kod oluşturmanın ötesine geçer. Böylece sağlam ve tam yığın uygulamalar oluşturabilirsiniz.

Temel özellikler:

  • Bağlam farkındalığı: Önceki istemlerin ve dosya durumlarının bağlamını korur.
  • Çoklu dosya yönetimi: Birden fazla dosyadaki bağımlılıkları yönetir.
  • Doğrulanmış yürütme: Halüsinasyonları azaltmak için kod güncellemelerini doğrular.

Yazılım çapında özellikler

Google AI Studio, modern web ekosisteminin gücünden yararlanmanızı sağlayarak yalnızca istemci tarafı prototipler oluşturmanıza olanak tanır.

  • Sunucu tarafı çalışma zamanı ve npm: npm paketlerinin geniş kitaplığından yararlanın. Aracı, uygulamanız için gereken paketleri (ör. veri görselleştirme veya API istemcileri için belirli kitaplıklar) otomatik olarak tanımlayıp yükler. İsterseniz belirli paketleri de isteyebilirsiniz.
  • Gizli anahtar yönetimi: API anahtarlarını ve gizli anahtarları Ayarlar menüsünde güvenli bir şekilde saklayın. Bunlara sunucu tarafı kodunuzdan erişilebilir ve istemci tarafı maruziyetten korunur.
  • Çok oyunculu: Doğrudan AI Studio'da gerçek zamanlı ortak çalışma deneyimleri oluşturun. Sunucu tarafı çalışma zamanı, kullanıcıların birlikte etkileşimde bulunması için gereken durumu ve bağlantıları yönetir.
  • Firebase entegrasyonu: Firestore veritabanı (kalıcı veri depolama) ve Firebase Authentication ("Google ile oturum açma" dahil olmak üzere oturum açma akışları) dahil olmak üzere Firebase'i otomatik olarak sağlama ve ayarlama. Aracı, tüm kurulum sürecini yönetir ve hatta bu hizmetler için uygulamanızdaki kodu yazar.

Tam yığın uygulamalar geliştirme hakkında daha fazla bilgi edinin.

Geliştirmeye devam etme

Google AI Studio, uygulamanız için ilk kodu oluşturduktan sonra kodu iyileştirmeye devam edebilirsiniz:

Google AI Studio'da geliştirme

  • Gemini ile yineleme yapma: Gemini'a değişiklik yapmasını, yeni özellikler eklemesini veya stili değiştirmesini istemek için Oluşturma modundaki sohbet panelini kullanın.
  • Kodu doğrudan düzenleme: Canlı düzenlemeler yapmak için önizleme panelinde Kod sekmesini açın.

Harici olarak geliştirme

Daha gelişmiş iş akışları için kodu dışa aktarabilir ve tercih ettiğiniz ortamda çalışabilirsiniz:

  • İndirin ve yerel olarak geliştirin: Oluşturulan kodu ZIP dosyası olarak dışa aktarın ve kod düzenleyicinize aktarın.
  • GitHub'a aktarma: Kodu bir GitHub deposuna aktararak mevcut geliştirme ve dağıtım süreçlerinize entegre edin.

Temel özellikler

Google AI Studio, geliştirme sürecini sezgisel ve görsel hale getirmek için çeşitli özellikler içerir:

  • Tam yığın uygulamalar oluşturma ve üzerinde yineleme yapma: Yalnızca bir istemle tam yığın uygulamalar oluşturun ve sohbet ya da not ekleme modu ile yineleme yapın. Not ekleme modu, uygulamanızın kullanıcı arayüzünün herhangi bir bölümünü vurgulamanıza ve istediğiniz değişikliği açıklamanıza olanak tanır.
  • Uygulamanızı paylaşma ve dağıtma: Oluşturduğunuz içerikleri başkalarıyla paylaşarak ortak çalışabilir veya çalışmalarınızı sergileyebilirsiniz. Uygulamanız hazır olduğunda Cloud Run'a dağıtın.
  • Uygulama galerisi: Uygulama Galerisi, proje fikirlerinin görsel kitaplığını sunar. Gemini ile neler yapabileceğinizi keşfedebilir, uygulamaların önizlemesini anında görebilir ve bunları kendi uygulamalarınıza dönüştürebilirsiniz.

Uygulamanızı dağıtma veya arşivleme

Uygulamanız hazır olduğunda dağıtabilirsiniz:

  • Google Cloud Run: Uygulamanızı ölçeklenebilir bir hizmet olarak dağıtın. Google Cloud Run fiyatlandırması, kullanıma bağlı olarak geçerli olabilir.
  • GitHub: Projenizi bir GitHub deposuna aktarın.

Sınırlamalar

Bu bölümde, Google AI Studio'daki derleme modunun mevcut sınırlamaları listelenmektedir.

API anahtarı güvenliği

  • İstemci tarafı: Gerçek API anahtarlarını istemci tarafı kodunda doğrudan kullanmayın.
  • Sunucu tarafı: Sunucu tarafı çalışma zamanında hassas anahtarları güvenli bir şekilde işlemek için Secrets Management özelliğini kullanın.

Google AI Studio dışında dağıtım

  • Uygulamanızı herkese açık bir URL için Cloud Run'a dağıtabilirsiniz ancak bu kurulumda tüm kullanıcıların Gemini API çağrıları için API anahtarınız kullanılır.
    • JavaScript uygulamaları istemci tarafında çalıştırılır. Bu nedenle, veri sızıntılarını veya kötüye kullanımı önlemek için API anahtarlarının yalnızca minimum erişime sahip olduğundan emin olun. Örneğin, aynı projede yer alan diğer Dosya Arama Mağazaları, bu mekanizma aracılığıyla kullanıcılara erişilebilir olabilir.
  • Güvenli harici dağıtım: Bir uygulamayı AI Studio dışında güvenli bir şekilde çalıştırmak için (ör. zip dosyasını indirdikten sonra) API anahtarını kullanan mantığı, anahtarın son kullanıcılara gösterilmesini önlemek amacıyla sunucu tarafı bir bileşene taşımanız gerekir. Cloud Run kullanarak dağıtım yapıyorsanız bu işlem gerekli değildir.
  • Anahtarın açığa çıkmasıyla ilgili uyarı: Yer tutucuyu istemci tarafı ortamında gerçek bir API anahtarıyla değiştirmeniz kesinlikle önerilmez. Aksi takdirde anahtar, tüm kullanıcılar tarafından görülebilir.

Uygulamalar paylaşılırken hata oluşuyor

Uygulamanızı paylaştığınızda son kullanıcınız paylaşılan URL'yi kullanırken 403 Erişim Kısıtlandı hatasıyla karşılaşıyorsa bunun nedeni aşağıdakilerden biri olabilir:

  • Tarayıcı uzantıları: Privacy Badger gibi gizlilik uzantıları uygulamayı engelliyor olabilir. Hatayı önlemek için uzantıyı devre dışı bırakın.
  • Derleme sorunları: Mevcut kodla ilgili sorunlar olabilir. Aracıya "Mevcut kodla ilgili derleme sorunlarını düzelt" istemini gönderin ve ardından URL'yi yeniden paylaşın.

SSS

AI Studio'da Geliştir özelliği nedir?

AI Studio Build, Gemini'ı kullanarak basit bir istemden üretime hazır, yapay zeka destekli bir uygulamaya geçmenizi sağlamak için tasarlanmış bir platformdur. İstediğiniz uygulamayı bir istemle açıklayın. Gemini sizin için bir uygulama oluşturur. Ayrıca, Gemini API ile neler yapılabileceğini görmek için galerimize göz atabilir ve uygulamaları remiksleyerek kendinize göre uyarlayabilirsiniz.

Build, neden istemci tarafı kodundan Gemini API'yi çağırıyor?

API anahtarınızı açığa çıkarmamak için normalde Gemini API'yi sunucu tarafından çağırmak en iyi uygulamadır. Ancak AI Studio, istemci tarafı çağrıları için bir Gemini API proxy'sine sahiptir. Bu proxy, API anahtarını kodda göstermeden ekler. Şimdilik, kodu basitleştirdiği ve API anahtarı sağlamak zorunda kalmadan uygulamanızı başkalarıyla paylaşmanıza olanak tanıdığı için bu proxy'den yararlanmak üzere istemci tarafında çağrılar oluşturuyoruz.

Uygulamaları paylaşırken API anahtarım açığa çıkar mı?

Uygulamanızda gerçek bir API anahtarı kullanmayın. Bunun yerine yer tutucu bir değer kullanın. process.env.GEMINI_API_KEY, kullanabileceğiniz bir yer tutucu değer olarak ayarlanır. Başka bir kullanıcı uygulamanızı kullandığında AI Studio, Gemini API'ye yapılan çağrıları proxy'ler ve yer tutucu değerini kullanıcının (sizin değil) API anahtarıyla değiştirir. Uygulamanızı görüntüleyebilen herkes kodu görebileceğinden uygulamanızda gerçek bir API anahtarı kullanmayın.

Uygulamalarımı kimler görebilir?

Uygulamanız varsayılan olarak özeldir. Uygulamanızı diğer kullanıcılarla paylaşarak kullanmalarını sağlayabilirsiniz. Uygulamanızı paylaştığınız kullanıcılar, uygulamanın kodunu görebilir ve kendi amaçları için kodu çatallayabilir. Uygulamanızı düzenleme izniyle paylaşırsanız diğer kullanıcılar uygulamanızın kodunu düzenleyebilir.

Uygulamaları Yapay Zeka Stüdyosu dışında çalıştırabilir miyim?

Uygulamanızı AI Studio'dan Cloud Run'a dağıtabilirsiniz. Bu işlem, uygulamanıza herkese açık bir URL verir. API anahtarınızı gizli tutacak bir proxy sunucusuyla birlikte dağıtılır. Ancak dağıtılan uygulama, tüm kullanıcıların Gemini API çağrıları için API anahtarınızı kullanır. Uygulamanızı zip dosyası olarak da indirebilirsiniz. Yer tutucu değeri gerçek bir API anahtarıyla değiştirirseniz yine çalışır. Ancak uygulamanızı bu şekilde dağıtmanız önerilmez. Çünkü bu durumda API anahtarı tüm kullanıcılar tarafından görülebilir. Bir uygulamanın AI Studio dışında güvenli bir şekilde çalışması için bazı mantıkların sunucu tarafına taşınması gerekir. Böylece API anahtarı artık kullanıma sunulmaz.

Uygulamaları kendi araçlarımla yerel olarak geliştirip burada paylaşabilir miyim?

Bu işlev henüz kullanılamıyor. Gelecekte uygulamalar için daha fazla kullanım alanını desteklemeyi heyecanla bekliyoruz. Aklınızda belirli bir şey varsa lütfen geri bildirimde bulunun.

Uygulamalarımda veritabanı veya başka bir depolama alanı nasıl kullanabilirim?

AI Studio uygulamaları, Cloud Run container'ında çalışan standart uygulamalardır. Dinamik IP aralığından erişimi engelleyen bir güvenlik duvarı olmadığı sürece, ağ üzerinden bağlanabileceğiniz herhangi bir depolama çözümünü kullanabilirsiniz.

Gelecekte depolama için doğrudan destek eklemek üzere çalışıyoruz. Bu desteği doğrudan AI Studio'da yapılandırabileceksiniz.

İzleyicilerin, bir uygulamanın web kamerasını veya diğer cihazlarını kullanımından haberdar olmasını sağlamak için uygulama bu Navigator API'lerine erişmeden önce ek bir onay vermelerini zorunlu tutarız. Uygulama geliştiriciler, bu izin isteklerini uygulamalarının metadata.json dosyasına ekleyebilir. Örneğin:

{
  "name": "My app",
  "requestFramePermissions": [
    "microphone",
    "camera",
    "display-capture",
    "geolocation",
    "bluetooth",
    "clipboard-read",
    "serial",
    "usb"
  ]
}

requestFramePermissions için desteklenen değerler, standart politika kontrollü özelliklerin bir alt kümesidir.

GitHub'ı uygulamalarımla nasıl kullanabilirim?

AI Studio'nun GitHub entegrasyonu, çalışmalarınız için bir depo oluşturmanıza ve en son değişikliklerinizi kaydetmenize olanak tanır. Uzak değişikliklerin çekilmesi şu anda desteklenmemektedir.

Diğer kullanıcılara uygulamamda düzenleme erişimi verebilir miyim?

Bu özellik henüz desteklenmemektedir ancak yakında desteklenecektir.

Uygulamam neden politika ihlali nedeniyle işaretlendi?

Uygulamaların politikalarımıza uygunluğunu sağlamak için otomatik olarak inceleyen sistemlerimiz vardır. Bir uygulamanın politikalarımızı ihlal ettiğini tespit edersek uygulama AI Studio'dan kaldırılır. Politika ihlalleri aşağıdakileri kapsar ancak bunlarla sınırlı değildir:

  • Kötü amaçlı yazılım, kimlik avı veya kimliğe bürünme içeren uygulamalar
  • Çocukların cinsel istismarı nitelikli görsel politikasını ihlal eden içerikler gösteren veya dağıtan uygulamalar
  • Taciz politikasını ihlal eden içerikler gösteren veya dağıtan uygulamalar
  • Nefret söylemi politikasını ihlal eden içerikler gösteren veya dağıtan uygulamalar
  • İnsan ticareti politikasını ihlal eden içerikleri gösteren veya dağıtan uygulamalar
  • Müstehcen içerik politikası'nı ihlal eden içerikleri gösteren veya dağıtan uygulamalar
  • Şiddet ve vahşet politikalarını ihlal eden içerikleri gösteren veya dağıtan uygulamalar
  • Zararlı veya tehlikeli içerik politikalarını ihlal eden içerik gösteren ya da dağıtan uygulamalar

Uygulamanız bir politika ihlali nedeniyle işaretlendiyse ve bunun hatalı olduğunu düşünüyorsanız itirazda bulunabilirsiniz. Politikalarımızın tekrarlı şekilde ihlal edilmesi, AI Studio'ya erişiminizin sonlandırılmasına neden olabilir.

Uygulama geliştirici olarak sorumluluklarım nelerdir?

Uygulamanızın sahibi olarak, uygulamanızın davranışından ve işlediği tüm verilerden sorumlu olduğunuzu hatırlatırız. Bunlardan bazıları:

  • Yasal Uygunluk ve Üçüncü Taraf Hakları: Uygulamanızın geçerli tüm yasalara ve düzenlemelere uygun olmasını ve fikri mülkiyet ile gizlilik hakları da dahil olmak üzere başkalarının haklarını ihlal etmemesini sağlama.
  • İçerik İzleme: Uygulamanızın kullandığı diğer hizmetler için ek şartlara uyulması gerekebilir. Örneğin, Firestore için geçerli olan Google Cloud Hizmet Şartları, üçüncü taraf içeriği barındıran müşterilerin hangi içeriğin yasaklandığını (ör. yasa dışı içerik) tanımlayan politikalar yayınlamasını ve bu yasa dışı içeriğin varlığını izlemesini zorunlu kılar.
  • Güvenli Uygulama: Uygulamanızın kötüye kullanılmasını önlemek için gerekli güvenlik önlemlerini ve moderasyon araçlarını uygulama.

Hizmet Şartları'ndaki kullanım kısıtlamalarına dikkat edin.

Aksi belirtilmediği sürece, AI Studio'daki uygulama galerisinde yer alan uygulamaların kullanımı Gemini API Ek Hizmet Şartları'na tabidir.

Sırada ne var?