ChatGPT çalışma alanı yöneticisiyseniz veya kuruluşunuzun Databricks OAuth istemcisiyle Databricks Genie bağlayıcısını kuran bir ChatGPT Plus ya da ChatGPT Pro kullanıcısıysanız bu kılavuzu kullanın.
Databricks kurulumunun büyük bölümü Databricks Hesap Konsolu'nda yapılır. Özel bir OAuth uygulama bağlantısı oluşturur, ChatGPT geri çağırma URL'sini kaydeder, oluşturulan istemci kimlik bilgilerini kopyalar ve ardından bu değerleri ChatGPT bağlayıcı kurulum akışına girersiniz.
Kurulumun kapsamı
ChatGPT hesabınız veya çalışma alanınız için bir Databricks uygulama bağlantısı oluşturuyorsunuz. Bağlantı şunları kullanır:
Databricks Hesap Konsolu'nda oluşturulan bir Databricks OAuth uygulama bağlantısı.
Databricks OAuth istemci kimliği ve istemci gizli anahtarı.
ChatGPT'den kopyalanan geri çağırma URL'sinin aynısı.
Etkinleştirmek istediğiniz bağlayıcı özellikleriyle eşleşen Databricks kapsamları.
Çalışma alanı ana makinesi, hesap ana makinesi, hesap kimliği veya ambar gibi ChatGPT kurulum akışında istenen Databricks sağlayıcı bilgileri.
Başlamadan önce
Gerekenler:
ChatGPT çalışma alanı yöneticisi veya sahibi erişimi ya da bir ChatGPT Plus veya ChatGPT Pro hesabı.
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.
Ayrı bir sekmede açık olan Databricks Hesap Konsolu.
Geri çağırma URL'sini aynen kopyalayabilmeniz için ChatGPT'de açık olan Databricks Genie bağlantı ekranı.
Uygulamanın genel Databricks API erişimine mi, yoksa yalnızca Databricks SQL erişimine mi ihtiyaç duyduğuna ilişkin karar.
Databricks istemci gizli anahtarını güvenle kullanabileceğiniz bir yer.
Databricks hesabınız veya çalışma alanınız erişimi bir IP erişim listesi, bağlama dayalı giriş denetimi, güvenlik duvarı ya da başka bir ağ ilkesiyle kısıtlıyorsa güncel ChatGPT bağlayıcısı çıkış IP aralıklarına izin verebilecek bir Databricks yöneticisinin yardımı.
Not: ChatGPT'de gösterilen Geri çağırma URL'sini aynen kopyalamanız gerekir.
Hazırlanacak değerler
Geri çağırma URL'si: Bunu ChatGPT bağlayıcı kurulum akışından kopyalayın.
Databricks OAuth istemci kimliği.
Databricks OAuth istemci gizli anahtarı.
TÜM API'LER veya SQL gibi Databricks erişim kapsamları.
ChatGPT kurulum akışında istenen Databricks çalışma alanı veya hesap alanları.
Uygulama kurulumunu ChatGPT'de başlatma
ChatGPT'de uygulamanın kullanılacağı hesaba veya çalışma alanına geçin.
Çalışma alanı yöneticisi veya sahibi olarak Çalışma alanı ayarları > Eklentiler'e gidin.
Dizin bölümünde Databricks Genie'yi seçin.
Uygulama Bağlantısı Ekle'yi seçin.
Databricks Genie'yi Bağla iletişim kutusunda OAuth istemcisi bölümünü bulun.
ChatGPT'deki Geri çağırma URL'si. 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, sona eğik çizgi eklemeyin veya bunu genel bir ChatGPT URL'siyle değiştirmeyin. Databricks'e kaydedilen URL, ChatGPT'de gösterilen Geri çağırma URL'siyle tam olarak eşleşmelidir.
Databricks'te OAuth uygulama bağlantısını oluşturma
Databricks hesabınızın Databricks Hesap Konsolu'nu açın.
Sol kenar çubuğunda Ayarlar'ı açın.
Uygulama bağlantıları sekmesini açın.
Bağlantı ekle'yi seçin.
ChatGPT Databricks Bağlayıcısı gibi bir uygulama adı girin.
Yönlendirme URL'leri alanına ChatGPT'den kopyalanan geri çağırma URL'sini aynen yapıştırın.
Erişim kapsamları altında uygulamanın ihtiyaç duyduğu kapsamları seçin.
SQL dışındaki Databricks API'lerine ihtiyaç duyan genel bir Databricks uygulaması için TÜM API'LER'i kullanın.
Yalnızca Databricks SQL API'leriyle sınırlı bir uygulama için SQL'i kullanın.
Daha sonra ChatGPT'de listelenecek 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.
Kuruluşunuzun belirli bir ilkesi yoksa token geçerlilik sürelerini Databricks varsayılanlarında bırakın: erişim tokeni için 60 dakika, yenileme tokeni için 10080 dakika.
İstemci gizli anahtarı oluştur seçeneğini açın. Bu akış için ChatGPT'nin gizli bir OAuth istemcisine ihtiyacı vardır.
Bağlantıyı oluşturun.
Kimlik bilgilerini Databricks'ten kopyalama
Bağlantı oluşturuldu iletişim kutusunda İstemci Kimliği'ni kopyalayın.
İstemci gizli anahtarını hemen kopyalayıp güvenli bir yerde saklayın.
Gizli anahtarı kopyalamadan iletişim kutusunu kapatırsanız OAuth uygulaması kimlik bilgilerini oluşturun veya yenileyin ve yeni gizli anahtarı kullanın.
Databricks gizli anahtarı yalnızca bir kez gösterir. Bunu bir kimlik bilgisi gibi koruyun; ekran görüntülerine, destek kayıtlarına, yorumlara veya sohbetlere eklemeyin.
Kurulumu ChatGPT'de tamamlama
Databricks Genie'yi Bağla iletişim kutusuna dönün.
Databricks istemci kimliğini OAuth istemci kimliği alanına girin.
Databricks istemci gizli anahtarını OAuth istemci gizli anahtarı alanına girin.
Genel API erişimi için Kapsamlar (isteğe bağlı) alanında all-apis ve offline_access değerlerini koruyun.
Her satıra bir kapsam girin veya kapsamları virgülle ayırın. ChatGPT'de listelenen her kapsamın Databricks OAuth uygulamasında etkinleştirilmesi gerekir.
Çalışma alanı ana makine adını (gerekli) https:// veya URL yolu olmadan girin. Kurulum akışında gösterilen diğer gerekli Databricks sağlayıcı alanlarını doldurun.
Devam'ı seçin.
ChatGPT, yalnızca Kapsamlar (isteğe bağlı) alanına girilen kapsamları ister. Daha geniş şablon kapsamlarını otomatik olarak eklemez.
Bağlama ve test etme
Bağlayıcı ayrıntılarını, eylemleri ve kimlik doğrulama ayarlarını inceleyin.
Çalışma alanı yöneticisiyseniz bağlayıcıyı çalışma alanı için etkinleştirin ve çalışma alanı ilkesine göre kimlerin kullanabileceğini yapılandırın.
İzin verilen bir test kullanıcısı olarak ChatGPT'den bağlantı akışını başlatın, ardından Databricks'te oturum açın.
Tarayıcının beklenen Databricks hesabını veya çalışma alanını açtığını doğrulayın.
İstenen kapsamları inceleyin, ardından Yetkilendir'i seçin.
Tarayıcının ChatGPT'ye döndüğünü ve bağlayıcının bağlı göründüğünü doğrulayın.
Önce geçerli kullanıcı bilgilerini getirme veya onaylı bir Databricks SQL kaynağını sorgulama gibi düşük riskli bir okuma eylemi çalıştırın.
Yazma eylemleri etkinse daha geniş çaplı kullanıma sunmadan önce açıkça düşük riskli bir Databricks iş akışıyla test edin.
Çalışma alanı kurulumu için izin verilen, yönetici olmayan bir çalışma alanı üyesinden bağlanmasını ve düşük riskli testi tekrarlamasını isteyin.
Erişimi yönetme
Erişim denetimi hem Databricks hem de ChatGPT tarafından belirlenir.
ChatGPT'de çalışma alanı yöneticileri, uygulamanın kullanıma sunulup sunulmayacağını ve üyelerin uygulamayı nasıl kullanabileceğini yönetir. Şunlar için Databricks uygulama yönetimi denetimlerini (Çalışma alanı ayarları > Uygulamalar) inceleyin:
Bağlayıcıyı hangi çalışma alanı rollerinin kullanabileceğini yapılandırmak için Kullanıcı erişimi.
Hangi Databricks eylemlerinin etkinleştirileceğini yapılandırmak için Eylem denetimi.
ChatGPT'nin bağlayıcıyı kullanmadan önce üyelerden ne zaman onay isteyeceğini 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 bunları ne zaman onaylamalarının isteneceğini belirlemek için ajanın oluşturucusu tarafından ayarlanan ajan bazlı denetimleri kullanır. Ajan davranışı hakkında bilgi için bkz. Enterprise ve Business için ChatGPT Çalışma Alanı Ajanları.
Databricks'te yöneticiler, OAuth uygulamasını hangi kullanıcıları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çerliliğini korur.
Databricks bağlayıcı kurulumuyla ilgili sorunları giderme
Yönlendirme URI'si eşleşmiyor: Databricks Yönlendirme URL'leri değerinin, yol ve geri çağırma kimliği dâhil olmak üzere ChatGPT'de gösterilen Geri çağırma URL'siyle tam olarak eşleştiğini doğrulayın. Geri çağırma kimliğini kaldırmayın, sona eğik çizgi eklemeyin veya başka bir ChatGPT yönlendirme URL'si kullanmayın.
Gizli anahtar eksik: Databricks gizli anahtarları yalnızca bir kez gösterilir. Kopyalanmadıysa yeni bir istemci gizli anahtarı oluşturun.
OAuth uygulaması hemen kullanılamıyor: Databricks'e göre OAuth uygulaması güncellemelerinin işlenmesi 30 dakikaya kadar sürebilir.
Kapsam yetersiz veya eşleşmiyor: ChatGPT'deki Kapsamlar (isteğe bağlı) ile Databricks OAuth uygulamasındaki Erişim kapsamları'nı karşılaştırın. ChatGPT'nin istediği her kapsam burada etkinleştirilmelidir. SQL dışındaki API'ler için all-apis kapsamının Databricks'te etkin olduğunu ve ChatGPT kapsam listesinde kaldığını doğrulayın.
SQL eylemleri başarısız oluyor: SQL kapsamını, ambar yapılandırmasını ve Databricks izinlerini doğrulayın.
Yanlış ChatGPT çalışma alanı: Bağlayıcıyı, kullanıcıların bağlanacağı ChatGPT çalışma alanında oluşturup etkinleştirin.
Yanlış Databricks hesabı veya çalışma alanı: Çalışma alanı ana makine adı (gerekli) değerini doğrulayın, ardından oturum açma akışını tekrarlayıp Databricks'in beklenen hesabı veya çalışma alanını açtığından emin olun.
Kullanıcılar bağlanamıyor: Kullanıcının Databricks erişimi olduğunu ve OAuth uygulamasını yetkilendirmesine izin verildiğini doğrulayın. Ayrıca kullanıcının ChatGPT Kullanıcı erişimi ayarının bağlayıcıya izin verdiğini doğrulayın.
Databricks ağ ilkesi bağlayıcıyı engelliyor: Databricks yalnızca belirli kaynak IP'lere izin veriyorsa bir Databricks yöneticisi ilgili hesap veya çalışma alanı IP erişim listelerini, bağlama dayalı giriş denetimlerini, güvenlik duvarını ya da müşteri tarafından denetlenen diğer ağ kurallarını güncellemelidir.
Güncel ChatGPT bağlayıcısı çıkış IP aralıklarından gelen bağlantılara izin verin.
Bu izin listesini Databricks'te veya müşteri tarafından denetlenen ağ katmanında yapılandırın. Bu, ChatGPT çalışma alanı IP izin listesinden ayrıdır.
Yayımlanan aralıklar değişebilir. Mümkün olduğunda JSON'dan yapılan 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 bağlayıcının kaynak IP'lerini reddedip reddetmediğini doğrulayın.