Google, içerikleri tercih ettiğiniz dile çevirmek için yapay zeka teknolojisini kullanır. Yapay zeka çevirilerinde hata olabilir.

Gemini Uygulamaları Geliştirici Modu'nda test etme, hata ayıklama ve değerlendirme

Bağlı uygulamanızı Google Connected Console'da incelemeye göndermeden önce Model Context Protocol (MCP) sunucunuzu etkileşimli olarak test etmek, şema veya çalışma zamanı hatalarını teşhis etmek ve araç kalitesini karşılaştırmak için Gemini Uygulamaları Geliştirici Modu'nu kullanın.

Bu kılavuzda aşağıdaki görevler ele alınmaktadır:

Gemini'da Gemini Uygulamaları Geliştirici Modu'nu etkinleştirin, özel bir MCP uygulaması oluşturun ve ilk araç keşfini doğrulayın.
Başarısız araç çağrılarında hata ayıklama, güncellenen şemaları senkronize etme ve kimlik doğrulamayı test etme
Kullanıcı ortamı bağlamını simüle edin ve istemci kimlik doğrulamasını yapılandırın.

Çalışma alanı düzeni ve denetleyici sekmelerine giriş için Gemini Uygulamaları Geliştirici Modu'na genel bakış başlıklı makaleyi inceleyin.

Gemini Uygulamaları Geliştirici Modu'nu etkinleştirme

MCP sunucunuzu Google Connected Console'a ekliyorsanız Gemini Uygulamaları Geliştirici Modu'nu etkinleştirdiğinizde kayıtlı uygulamanız zaten kullanılabilir durumda olur ve 2. adımı atlayabilirsiniz. Dağıtılan bir HTTPS MCP sunucusu uç noktasını konsola kaydetmeden önce doğrudan Gemini'da test etmek istiyorsanız Gemini Uygulamaları Geliştirici Modu'nu etkinleştirmek ve sunucunuzu özel bir MCP uygulaması olarak bağlamak için her iki adımı da uygulayın.

1. adım: Gemini Uygulamaları Geliştirici Modu'nu etkinleştirin

Web tarayıcınızda Gemini'ı açın.
Ayarlar > Gemini Uygulamaları Geliştirici Modu'nu tıklayın (veya doğrudan gemini.google.com/devmode adresine gidin).

(İsteğe bağlı) 2. adım: Özel bir MCP uygulaması oluşturup test edin

MCP sunucunuzu Gemini Uygulamaları Geliştirici Modu'nda özel uygulama olarak bağlamak için aşağıdaki adımları uygulayın:

Uygulama seçin iletişim kutusunda + Yeni oluştur'u tıklayın.
MCP sunucusuna bağlan iletişim kutusunda, MCP sunucusu URL'si alanına sunucunuzun herkese açık HTTPS uç noktasını girin (URL'nizin https:// ile başladığından emin olun, örneğin, https://your-app-link.com/mcp).
Sunucunuz önceden kayıtlı OAuth kimlik bilgileri gerektiriyorsa OAuth istemci kimliğinizi ve istemci gizli anahtarınızı girmek için Ek ayarlar > Daha fazla göster'i, ardından İleri'yi tıklayın.
Güvenlik ve gizlilik onay iletişim kutusunda, Gemini'ın özel MCP sunucunuzla nasıl etkileşim kurduğunu inceleyin:
- Araç yürütme: Gemini, isteklerinizi yerine getirmek üzere mevcut işlevleri başlatmak ve yürütmek için MCP sunucunuzun araçlarını çalıştırır.
- Veri alma ve paylaşma: Gemini, MCP sunucunuzun uç noktaları tarafından açığa çıkarılan kaynakları, şemaları ve bağlamı alır ve yönetir. Ayrıca, Google Hesabı ayarlarınıza göre veya diğer bağlı uygulamalarla etkileşimde bulunurken erişebildiği bilgileri paylaşabilir.
- Güven ve bağlantıyı kesme: Devam etmeden önce MCP sunucusuna güvendiğinizden emin olun ve gizlilik politikasını inceleyin. Sunucunun bağlantısını dilediğiniz zaman Bağlı Uygulamalar sayfanızdan kaldırabilir veya bağlantısını Google Hesabı bağlantılarınızdan silebilirsiniz.
Bu özel uygulamayı bağlamanın oluşturabileceği güvenlik ve gizlilik risklerini anlıyor ve kabul ediyorum'u seçin. Ardından Bağlan'ı tıklayın.
Save your custom app (Özel uygulamanızı kaydedin) iletişim kutusunda özel uygulamanız için bir görünen ad girin, sunucunuzun araçlarının Available actions (Kullanılabilir işlemler) listesinde göründüğünü doğrulayın ve Connect'i (Bağlan) tıklayın.
Gemini Uygulamaları Geliştirici Modu yan panelinde Araç şemaları sekmesini seçerek bağlı uygulamanızdaki her araçla ilgili bilgileri inceleyin. Bu bilgiler arasında parametre tanımları, güvenlik rozetleri (Salt okunur, Zararlı, Kimlik doğrulama gerekli), Ham şema ve Yanıt yapısı yer alır.
Sol sohbet panelinde doğal dilde veya @mention istemleri (ör. @MyApp show my profile) girin ve aracınızın nasıl çalıştığını görmek için Olay Günlüğü sekmesini izleyin.

