Kuruluşunuz için Databricks uygulama şablonunu ayarlayan bir ChatGPT çalışma alanı yöneticisiyseniz bu kılavuzu kullanın. Şablon, üyelerin kullandığı nihai uygulama değildir. Gerekli Databricks yapılandırmasını sağladıktan sonra çalışma alanına özel bir taslak uygulama oluşturan bir kurulum akışıdır.
Databricks için kurulumun çoğu Databricks Account Console’da 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 şablon kurulum akışına yapıştırırsınız. ChatGPT taslak uygulamayı oluşturduktan sonra bunu yayımlayabilir ve diğer çalışma alanı uygulamaları gibi yönetebilirsiniz.
Neyi ayarlıyorsunuz
ChatGPT’de çalışma alanına özel bir Databricks uygulaması oluşturuyorsunuz. Uygulama şunları kullanır:
Databricks Account Console’unuzda oluşturulan bir Databricks OAuth uygulama bağlantısı.
Databricks OAuth istemci kimliği ve istemci gizli anahtarı.
ChatGPT’den kopyalanan tam geri çağırma URL’si.
Etkinleştirmek istediğiniz bağlayıcı özellikleriyle eşleşen Databricks kapsamları.
ChatGPT kurulum akışı tarafından istenen çalışma alanı ana makinesi, hesap ana makinesi, hesap kimliği veya warehouse gibi Databricks sağlayıcı ayrıntıları.
Başlamadan önce
Şunlara ihtiyacınız var:
ChatGPT çalışma alanı yöneticisi veya sahip erişimi.
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 Account Console’dan yapılandırılır.
Ayrı bir sekmede açık Databricks Account Console.
Tam geri çağırma URL’sini kopyalayabilmeniz için ChatGPT’de açık Databricks uygulama şablonu kurulum ekranı.
Uygulamanın genel Databricks API erişimine mi yoksa yalnızca Databricks SQL erişimine mi ihtiyaç duyduğuna dair karar.
Databricks istemci gizli anahtarını ele almak için güvenli bir yer.
Geri çağırma URL’sini kendiniz uydurmayın. ChatGPT’de gösterilen tam geri çağırma URL’sini kopyalayın.
Hazırlanacak değerler
Geri çağırma URL’si: bunu ChatGPT şablon kurulum akışından kopyalayın.
Databricks OAuth istemci kimliği.
Databricks OAuth istemci gizli anahtarı.
ALL APIs veya SQL gibi Databricks erişim kapsamları.
ChatGPT kurulum akışı tarafından istenen Databricks çalışma alanı veya hesap alanları.
Uygulamayı ChatGPT’de yayımlama ve yönetme
Taslak uygulamanın oluşturulması, onu otomatik olarak üyelerin kullanımına sunmaz. Taslağı inceledikten sonra:
Taslak uygulamayı yayımlayın.
Uygulamanın Çalışma alanı ayarları > Uygulamalar > Etkin bölümünde göründüğünü doğrulayın.
Uygulamayı kullanması gereken roller için Kullanıcı erişimini yapılandırın.
Uygulamanın sunduğu Databricks eylemleri için Eylem kontrolünü gözden geçirin.
ChatGPT’nin uygulamayı kullanmadan önce üyelere ne zaman soracağını seçmek için Uygulama izinlerini gözden geçirin.
İzin verilen bir test kullanıcısından ChatGPT’de Uygulamalar’ı açmasını ve uygulamanın göründüğünü doğrulamasını isteyin.
Bu uygulama izinleri ChatGPT konuşmaları için geçerlidir. Çalışma Alanı Otonom Ajanları, hangi uygulama eylemlerinin kullanılabilir olduğunu ve son kullanıcılardan bunları onaylamalarının ne zaman isteneceğini belirlemek için otonom ajanın oluşturucusu tarafından ayarlanan otonom ajan bazındaki kontrolleri kullanır. Otonom ajan davranışı için bkz.: Enterprise ve Business için ChatGPT Çalışma Alanı Otonom Ajanları.
Şablon kurulumunu ChatGPT’de başlatın
ChatGPT’de, uygulamanın kullanılabilir olması gereken çalışma alanına geçin.
Çalışma alanı ayarları > Uygulamalar’ı açın.
Dizin’i seçin.
Databricks’i arayın.
Databricks uygulama şablonunu seçin ve kurulumu başlatın.
Databricks veya Databricks - Veri Platformu gibi net bir uygulama adı ve açıklaması girin.
OAuth istemcisi bölümünde, geri çağırma URL’sini ChatGPT’den kopyalayın. Bu sekmeyi 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’te OAuth uygulama bağlantısını oluşturun
Databricks hesabınız için Databricks Account Console’u 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.
Yeniden yönlendirme URL’leri bölümüne ChatGPT’den kopyalanan tam geri çağırma URL’sini yapıştırın.
Erişim kapsamları altında uygulamanın ihtiyaç duyduğu kapsamları seçin.
SQL’in ötesinde Databricks API’lerine ihtiyaç duyan genel bir Databricks uygulaması için ALL APIs kullanın.
Databricks SQL API’leriyle sınırlı bir uygulama için yalnızca SQL kullanın.
Kuruluşunuzun belirli bir ilkesi yoksa token TTL’lerini Databricks varsayılanlarında bırakın.
İstemci gizli anahtarı oluştur’u 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 gizli anahtarını hemen kopyalayın ve güvenli şekilde saklayın.
Gizli anahtarı kopyalamadan iletişim kutusunu kapatırsanız OAuth uygulama kimlik bilgilerini oluşturun veya döndürün ve yeni gizli anahtarı kullanın.
Databricks gizli anahtarı yalnızca bir kez gösterir. Bunu bir kimlik bilgisi gibi ele alın ve ekran görüntülerine, taleplere, yorumlara veya sohbetlere eklemeyin.
Kurulumu ChatGPT’de tamamlayın
ChatGPT şablon kurulum sekmesine geri dönün.
Databricks İstemci Kimliğini OAuth istemci kimliğine yapıştırın.
Databricks İstemci gizli anahtarını OAuth istemci gizli anahtarına yapıştırın.
Şablon varsayılanlarını özellikle geçersiz kılmanız gerekmiyorsa Kapsamlar’ı değiştirmeyin.
Kurulum akışı tarafından istenen çalışma alanı ana makinesi, hesap ana makinesi, hesap kimliği, warehouse veya Databricks’e özgü diğer değerler gibi Databricks sağlayıcı alanlarını doldurun.
Taslak uygulamayı oluşturun.
Uygulamayı kullanıcı olarak test edin
İzin verilen bir test kullanıcısı olarak ChatGPT’den bağlantı akışını başlatın.
Tarayıcının beklenen Databricks hesabını veya çalışma alanını açtığını doğrulayın.
İstenen kapsamları onaylayın.
Tarayıcının ChatGPT’ye döndüğünü ve uygulamanın bağlı olarak göründüğünü doğrulayın.
Önce mevcut 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ş kullanıma sunmadan önce açıkça düşük riskli bir Databricks iş akışıyla test edin.
Erişimi yönetme
Databricks ve ChatGPT erişim denetimine birlikte katkıda bulunur.
ChatGPT’de çalışma alanı yöneticileri, yayımlanan uygulamanın kullanılabilir olup olmadığını, hangi çalışma alanı rollerinin bunu kullanabileceğini, hangi eylemlerin etkin olduğunu ve ChatGPT’nin uygulamayı kullanmadan önce kullanıcılara ne zaman soracağını yönetir.
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. Sağlayıcı izinleri, uygulama ChatGPT’de etkinleştirildikten sonra da geçerli olmaya devam eder.
Sorun giderme
Yeniden yönlendirme URI’si uyumsuzluğu: Databricks Yeniden Yönlendirme URL’sinin, yol ve geri çağırma kimliği dahil olmak üzere ChatGPT’de gösterilen geri çağırma URL’siyle tam olarak eşleştiğini doğrulayın.
Gizli anahtar eksik: Databricks gizli anahtarları tek seferlik görüntülenir. Kopyalanmadıysa yeni bir istemci gizli anahtarı oluşturun.
OAuth uygulaması hemen kullanılabilir değil: Databricks, OAuth uygulama güncellemelerinin işlenmesinin 30 dakikaya kadar sürebileceğini belirtir.
Yetersiz kapsam: ChatGPT kimlik doğrulaması yapabiliyor ancak Databricks API çağrıları başarısız oluyorsa, uygulamanın SQL dışı API’lere ihtiyaç duyduğu durumlarda Databricks uygulamasında ALL APIs olduğunu doğrulayın.
SQL eylemleri başarısız oluyor: SQL kapsamını, warehouse yapılandırmasını ve Databricks izinlerini doğrulayın.
Yanlış çalışma alanı: uygulamayı kullanıcıların bağlayacağı aynı ChatGPT çalışma alanında oluşturun ve yayımlayı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.