ChatGPT’de Databricks uygulama şablonunu ayarlama

Databricks Genie uygulamasını yerleşik OAuth veya kuruluşunuzun OAuth istemcisiyle kuran bir ChatGPT çalışma alanı yöneticisi ya da ChatGPT Plus veya Pro kullanıcısıysanız bu kılavuzu kullanın.

• Yerleşik OAuth: ChatGPT’de kullanılabiliyorsa ve Databricks çalışma alanınız için etkinleştirilmişse önceden yapılandırılmış bağlantıyı kullanın. OAuth uygulaması oluşturmanız veya istemci kimliği ya da istemci gizli anahtarı girmeniz gerekmez. Aşağıdaki Yerleşik OAuth bölümünü izleyin.

• Özel OAuth istemcisi: Yerleşik OAuth kullanılamıyorsa veya kuruluşunuz kendi OAuth istemcisini kullanmanızı gerektiriyorsa bu yöntemi kullanın. Aşağıdaki Özel OAuth istemcisi bölümünü izleyin.

Neyi kuruyorsunuz?

ChatGPT hesabınız veya çalışma alanınız için bir Databricks uygulama bağlantısı oluşturuyorsunuz. Her iki yöntem için de ChatGPT’de istenen Databricks sağlayıcı bilgileri ve kullanmayı planladığınız kaynaklara yönelik izinler gerekir. Özel OAuth istemcisi kullanıyorsanız şunları da hazırlayın:

• Databricks Hesap Konsolunuzda oluşturulmuş bir Databricks OAuth uygulama bağlantısı.

• Databricks OAuth istemci kimliği ve istemci gizli anahtarı.

• ChatGPT’den aynen kopyalanmış geri çağırma URL’si.

• Etkinleştirmek istediğiniz uygulama özellikleriyle eşleşen Databricks kapsamları.

• ChatGPT kurulum akışında istenen çalışma alanı ana bilgisayarı, hesap ana bilgisayarı, hesap kimliği veya veri ambarı gibi Databricks sağlayıcı bilgileri.

Başlamadan önce

Çalışma alanı kurulumu için yönetici konsolunu açın, ilgili ChatGPT çalışma alanını seçin ve Eklentiler’i açın. Kullanımda tutulan Uygulamalar sayfasını açmak için Eski Uygulamaları Yönet’i seçin. Çalışma alanında gezinme ve eski uygulamalara erişim hakkında bilgi için Eklentiler ve uygulamalar için yönetici denetimleri, güvenlik ve uyumluluk makalesine bakın.

Gerekenler:

• ChatGPT çalışma alanı yöneticisi veya sahibi erişimi ya da bir ChatGPT Plus veya Pro hesabı.

• Özel OAuth istemcisi için Databricks hesap yöneticisi erişimi. Bazı görevler için çalışma alanı yöneticisi erişimi yeterli olabilir ancak özel uygulama bağlantıları Databricks Hesap Konsolu’ndan yapılandırılır. Yerleşik OAuth için bir Databricks yöneticisinin ChatGPT uygulamasının çalışma alanınızda kullanılabilir ve etkin olduğunu kontrol etmesi gerekir.

• Özel OAuth istemcisi için ayrı bir sekmede açık olan Databricks Hesap Konsolu.

• Özel OAuth istemcisi için geri çağırma URL’sini aynen kopyalayabilmeniz amacıyla ChatGPT’de açık olan Databricks Genie bağlantı ekranı.

• Uygulamanın hangi özelliklere ihtiyaç duyduğuna ilişkin bir karar: Genie ve AI/BI panoları, daha geniş Databricks API erişimi veya Databricks SQL API’leriyle sınırlı bir uygulama. Yalnızca SQL erişimi, Genie veya pano eylemleri için yeterli değildir.

• Özel OAuth istemcisi için Databricks istemci gizli anahtarını yönetebileceğiniz güvenli bir yer.