Araç çağrılarında hata ayıklama

Bir araç çağrısı başarısız olduğunda veya beklenmeyen bağımsız değişkenler ürettiğinde, teşhis telemetrisini inceleyebilir, arka uç MCP sunucunuzu güncelleyebilir ve sohbet geçmişinizi temizlemeden şemayı çalışırken yeniden yükleyebilirsiniz.

Başarısız bir araç çağrısında hata ayıklamak için aşağıdakileri yapın:

Sağ bölmede Olay Günlüğü sekmesini seçin.
Telemetri listesinde başarısız olan etkinliği tıklayarak ayrıntılarını genişletin ve Tool call istek yükü ile Tool result yanıtı inceleyin:
- Bağlantı ve ağ hataları: Uç noktanıza erişilebildiğini doğrulamak için hata mesajlarını ve gecikmeyi kontrol edin.
- Kimlik doğrulama hataları: Etkinlik 401 veya 403 döndürürse Kimlik doğrulama sekmesinde OAuth jetonunuzun durumunu veya istemci kimlik bilgilerinizi doğrulayın.
- Şema doğrulama uyuşmazlıkları: Sunucu, MCP geçersiz parametre hatası (-32602) döndürürse Tool call içindeki model tarafından oluşturulan JSON bağımsız değişkenlerini, Araç Şemaları sekmesindeki parametre türleri, gerekli özellikler ve biçim talimatlarıyla karşılaştırın.
- Sunucu çalışma zamanı istisnaları: Arka uç istisnalarını teşhis etmek için Tool result içindeki JSON-RPC hata kodunu ve mesajını inceleyin.
Sorunu çözmek için MCP sunucusu uygulamanızı güncelleyin veya araç ve parametre açıklamalarınızı hassaslaştırın. Anlaşılır araç şemaları ve hata yanıtları yazma konusunda bilgi edinmek için MCP Bağlı Uygulama entegrasyon standartları başlıklı makaleyi inceleyin.
Araç Şemaları sekmesinde Şemayı senkronize et'i tıklayın. Gemini, mevcut sohbet dizisini korurken MCP sunucunuzdan tools/list öğesini yeniden getirir ve etkin araç tanımlarını günceller.
Sorgunuzu yeniden deneyin. Olay Günlüğü sekmesinde, yeniden oynatılan araç çağrısının 200 OK değerini döndürdüğünü ve sohbet önizlemesinde beklenen yanıtı oluşturduğunu onaylayın.

Ortam bağlamını ve kimlik doğrulamayı simüle etme

MCP araçlarınızın farklı kullanıcı konumlarına, saat dilimlerine, yerel ayarlara ve kimlik doğrulama yöntemlerine nasıl yanıt verdiğini doğrudan denetleyici panelinde test edebilirsiniz.

Ortam bağlamını geçersiz kılma

Tarihe, saate veya yerel ayara duyarlı araçlar için kullanıcı bağlamını simüle etmek üzere aşağıdakileri yapın:

Sağ bölmede Environment (Ortam) sekmesini seçin.
Tarih ve Saat bölümünde, göreli zaman ifadelerini (ör. "yarın sabah" veya "bu cumartesi öğleden sonra") test etmek için Simüle Edilen Tarih ve Simüle Edilen Saat'i seçin.
Tercihler bölümünde, kullanıcı yerel ayarını simüle etmek için bir Dil seçin (örneğin, en-US).
Simüle edilmiş bağlamla aracınızı değerlendirmek için sohbet panelinde bir test istemi çalıştırın.
Varsayılan ortam ayarlarını geri yüklemek için Sıfırla'yı tıklayın.

İstemci kimlik doğrulamasını yapılandırma

Gemini Uygulamaları Geliştirici Modu oturumunuzda kullanılan kimlik doğrulama yöntemini yapılandırmak veya değiştirmek için aşağıdakileri yapın:

Sağ bölmede Authentication (Kimlik doğrulama) sekmesini seçin.
Client Authentication Configuration (İstemci Kimlik Doğrulaması Yapılandırması) bölümünde aşağıdaki kimlik doğrulama modlarından birini seçin:
- Dynamic Client Registration: Kimlik bilgilerini yetkilendirme sunucunuzla otomatik olarak görüşmek için bir OAuth akışı kullanır. Daha fazla bilgi için OAuth 2.1 uygulama kılavuzunu inceleyin. Geçerliyse Özel uygulama bağlantısı ekleyin bölümüne uç noktanızı girin.
- Manuel İstemci Kaydı: Önceden kaydedilmiş bir istemci kimliğini ve istemci gizli anahtarını manuel olarak girmenize olanak tanır. Ek akış geçersiz kılma işlemlerini yapılandırmak için Gelişmiş Ayarlar'ı genişletin.
Kaydet'i tıklayın ve Kaydedildi mesajının görünmesini bekleyin. Ardından, kimliği doğrulanmış araçların başarılı olduğunu doğrulamak için bir test istemi çalıştırın.