ChatGPT çalışma alanı yöneticisiyseniz veya ChatGPT Plus ya da Pro kullanıcısı olarak Databricks Genie bağlayıcısını yerleşik OAuth ya da kuruluşunuzun OAuth istemcisiyle kuruyorsanı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 sırrı 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 istemcisinin kullanılmasını 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 erişim izinleri gerekir. Özel OAuth istemcisi kullanıyorsanız şunları da hazırlayın:
Databricks Hesap Konsolu'nda oluşturulmuş bir Databricks OAuth uygulama bağlantısı.
Databricks OAuth istemci kimliği ve istemci sırrı.
ChatGPT'den aynen kopyalanmış geri çağırma URL'si.
Etkinleştirmek istediğiniz bağlayıcı özelliklerine uygun 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
Gerekenler:
ChatGPT çalışma alanında yönetici veya sahip yetkisi ya da ChatGPT Plus veya Pro hesabı.
Özel OAuth istemcisi için Databricks hesap yöneticisi yetkisi. Bazı görevler için çalışma alanı yöneticisi yetkisi 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öneticisi, ChatGPT uygulamasının çalışma alanınızda kullanılabilir ve etkin olduğunu kontrol etmelidir.
Ö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 genel Databricks API erişimine mi yoksa yalnızca Databricks SQL erişimine mi ihtiyaç duyduğuna ilişkin karar.
Özel OAuth istemcisi için Databricks istemci sırrını yönetebileceğiniz güvenli bir yer.
Databricks hesabınız veya çalışma alanınız erişimi bir 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 bağlayıcısı çı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 bağlayıcısı kurulum akışından kopyalayın.
Özel OAuth istemcisi için Databricks OAuth istemci kimliği.
Özel OAuth istemcisi için Databricks OAuth istemci sırrı.
Özel OAuth istemcisi için uygulamanın özelliklerine uygun Databricks erişim kapsamları; örneğin TÜM API'ler veya SQL.
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.
Bir Databricks yöneticisinden, ChatGPT uygulamasının Hesap Konsolu'ndaki uygulama entegrasyonu ayarlarında mevcut olduğ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.
ChatGPT'de uygulamanın kullanılacağı hesaba veya çalışma alanına geçin. Kişisel kurulum için Ayarlar > Eklentiler bölümüne gidin. Çalışma alanı kurulumu için çalışma alanı yöneticisi veya sahibi olarak Çalışma alanı ayarları > Eklentiler bölümüne gidin.
Databricks Genie seçeneğini, ardından Uygulama bağlantısı ekle seçeneğini seçin.
Çalışma alanı ana bilgisayar adı (zorunlu) alanını
https://veya URL yolu olmadan girin.Devam et seçeneğini seçin, ardından Databricks'te oturum açıp onay isteğini gözden geçirin.
Aşağıdaki Bağlanın ve test edin ve Erişimi yönetin bölümleriyle devam edin. İzin 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ümlerini tamamlayın.
ChatGPT'de özel OAuth kurulumunu başlatın
ChatGPT'de uygulamanın kullanılacağı hesaba veya çalışma alanına geçin.
Kişisel kurulum için Ayarlar > Eklentiler bölümüne gidin. Çalışma alanı kurulumu için çalışma alanı yöneticisi veya sahibi olarak Çalışma alanı ayarları > Eklentiler bölümüne gidin.
Dizin bölümünde Databricks Genie seçeneğini seçin.
Uygulama bağlantısı ekle seçeneğini seçin.
Databricks Genie'yi bağla iletişim kutusunda OAuth istemcisi bölümünü bulun.
ChatGPT'den Geri çağırma URL'sini 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 URL'yi genel bir ChatGPT URL'siyle değiştirmeyin. Databricks'te kayıtlı URL, ChatGPT'de gösterilen Geri çağırma URL'siyle birebir eşleşmelidir.
Databricks'te özel OAuth uygulama bağlantısı oluşturun
Databricks hesabınızın Databricks Hesap Konsolu'nu açın.
Sol kenar çubuğunda Ayarlar bölümünü açın.
Uygulama bağlantıları sekmesini açın.
Bağlantı ekle seçeneğini seçin.
ChatGPT Databricks Bağlayıcısı gibi bir uygulama adı girin.
Yönlendirme URL'leri alanına ChatGPT'den kopyaladığınız 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 de ihtiyaç duyan genel amaçlı bir Databricks uygulaması için TÜM API'ler seçeneğini kullanın.
Databricks SQL API'leriyle sınırlı bir uygulama için yalnızca SQL seçeneğini 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 belirteç 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.
İstemci sırrı oluştur seçeneğini etkinleştirin. ChatGPT'nin bu akış için gizli bir OAuth istemcisine ihtiyacı vardır.
Bağlantıyı oluşturun.
Databricks'ten kimlik bilgilerini kopyalayın
Bağlantı oluşturuldu iletişim kutusunda İstemci kimliğini kopyalayın.
İstemci sırrını hemen kopyalayın ve güvenli bir yerde saklayın.
Sırrı kopyalamadan iletişim kutusunu kapatırsanız OAuth uygulaması kimlik bilgilerini oluşturun veya yenileyin ve yeni sırrı kullanın.
Databricks, sırrı yalnızca bir kez gösterir. Bunu bir kimlik bilgisi gibi koruyun; ekran görüntülerine, destek taleplerine, yorumlara veya sohbetlere eklemeyin.
ChatGPT'de özel OAuth kurulumunu tamamlayın
Databricks Genie'yi bağla iletişim kutusuna dönün.
Databricks istemci kimliğini OAuth istemci kimliği alanına girin.
Databricks istemci sırrını OAuth istemci sırrı alanına girin.
Kapsamlar (isteğe bağlı) alanına uygulamanızın Databricks uç noktası ve özellikleri için gereken kapsamları girin. Bunların Databricks OAuth uygulamasında etkinleştirilmiş kapsamlarla eşleşmesini sağlayın.
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.
Çalışma alanı ana bilgisayar adı (zorunlu) alanını https:// veya URL yolu olmadan girin. Kurulum akışında gösterilen diğer zorunlu Databricks sağlayıcı alanlarını doldurun.
Devam et seçeneğini seçin.
ChatGPT yalnızca Kapsamlar (isteğe bağlı) alanına girilen kapsamları talep eder. Daha geniş şablon kapsamlarını 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.
Bağlayıcı ayrıntılarını, eylemleri ve kimlik doğrulama ayarlarını gözden geçirin.
Çalışma alanı yöneticisiyseniz bağlayıcıyı çalışma alanı için etkinleştirin ve kimlerin kullanabileceğini çalışma alanı ilkesine göre 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ı gözden geçirin, ardından Yetkilendir seçeneğini seçin.
Tarayıcının ChatGPT'ye döndüğünü ve bağlayıcının bağlı olarak göründüğünü doğrulayın.
Önce mevcut kullanıcı bilgilerini getirmek veya onaylı bir Databricks SQL kaynağını sorgulamak gibi düşük riskli bir okuma eylemi çalıştırın.
Yazma eylemleri etkinse daha geniş kullanıma açmadan önce düşük riskli olduğu açıkça belli olan bir Databricks iş akışıyla test edin.
Çalışma alanı kurulumu için yönetici olmayan ve 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ıma açık olup olmadığını ve üyelerin uygulamayı nasıl kullanabileceğini yönetir. Business'ta yöneticiler, uygulamanın çalışma alanı genelinde etkin olup olmadığını yönetir. Şunlar için Databricks uygulamalarının yönetici denetimlerini (Çalışma alanı ayarları > Uygulamalar) gözden geçirin:
Desteklenen Enterprise ve Edu çalışma alanlarında hangi çalışma alanı rollerinin bağlayıcıyı 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 bağlayıcıyı kullanmadan önce ne zaman üyelerin onayını isteyeceğini yapılandırmak için Uygulama izinleri.
Bu uygulama izinleri ChatGPT sohbetleri 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 her ajan için ayrı ayrı belirlediği denetimleri kullanır. Ajan davranışı için bkz. Enterprise ve Business için ChatGPT Çalışma Alanı Ajanları.
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.
Plana özgü uygulama denetimleri için Uygulamalarda yönetici denetimleri, güvenlik ve uyumluluk makalesine bakın.
Databricks bağlayıcısı 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'siyle birebir eşleştiğini doğrulayın. Geri çağırma kimliğini kaldırmayın, URL'nin sonuna eğik çizgi eklemeyin veya başka bir ChatGPT yönlendirme URL'si kullanmayın.
Sır eksik: Özel OAuth istemcisi kullanıyorsanız Databricks sırlarının yalnızca bir kez gösterildiğini unutmayın. İstemci sırrını kopyalamadıysanız yeni bir tane oluşturun.
OAuth uygulaması hemen kullanılamıyor: Databricks, OAuth uygulaması güncellemelerinin işlenmesinin 30 dakikaya kadar sürebileceğini belirtiyor.
Yetersiz veya uyuşmayan kapsam: Özel OAuth istemcisi kullanıyorsanız ChatGPT'deki Kapsamlar (isteğe bağlı) alanını Databricks OAuth uygulamasındaki Erişim kapsamları ile karşılaştırın. ChatGPT'nin istediği her kapsam orada etkinleştirilmiş olmalıdır. Kapsamların kullandığınız uç noktayı ve özellikleri desteklediğini doğrulayın. İhtiyaca göre genel API erişimini veya yalnızca SQL erişimini de kontrol edin.
SQL eylemleri başarısız oluyor: SQL kapsamını, veri 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ğlantı kuracağı ChatGPT çalışma alanında oluşturup etkinleştirin.
Yanlış Databricks hesabı veya çalışma alanı: Çalışma alanı ana bilgisayar adı (zorunlu) 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ı yetkilendirmesine izin verildiğini 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 Kullanıcı erişimi ayarının da 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ının IP erişim listelerini, bağlama dayalı gelen trafik denetimlerini, güvenlik duvarını ya da müşterinin denetimindeki 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üşterinin denetimindeki 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ünse JSON'dan güncellemeleri otomatikleştirin.
Bir ağ engelini aşmak için istemci sırrı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.