• Databricks hesabınız veya çalışma alanınız erişimi IP erişim listesi, bağlama dayalı gelen trafik denetimi, güvenlik duvarı ya da başka bir ağ ilkesiyle kısıtlıyorsa güncel ChatGPT uygulaması çıkış IP aralıklarına izin verebilecek bir Databricks yöneticisinin yardımı.

Özel OAuth istemcisi için ChatGPT’de gösterilen Geri çağırma URL’sini aynen kopyalayın.

Hazırlanacak değerler

• Özel OAuth istemcisi için Geri çağırma URL’si: Bunu ChatGPT uygulama kurulum akışından kopyalayın.

• Özel OAuth istemcisi için Databricks OAuth istemci kimliği.

• Özel OAuth istemcisi için Databricks OAuth istemci gizli anahtarı.

• Özel OAuth istemcisi için uygulamanın özelliklerine uygun Databricks erişim kapsamları. ai-gateway, dashboards ve offline_access kapsamlarının gösterildiği yeni bir Genie/pano bağlantısında bu kapsamları hazırlayın. TÜM API’ler (all-apis ve offline_access birlikte), daha eski ve daha geniş kapsamlı alternatif olarak kullanılmaya devam ediyor. SQL kapsamını yalnızca Databricks SQL API’leriyle sınırlı bir uygulama için kullanın.

• ChatGPT kurulum akışında istenen Databricks çalışma alanı veya hesap alanları.

Yerleşik OAuth

Önce yukarıdaki ön koşulları yerine getirin. Bu yöntemi yalnızca yerleşik OAuth, ChatGPT’de kullanılabiliyorsa ve Databricks çalışma alanınız için etkinleştirilmişse kullanın.

1. Bir Databricks yöneticisinden, ChatGPT uygulamasının Hesap Konsolu’ndaki uygulama entegrasyonu ayarlarında bulunduğunu ve çalışma alanınız için etkinleştirildiğini kontrol etmesini isteyin. ChatGPT uygulaması Databricks Hesap Konsolu’nuzda listelenmiyorsa özelliğin hesabınız için kullanılabilir olup olmadığını öğrenmek üzere Databricks hesap temsilcinizle iletişime geçin.

2. ChatGPT’de, uygulamanın kullanılabilir olmasını istediğiniz hesaba veya çalışma alanına geçin. Kişisel kurulum için Ayarlar > Eklentiler bölümüne; çalışma alanı kurulumu için ise çalışma alanı yöneticisi veya sahibi olarak Yönetici konsolu > Eklentiler bölümüne gidin.

3. Databricks Genie seçeneğini, ardından Uygulama bağlantısı ekle seçeneğini seçin.

4. Çalışma alanı ana makine adı (zorunlu) alanına, https:// veya URL yolu içermeyen ana makine adını girin.

   ChatGPT, çalışma alanına özgü Genie MCP uç noktasını (https://<workspace-host>/ai-gateway/mcp-services/system.ai.genie_one_mcp) bu ana makine adından türetir. Ayrı bir bölgesel MCP uç noktası gerekmez.

5. Devam et seçeneğini seçin, ardından Databricks’te oturum açın ve izin talebini inceleyin.

Aşağıdaki Bağlanın ve test edin ve Erişimi yönetin bölümleriyle devam edin; izin verilen üyelerle yapılan testleri ve çalışma alanı erişim kontrollerini de tamamlayın.

Özel OAuth istemcisi

Önce yukarıdaki ön koşulları yerine getirin. Yerleşik OAuth kullanılamıyorsa veya kuruluşunuz kendi OAuth istemcisinin kullanılmasını gerektiriyorsa bu yöntemi kullanın. Kurulumdan sonra aşağıdaki Bağlanın ve test edin ve Erişimi yönetin bölümlerindeki adımları tamamlayın.

ChatGPT’de özel OAuth kurulumunu başlatın

1. ChatGPT’de, uygulamanın kullanılabilir olmasını istediğiniz hesaba veya çalışma alanına geçin.

2. Kişisel kurulum için Ayarlar > Eklentiler bölümüne; çalışma alanı kurulumu için ise çalışma alanı yöneticisi veya sahibi olarak Yönetici konsolu > Eklentiler bölümüne gidin.

3. Dizin bölümünde Databricks Genie seçeneğini seçin.

4. Uygulama bağlantısı ekle seçeneğini seçin.

5. Databricks Genie’yi bağla iletişim kutusunda OAuth istemci kimliği ve OAuth istemci gizli anahtarı alanlarını bulun. Görünen bu alanlara kimlik bilgilerini girmek, özel istemci kurulum akışını başlatır; ayrıca bir seçim yapmanız gerekmez.

6. ChatGPT’deki Geri çağırma URL’si değerini kopyalayın. Bu iletişim kutusunu açık tutun.

Örnek geri çağırma URL’si:

https://chatgpt.com/connector/oauth/<callback_id>

Geri çağırma kimliğini kaldırmayın, URL’nin sonuna eğik çizgi eklemeyin veya yerine genel bir ChatGPT URL’si kullanmayın. Databricks’te kayıtlı URL, ChatGPT’de gösterilen Geri çağırma URL’si ile tam olarak eşleşmelidir.

Databricks’te özel OAuth uygulama bağlantısı oluşturun

1. Databricks hesabınızın Databricks Hesap Konsolu’nu açın.

2. Sol kenar çubuğunda Ayarlar bölümünü açın.

3. Uygulama bağlantıları sekmesini açın.

4. Bağlantı ekle seçeneğini seçin.

   

5. ChatGPT Databricks gibi bir uygulama adı girin.

6. Yönlendirme URL’leri alanına, ChatGPT’den kopyaladığınız geri çağırma URL’sini aynen yapıştırın.

7. Erişim kapsamları altında uygulamanın ihtiyaç duyduğu kapsamları seçin.

8. ChatGPT’de ai-gateway, dashboards ve offline_access kapsamlarının gösterildiği yeni bir Genie/pano bağlantısında, Databricks OAuth uygulamasında da aynı kapsamlara izin verin.

9. TÜM API’ler, genel Databricks API erişimi için daha eski ve daha geniş kapsamlı alternatif olarak kullanılmaya devam ediyor. Bu yapılandırmada ChatGPT’de all-apis ve offline_access kapsamlarını kullanın ve Databricks OAuth uygulamasının her ikisine de izin verdiğinden emin olun. Yeni bir Genie/pano bağlantısında gösterilen ayrıntılı kapsamları tercih edin.

10. SQL kapsamını yalnızca Databricks SQL API’leriyle sınırlı bir uygulama için kullanın. Yalnızca SQL erişimi, Genie veya pano eylemleri için yeterli değildir.

11. Daha sonra ChatGPT’de listelenen her kapsamın bu Databricks OAuth uygulamasında etkinleştirildiğinden emin olun. Databricks, kullanıcı arayüzünde oluşturulan uygulamalar için openid, email, profile ve offline_access kapsamlarına otomatik olarak izin verir.

12. Kuruluşunuzun belirli bir ilkesi yoksa belirteçlerin yaşam sürelerini (TTL) Databricks varsayılanlarında bırakın: erişim belirteci için 60 dakika, yenileme belirteci için 10080 dakika.

13. İstemci gizli anahtarı oluştur seçeneğini açın. ChatGPT, bu akış için gizli bir OAuth istemcisine ihtiyaç duyar.

14. Bağlantıyı oluşturun.

Kimlik bilgilerini Databricks’ten kopyalayın

1. Bağlantı oluşturuldu iletişim kutusunda İstemci kimliğini kopyalayın.

2. İstemci gizli anahtarını hemen kopyalayın ve güvenli bir şekilde saklayın.

3. Gizli anahtarı kopyalamadan iletişim kutusunu kapatırsanız OAuth uygulamasının kimlik bilgilerini oluşturun veya yenileyin ve yeni gizli anahtarı kullanın.

Databricks, gizli anahtarı yalnızca bir kez gösterir. Bu anahtarı bir kimlik bilgisi olarak koruyun; ekran görüntülerine, destek taleplerine, yorumlara veya sohbetlere dahil etmeyin.

ChatGPT’de özel OAuth kurulumunu tamamlayın

1. Databricks Genie’yi bağla iletişim kutusuna dönün.

2. Databricks istemci kimliğini OAuth istemci kimliği alanına girin.

3. Databricks istemci gizli anahtarını OAuth istemci gizli anahtarı alanına girin.

   Bu kimlik bilgilerini girdiğinizde özel OAuth istemciniz kullanılır; ayrıca bir seçim yapmanız gerekmez.

4. Kapsamlar (isteğe bağlı) alanına, uygulamanızın Databricks uç noktası ve işlevleri için gereken kapsamları girin. Bunların Databricks OAuth uygulamasında etkinleştirilen kapsamlarla eşleşmesini sağlayın.

   Yeni bir Genie/pano bağlantısında ai-gateway, dashboards ve offline_access gösteriliyorsa bu kapsamları koruyun. Databricks OAuth uygulamasının aynı kapsamlara izin verdiğinden emin olun. ai-gateway çalışma alanına özgü Genie MCP bağlantısını, dashboards AI/BI pano eylemlerini, offline_access ise yenileme belirteçlerini etkinleştirir.

   Daha eski ve daha geniş kapsamlı alternatif olan all-apis ve offline_access, daha geniş API erişimi için desteklenmeye devam eder ancak bu Genie/pano bağlantısı için tercih edilmez. Databricks uygulaması yalnızca all-apis kapsamına izin veriyorsa uygulamayı ai-gateway, dashboards ve offline_access kapsamlarına izin verecek şekilde güncelleyin veya yeniden oluşturun. Ayrıntılı kapsamlar kullanılamıyorsa ChatGPT’yi bilinçli olarak all-apis ve offline_access kapsamlarını kullanacak şekilde ayarlayın ve Databricks uygulamasının her ikisine de izin verdiğinden emin olun. Databricks uygulaması yalnızca all-apis kapsamına izin veriyorsa ChatGPT’de bu üç ayrıntılı kapsamı talep etmeyin.

5. Her satıra bir kapsam girin veya kapsamları virgülle ayırın. ChatGPT’de listelenen her kapsam, Databricks OAuth uygulamasında etkinleştirilmiş olmalıdır.

6. Çalışma alanı ana makine adı (zorunlu) alanına, https:// veya URL yolu içermeyen ana makine adını girin. Kurulum akışında gösterilen diğer zorunlu Databricks sağlayıcı alanlarını da doldurun.

   ChatGPT, çalışma alanına özgü Genie MCP uç noktasını (https://<workspace-host>/ai-gateway/mcp-services/system.ai.genie_one_mcp) bu ana makine adından türetir. Ayrı bir bölgesel MCP uç noktası gerekmez.

7. Devam et seçeneğini seçin.

ChatGPT, yalnızca Kapsamlar (isteğe bağlı) alanına girilen kapsamları talep eder. Şablondaki daha geniş kapsamları otomatik olarak eklemez.

Bağlanın ve test edin

Hangi OAuth yöntemini kullanırsanız kullanın, aşağıdaki bağlantı testlerini ve erişim kontrollerini tamamlayın.

1. Uygulama ayrıntılarını, eylemleri ve kimlik doğrulama ayarlarını gözden geçirin.

2. Çalışma alanı yöneticisiyseniz uygulamayı çalışma alanı için etkinleştirin ve çalışma alanı ilkesine göre kimlerin kullanabileceğini yapılandırın.

3. İzin verilen bir test kullanıcısı olarak ChatGPT’den bağlantı akışını başlatın, ardından Databricks’te oturum açın.

4. Tarayıcının beklenen Databricks hesabını veya çalışma alanını açtığını doğrulayın.

5. İstenen kapsamları gözden geçirin, ardından Yetkilendir seçeneğini seçin.

   

6. Tarayıcının ChatGPT’ye döndüğünü ve uygulamanın bağlı olarak göründüğünü doğrulayın.

7. Bağlantının özelliklerine uygun, düşük riskli bir okuma eylemi çalıştırın. Genie bağlantısı için test kullanıcısının erişim izni olan verilerle ilgili bir Genie isteği gönderin. Desteklenen diğer özellikler için mevcut kullanıcının bilgilerini getirin veya onaylanmış bir Databricks SQL kaynağını sorgulayın. Kullanıcının gerekli Databricks kaynak izinlerine sahip olduğunu doğrulayın; OAuth kapsamları tek başına verilere erişim sağlamaz.

8. Yazma eylemleri etkinse daha geniş çapta kullanıma sunmadan önce düşük riskli olduğundan emin olduğunuz bir Databricks iş akışıyla test edin.

9. Çalışma alanı kurulumunda, yönetici olmayan ancak erişim izni bulunan bir çalışma alanı üyesinden bağlanmasını ve düşük riskli testi tekrarlamasını isteyin.

Erişimi yönetin

Erişim denetiminde hem Databricks hem de ChatGPT rol oynar.

ChatGPT’de çalışma alanı yöneticileri, uygulamanın kullanılabilirliğini ve üyelerin uygulamayı nasıl kullanabileceğini yönetir. Business’ta yöneticiler, uygulamanın çalışma alanı genelinde etkin olup olmayacağını yönetir. Aşağıdakiler için Databricks uygulamalarının yönetici denetimlerini (Çalışma alanı ayarları > Uygulamalar veya Yönetici Konsolu > Eklentiler > Eski Uygulamaları Yönet) gözden geçirin:

• Desteklenen Enterprise ve Edu çalışma alanlarında hangi çalışma alanı rollerinin uygulamayı kullanabileceğini yapılandırmak için Kullanıcı erişimi.

• Hangi Databricks eylemlerinin etkin olduğunu yapılandırmak için Eylem denetimi.

• ChatGPT’nin uygulamayı kullanmadan önce üyelere ne zaman soracağını yapılandırmak için Uygulama izinleri.

Bu uygulama izinleri ChatGPT konuşmaları için geçerlidir. Çalışma alanı ajanları, hangi uygulama eylemlerinin kullanılabileceğini ve son kullanıcılardan ne zaman onay isteneceğini belirlemek için ajanı oluşturan kişinin ajan bazında ayarladığı denetimleri kullanır. Ajan davranışı hakkında bilgi için Enterprise ve Business için ChatGPT çalışma alanı ajanları makalesine bakın.

Databricks’te yöneticiler, hangi kullanıcıların OAuth uygulamasını yetkilendirebileceğini ve bu kullanıcıların hangi Databricks kaynaklarına erişebileceğini yönetir. Uygulama ChatGPT’de etkinleştirildikten sonra da sağlayıcı izinleri geçerli olmaya devam eder.

Çalışma alanında gezinme, uygulama erişimi ve plana özel uygulama denetimleri hakkında bilgi için Uygulamalarda yönetici denetimleri, güvenlik ve uyumluluk makalesine bakın.

Databricks uygulamasının kurulum sorunlarını giderme

• Yönlendirme URI’si uyuşmazlığı: Özel OAuth istemcisi kullanıyorsanız Databricks’teki Yönlendirme URL’leri değerinin, yol ve geri çağırma kimliği dahil olmak üzere ChatGPT’de gösterilen Geri çağırma URL’si ile tam olarak eşleştiğini doğrulayın. Geri çağırma kimliğini kaldırmayın, sona eğik çizgi eklemeyin veya yerine başka bir ChatGPT yönlendirme URL’si kullanmayın.

• Gizli anahtar eksik: Özel OAuth istemcisi kullanıyorsanız Databricks gizli anahtarlarının yalnızca bir kez gösterildiğini unutmayın. Kopyalamadıysanız yeni bir istemci gizli anahtarı oluşturun.

• OAuth uygulaması hemen kullanılamıyor: Databricks, OAuth uygulaması güncellemelerinin işlenmesinin 30 dakikaya kadar sürebileceğini belirtiyor.

• Yetersiz veya eşleşmeyen kapsam: Özel OAuth istemcisi kullanıyorsanız ChatGPT’deki Kapsamlar (isteğe bağlı) ile Databricks OAuth uygulamasındaki Erişim kapsamları alanlarını karşılaştırın. ChatGPT’nin istediği her kapsam burada etkinleştirilmiş olmalıdır. Kapsamların kullandığınız uç noktayı ve özellikleri desteklediğini doğrulayın.

  ai-gateway, dashboards ve offline_access kapsamlarının gösterildiği yeni bir Genie/pano bağlantısında, bu kapsamları ChatGPT’de koruyun ve Databricks uygulamasının üçünün de kullanımına izin verdiğinden emin olun. Uygulama yalnızca all-apis kapsamına izin veriyorsa bu üç ayrıntılı kapsama izin verecek şekilde uygulamayı güncelleyin veya yeniden oluşturun.

  Ayrıntılı kapsamlar kullanılamıyorsa desteklenen daha geniş kapsamlı alternatifi kullanın: ChatGPT’de all-apis ve offline_access kapsamlarını ayarlayın ve Databricks uygulamasının her ikisine de izin verdiğinden emin olun. Yalnızca all-apis kapsamına izin veren bir uygulama, ChatGPT’nin ai-gateway, dashboards ve offline_access kapsamlarını isteyen talebiyle eşleşmez. Yalnızca SQL erişimi, sadece Databricks SQL API’leriyle sınırlı bir uygulama için uygundur; Genie veya pano eylemleri için yeterli değildir.

• SQL eylemleri başarısız oluyor: Databricks SQL API’leriyle sınırlı bir uygulama için SQL kapsamını, veri ambarı yapılandırmasını ve Databricks izinlerini doğrulayın.

• Yanlış ChatGPT çalışma alanı: Uygulamayı, kullanıcıların uygulamaya bağlanacağı ChatGPT çalışma alanında oluşturup etkinleştirin.

• Yanlış Databricks hesabı veya çalışma alanı: Çalışma alanı ana bilgisayar adı (gerekli) değerini doğrulayın, ardından oturum açma akışını tekrarlayın ve Databricks’in beklenen hesabı veya çalışma alanını açtığını doğrulayın.

• Kullanıcılar bağlanamıyor: Kullanıcının Databricks erişimi olduğunu ve OAuth uygulamasını yetkilendirme iznine sahip olduğunu doğrulayın. Business’ta uygulamanın çalışma alanı genelinde etkinleştirildiğini doğrulayın. Desteklenen Enterprise ve Edu çalışma alanlarında, ChatGPT’deki Kullanıcı erişimi ayarının da uygulamaya izin verdiğini doğrulayın.

• Databricks ağ ilkesi uygulamayı engelliyor: Databricks yalnızca belirli kaynak IP’lere izin veriyorsa bir Databricks yöneticisinin ilgili hesap veya çalışma alanının IP erişim listelerini, bağlama dayalı gelen trafik denetimlerini, güvenlik duvarını ya da müşterinin kontrolündeki diğer ağ kurallarını güncellemesi gerekir.

  • Güncel ChatGPT uygulaması çıkış IP aralıklarından gelen bağlantılara izin verin.

  • Bu izin listesini Databricks’te veya müşterinin kontrolündeki ağ katmanında yapılandırın. Bu liste, ChatGPT çalışma alanının IP izin listesinden ayrıdır.

  • Yayımlanan aralıklar değişebilir. Mümkün olduğunda JSON’dan güncellemeleri otomatikleştirin.

  • Bir ağ engelini aşmak için istemci gizli anahtarını yenilemeyin veya OAuth kapsamlarını değiştirmeyin. Önce Databricks’in uygulamanın kaynak IP’lerini reddedip reddetmediğini doğrulayın.

Kaynaklar

• Databricks belgeleri: Kullanıcıdan makineye OAuth ile kimlik doğrulama

• Databricks belgeleri: OAuth uygulama bağlantılarını yönetme

• Databricks belgeleri: IP erişim listelerini yönetme