Yapay zeka/BI Genie alanı ayarlama ve yönetme
Bu makalede, iş kullanıcılarının verileri hakkında doğal dil soruları sorması için bir sohbet arabirimi olan Genie alanını ayarlama ve yönetme açıklanmaktadır.
Teknik gereksinimler ve sınırlar
Genie alanları kullanılırken aşağıdaki gereksinimler ve sınırlar geçerlidir:
- Unity Kataloğu: Genie alanı verilerinin Unity Kataloğu'na kaydedilmesi gerekir.
- İşlem: Profesyonel veya sunucusuz bir SQL ambarı kullanmanız gerekir.
- Aktarım Hızı: Her çalışma alanı tüm Genie alanlarında dakikada en fazla 20 soru yanıtlayabilir.
- Kapasite: Her Genie alanı 10.000'e kadar konuşmayı destekleyebilir ve her konuşma en fazla 10.000 ileti içerebilir.
Gerekli izinler
Genie alanları oluşturmak, düzenlemek ve kullanmak için aşağıdaki izinler gereklidir:
- İşlem izinleri: Genie alan oluşturucuları, düzenleyicileri ve kullanıcıları alan için belirlenmiş varsayılan SQL ambarı için CAN USE erişimi gerektirir. Oluşturucular bir alan oluşturduklarında varsayılan SQL ambarını seçer. CAN RUN izinlerine sahip oldukları herhangi bir SQL ambarını seçebilirler.
- veri erişim izinlerini : Alanla etkileşim kuran tüm kullanıcılar, bir alanda kullanılan verilerde en az
SELECT
ayrıcalıklara ihtiyaç duyar. - Genie Alanı İzinleri: Kullanıcıların Genie ve alanda kullanılan verilerle etkileşim kurabilmesi için Genie Alanı'nda ÇALIŞTIRMA İzinlerine sahip olması gerekir. Genie uzayı için ayrıcalıkların ve yeteneklerin tam eşlemesi için Genie uzayı ACL'leri'ye bakın.
Not
Verileri ve işlem erişimini yapılandırmak için genellikle yöneticiyle sınırlı yükseltilmiş izinler gerekir. Bkz.
Genie erişimini yönet
Genie, hesap düzeyinde etkinleştirilmesi gereken Azure AI hizmetleri destekli yapay zeka yardımcı özelliklerini kullanır. Hesabınız için bu özellikleri yönetmeyi öğrenmek için 'ı ve Databricks Yardımcısı'nı etkinleştirme ve deneme'e bakın.
Not
Bu özelliğe erişimi yönetmek için hesap yöneticisi olmanız gerekir. Azure yapay zeka destekli özellikleri devre dışı bırakırsanız, SQL yetkilendirmesine sahip kullanıcılar kenar çubuğundaki Genie simgesine tıklamaya devam edebilir, ancak genie alanlarına erişemezler.
Yeni Genie alanı oluştur
Genie alanları, veri analistlerinin aşağıdaki adımları uygulayarak iş kullanıcıları için etki alanına özgü bir Genie alan deneyimi oluşturmasına olanak sağlar:
Kenar çubuğunda Genie
'yi tıklayın. Ekranın sağ üst köşesindeki Yeni'e tıklayın.
Yeni iletişim kutusunda başlangıç ayarlarını seçin. Seçenekler aşağıdaki gibi açıklanmıştır:
- Başlık: Başlık, çalışma alanı tarayıcısında diğer çalışma alanı nesneleriyle birlikte görünür. Son kullanıcıların Genie alanınızı bulmasına yardımcı olacak bir başlık seçin.
- Açıklama: Kullanıcılar Genie alanını açtıklarında açıklamayı görür. Boşlukların amacını açıklamak için bu metin alanını kullanın. Açıklama alanı, metninize stil ekleyebilmeniz ve yararlı bağlam ve başvurulara bağlantılar sağlayabilmeniz için Markdown biçimlendirmesini destekler. Markdown söz dizimi hakkında daha fazla bilgi için Bu Kılavuzu bkz..
- Varsayılan ambar: Bu hesaplama kaynağı, Genie alanlarında oluşturulan SQL sorgularını çalıştırır. Son kullanıcıların mekânla etkileşime geçmek için bu ambara erişmesi gerekir. Genie alanı profesyonel veya sunucusuz bir SQL ambarı kullanabilir. En iyi performans için Databricks sunucusuz SQL ambarı kullanılmasını önerir.
- Tablolar: Genie alanları bir veya daha fazla tabloyu temel alabilir. En fazla 25 tablo ekleyebilirsiniz. Tablo ekle düğmesi, eklemek istediğiniz Unity Kataloğu tablolarını seçebileceğiniz yeni bir iletişim kutusu açar.
- Örnek sorular: Örnek sorular isteğe bağlıdır. Kullanıcıların sorabileceği soru türlerinin örneklerini sağlamak için sohbetlerde görünürler. Bunlar oluşturma sırasında veya daha sonra alanın Ayarlar'ından eklenebilir.
Yönergeleri sağlayın
Yönergeler Genie'nin yanıtlarını yönlendirerek belirli bir etki alanındaki benzersiz jargon, mantık ve kavramları işlemesine yardımcı olur. Kapsamlı yönergeler, sorunsuz, sezgisel genie uzay deneyimi için kritik öneme sahiptir. Yönergeleri girmek için, Genie alanı yan çubuğundaki Yönergeler bölümünü açın. Bu bölmeyi, Genel yönergeler, Örnek SQL Sorgularıve SQL İşlevlerieklemek için kullanın.
Genie alanı için toplamda en fazla 100 yönerge ekleyebilirsiniz. Aşağıdakiler sayıya katkıda bulunur:
- Genel yönergeler tüm metin bloğu tek bir metin olarak sayılır.
- Her örnek SQL sorgusu tek bir sorgu olarak sayılır.
- Her SQL işlevi tek bir işlev olarak sayılır.
Genel yönergeler
Genie'nin izlemesi için iş veya yanıt tercihlerinizi aktaran düz metin yönergeleri sağlayın. Yönergeleri tek bir kapsamlı not olarak biçimlendirebilir veya daha iyi bir düzenleme için konuya göre kategorilere ayırabilirsiniz.
Aşağıda, genel yönergelere ekleyebilecek bir bilgi örneği gösterilmektedir:
-
Şirkete özgü iş bilgileri:
- "Mali yılımız Şubat'ta başlıyor"
-
Değerler, diğer adlar veya yaygın filtreler:
- "Her zaman küçük harfe dönüştürün ve filtre uygularken like işleci kullanın."
- "Filtre değerlerinde eyaletler için kısaltmalar kullanın."
-
Soruları yanıtlamak için işlevleri belirtin vedönüş değerlerine yönelik yönergeler sağlayın:
- Çeyrekler için
adventureworks.oneb.get_quarter(date)
UDF kullanın.get_quarter()
çıkışı üç aylık dönemdir ve 1,2,3 veya 4'tür. Verileri gerektiği gibi filtrelemek için bunu kullanın.
- Çeyrekler için
Örnek SQL sorguları
Örnek SQL sorguları, Genie'yi eğitmeye yardımcı olmak için hazırladığınız SQL sorgularıdır. Genie, sorulara yanıt verirken yanıtın oluşturulmasına yardımcı olmak için uygun sorguları akıllıca seçer. Örnek sorgular eklediğinizde Genie'ye sorularınızı yanıtlamak için verilerinizi nasıl kullanacağınızı gösterirsiniz. Genie'ye örnek sorgunun yanıtlanmasını beklediğiniz soru türleri hakkında bilgi vermek için örnek sorular da ekleyebilirsiniz. Genie eşleşen bir soru alırsa, bir yanıt sağlamak için doğrudan örnek sorguyu kullanabilir. Benzer bir soruyla karşılaşıyorsa, yanıtta sağlanan SQL'in yapılandırılmasına yardımcı olmak için örnek sorgudaki ipuçlarını kullanabilir. Aşağıdaki örnekte olduğu gibi kuruluşunuza ve verilerinize özgü mantığı vurgulayan örnekler sağlamaya odaklanın:
-- Return our current total open pipeline by region.
-- Opportunities are only considered pipelines if they are tagged as such.
SELECT
a.region__c AS `Region`,
sum(o.amount) AS `Open Pipeline`
FROM
sales.crm.opportunity o
JOIN sales.crm.accounts a ON o.accountid = a.id
WHERE
o.forecastcategory = 'Pipeline' AND
o.stagename NOT ILIKE '%closed%'
GROUP BY ALL;
SQL sorgularına parametre ekleme
Parametreler, çalışma zamanında değiştirilecek belirli değerlerin yer tutucularıyla örnek sorgular yazmanızı sağlar. Parametrelerle Genie, kullanıcı sorularından belirli girişleri alabilir ve güvenilir varlıklar olarak doğrulanmış yanıtlar sağlamak için örnek bir sorgunun yapısını yeniden kullanabilir. Örneğin, önceki SQL sorgusunu o.forecastcategory
değerine göre filtreleyen bir parametre içerecek şekilde ayarlayabilir ve sorgunun farklı tahmin kategorilerinde etiketlenen fırsatlar hakkındaki soruları ele almasını sağlayabilirsiniz. Güvenilir varlıklar olarak etiketlenmiş yanıtlar oluşturmak için parametreli sorguları kullanma hakkında daha fazla bilgi için bkz. AI/BI Genie alanlarında güvenilen varlıkları kullanma.
Aşağıdaki kod parçacığı, o.forecastcategory
değeri için bir parametre eklenerek değiştirilen önceki örneği gösterir. Parametreler, adlandırılmış parametre işaretçileriyle aynı söz dizimini kullanır. bkz. Adlandırılmış parametre işaretçileri.
-- Return our current pipeline at a stage by region.
-- Opportunities are only considered pipelines if they are tagged as such.
SELECT
a.region__c AS `Region`,
sum(o.amount) AS `Open Pipeline`
FROM
sales.crm.opportunity o
JOIN sales.crm.accounts a ON o.accountid = a.id
WHERE
o.forecastcategory = :forecast_category AND
o.stagename NOT ILIKE '%closed%'
GROUP BY ALL;
Sorguya parametre eklemek için:
İmlecinizi parametreyi sorgunuza yerleştirmek istediğiniz yere getirin.
Yeni bir parametre eklemek için Add parameter'e tıklayın.
Bu,
parameter
varsayılan adıyla yeni bir parametre oluşturur. Varsayılan adı değiştirmek için sorgu düzenleyicisinde değiştirin. Ayrıca düzenleyiciye iki nokta ve ardından bir parametre adı (:parameter_name
) yazarak da parametre ekleyebilirsiniz.
Sorgu parametresini düzenleme
Parametreyi düzenlemek için aşağıdakileri yapın:
Parametre adının yanındaki
tıklayın. Parametre ayrıntıları iletişim kutusu görüntülenir ve aşağıdaki yapılandırma seçeneklerini içerir:
Anahtar Sözcük: Sorgudaki parametreyi temsil eden anahtar sözcük. Anahtar sözcüğü yalnızca sorgudaki metin doğrudan güncelleştirilerek değiştirilebilir.
Görünen ad: Genie'nin sohbet deneyiminde kullandığı okunabilir ad. Genie parametreli bir sorgu kullanarak bir yanıt oluşturduğunda, yanıtta görüntü adı ve ilişkili değer yer alır.
Tür: Desteklenen türler arasında String, Date, Date and Timeve Numericbulunur.
- Varsayılan tür, dize
. - Sayısal veri türü, Ondalık ile Tamsayıarasında belirtmenize olanak tanır. Varsayılan sayısal tür ondalık.
Not
Gerçek giriş değeri seçilen parametre türüyle eşleşmiyorsa Genie, giriş değerini yanlış tür olarak değerlendirir ve bu da yanlış sonuçlara yol açabilir.
- Varsayılan tür, dize
İletişim kutusunu kapatmak için kullanıcı arabiriminin başka bir bölümüne tıklayın.
SQL işlevleri
SQL işlevleri Unity Kataloğu'nda depolanan ve Genie tarafından belirli soruları yanıtlamak için kullanılan özel işlevlerdir. Genie bu işlevleri çağırabilir ve kullanıcı tarafından belirtilen parametreleri ekleyebilir, ancak temel alınan SQL içeriğine erişemez. Bu, SQL işlevlerinin Genie'nin erişemeyeceği veya düzenleyemeyeceği karmaşık bağımsız değişkenler veya hesaplamalar içeren yaygın soruları yanıtlamak için ideal olduğu anlamına gelir. Unity Kataloğu'nda bir işlevi kaydetme hakkında yönergeler için bkz.
Genie alanınızı test edin
Kullanıcı etkileşimlerinin çoğu sohbet penceresinde gerçekleşir. Alanınızın istediğiniz gibi çalışıp çalışmadığını öğrenmenin en iyi yolu, işletme kullanıcılarınızın sormasını beklediğiniz gerçekçi sorularla test etmektir.
Ayarlara girdiğiniz tüm örnek sorular sohbet penceresinde görünür. Bu örnek sorular, kullanıcıların Genie alanına sorabilecekleri soruları anlamalarına yardımcı olur. Kullanıcıların soruları giriş yaptığı metin alanı ekranın alt kısmına yakındır.
Yanıtlar metin alanının üzerinde görünür. Kullanıcı bir soru girdikten sonra, sol bölmedeki bir sohbet geçmişi yazışmasına kaydedilir.
Yeni bir sohbet başlatmak için:
-
sohbet simgesine tıklayarak sohbet penceresini açın.
- Sorunuzu Sorunuzu sorun... metin girişi alanına yazın. Yeni bir konuşma yazışması başlatmak için + Yeni sohbetöğesine tıklayın.
Yanıtları gözden geçirme
Yanıtlar genellikle sorulara doğal bir dil yanıtı ve ilgili sonuç kümesini gösteren bir tablo olarak teslim edilir. Genie bir görselleştirmenin yanıt netliğini artırabileceğini algıladığında bir görselleştirme de döndürür. Kesin yanıt yapısı, soruya göre değişir. Tüm yanıtlar, soruyu yanıtlamak için oluşturulan SQL sorgusunu içerir. Oluşturulan sorguyu görüntülemek için oluşturulan kodu göster'e tıklayın.
Not
Genie, diğer büyük dil modelleri (LLM'ler) gibi belirlenimci olmayan davranışlar sergileyebilir. Bu, aynı istemi birden çok kez gönderirken zaman zaman farklı çıkışlar alabileceğiniz anlamına gelir. Genie'nin öğrenebileceği örnek SQL sorguları sağlamak Genie'nin daha tutarlı olmasını sağlayabilir. bkz. Örnek SQL sorguları.
Yanıtın sağ alt tarafında isteğe bağlı eylemler bulunur. Kullanıcılar yanıt CSV'sini panonuza kopyalayabilir, CSV dosyası olarak indirebilir, Genie alanı için bir yönerge olarak ekleyebilir ve yanıtı destek oyuyla veya aşağı oylayabilir. Görselleştirmeyi düzenlemek için görselleştirmenin sağ üst köşesindeki düzenle simgesine tıklayın. Ek talimatlar için bkz. Görselleştirmeleri düzenleme.
Bir dizi Hızlı eylem kutucukları, tablo verileri içeren yanıtların ardından gelir. Görselleştirmeler oluşturmak için bunları kullanabilirsiniz.
Ayrıca bir sorgu sonucu aldıktan sonra görselleştirmeyi sözcüklerle açıklayarak da oluşturabilirsiniz. Bkz. Görselleştirmeleri oluştur.
Sonuçları biçimlendirme
Yanıt içindeki bir tablodaki sütunu biçimlendirmek için, sütun üst bilgisindeki kebap menüsüne tıklayın ve ardından Biçim'ne tıklayarak kullanılabilir seçenekleri görüntüleyin. Biçimlendirme seçenekleri sütunun veri türüne bağlıdır.
Sonuç kümesini indirme
Alan kullanıcıları, csv olarak yaklaşık 1 GB'a kadar sonuç verisi indirebilir. 1 GB sınırı son dosya indirme adımından önceki bir adıma uygulandığından, son dosya indirme boyutu 1 GB'tan biraz daha fazla veya daha az olabilir. Sonuçları indirmek için yanıttaki indirme simgesine tıklayın.
Görselleştirmeler oluşturun
Kullanıcılar, sohbet penceresini kullanarak veya yanıtı izleyen Hızlı eylemler bölümünde sağlanan önerilen görselleştirmelerden birini kullanarak açıkça bir görselleştirme isteyebilir. Genie bazen bir yanıtın parçası olarak bir görselleştirme sunar. Otomatik olarak oluşturulan bir görselleştirmeyi gizlemek için daralt simgesine tıklayın. Görselleştirmeyi yeniden göstermek için tıklayıngöster.
Görselleştirmeleri sohbet penceresinde düzenleyebilirsiniz.
Aşağıdaki grafik türleri desteklenir:
- Alan
- Bar
- Satır
- Pasta
- Yaymak
Görselleştirmeyi düzenlemek için:
- Görselleştirmenin sağ üst köşesinde
tıklayın. Sayfanın sağ tarafında bir düzenleme bölmesi açılır.
- Farklı bir grafik türü seçmek için Görselleştirme açılan menüsünü kullanın.
- Çoğu grafik türü için X ekseni ve Y ekseni açılan menülerini kullanarak her eksende temsil edilen değerleri seçin. Pasta grafiklerinde, göstermek istediğiniz sütunu seçmek için Açı açılan menüsünü kullanın.
- (İsteğe bağlı) Renk düzenini özelleştirmek için + kategorisindeki tıklayın.
- (İsteğe bağlı) Görselleştirmenin üzerine geldiğinizde araç ipucunda gösterilecek verileri seçmek için + bölümündeki tıklayın.
Yanıt geri bildirimi vermek
Her AI/BI Genie yanıtı bir başparmak yukarı veya başparmak aşağı geri bildirim düğmesi içerir. Databricks, kullanıcıları bu mekanizmayı kullanarak alan hakkında geri bildirim sağlamaya teşvik etmelerini önerir.
Sorgu sonuçlarını içeren bir yanıt için, kullanıcılar . Bir kullanıcının oluşturulan yanıtın kalitesi veya doğruluğu hakkında soruları varsa, bunu gözden geçirmek üzere işaretleyebilir ve isteğe bağlı olarak yorumunu veya sorusunu ekleyebilir.
İşletme kullanıcıları, Geçmişi sayfasında gözden geçirılmak üzere işaretledikleri soruların güncelleştirmelerini görüntüleyebilir. Genie alanında en azından CAN MANAGE iznine sahip kullanıcılar belirli bir alışverişi gözden geçirebilir, istekle ilgili yorum yapabilir ve yanıtı onaylayabilir veya düzeltebilir. İzleme sayfasından geri bildirime erişebilir ve istekleri gözden geçirebilirler. Ardından bu geri bildirimi kullanarak yanıtları ayarlayabilir ve alanınızda yineleme yapabilirsiniz. Bkz. Geçmişi ve geri bildirimi gözden geçirme.
Geçmişi ve geri bildirimi gözden geçirme
Genie alanı, veri ekiplerinin ve iş kullanıcılarının tek seferlik bir dağıtım değil, bilgi toplaması için sürekli bir işbirliği aracıdır. İş kullanıcılarının yanıtlaması gereken yeni soruları anlamak, bilgi oluşturmak için gereklidir. Geçmiş sayfasında tek tek soruları ve yanıtları, kullanıcılar tarafından sağlanan başparmak yukarı veya başparmak aşağı geri bildirimlerini ve gözden geçirılmak üzere işaretlenmiş soruları görüntüleyebilirsiniz. Geçmiş sayfasını açmak için Genie alanı kenar çubuğunda Geçmiş simgesine tıklayın.
Geçmiş sayfasında, alanda sorulan tüm sorular ve yanıtlar gösterilir. Soruları zamana, derecelendirmeye, kullanıcıya veya duruma göre filtreleyebilirsiniz. Genie alan düzenleyicileri, alanı izleyerek iş kullanıcıları tarafından gönderilen sorguları ve Genie alanının nasıl yanıt verdiğini proaktif olarak anlayabilir.
Genie'nin karşı karşıya olduğu soruları belirleyerek Genie alanını yanıtlarını geliştirmek için belirli yönergelerle güncelleştirebilirsiniz. Soru ve yanıt metnini açmak için bir soruya tıklayın. Bu görünümden sohbet yazışmasının tamamına da erişebilirsiniz.
Oluşturulan SQL'i düzenleme
Oluşturulan SQL'i istediğiniz yanıtta gözden geçirebilir ve düzenleyebilirsiniz. Genie alan yazarları genellikle Genie'nin yanlış bir yanıt oluşturduğunu fark etmelerini sağlayan etki alanını ve verileri bilir. Hatalar genellikle oluşturulan SQL sorgusunda el ile yapılan küçük bir ayarlamayla düzeltilebilir. Herhangi bir yanıt için oluşturulan SQL'i görüntülemek amacıyla, sorguyu incelemek için Kodunu Göster'e tıklayın.
Genie alanında DÜZENLE YETKİSİ veya daha yüksek ayrıcalıklarınız varsa, oluşturulan SQL ifadesini düzeltmek üzere düzenleyebilirsiniz. Düzeltmelerinizi yaptıktan sonra sorguyu çalıştırın. Daha sonra, Genie'ye gelecekte nasıl yanıt verebileceğini öğretmek için bir yönerge olarak kaydedebilirsiniz. Düzenlenen sorgunuzu kaydetmek için Yönerge olarak kaydet simgesine Yönerge olarak kaydet.
Genie alanını paylaşın
Önemli
Genie space kullanıcılarının verilere erişmek için kendi kimlik bilgilerini kullanması gerekir. Erişemedikleri verilerle ilgili herhangi bir soru boş bir yanıt oluşturur.
Genie alanı kullanıcıları, Genie alanına eklenmiş ambarda CAN USE izinlerine ve alanda ortaya çıkarılmış Unity Kataloğu nesnelerinde erişim izinlerine sahip olmalıdır. Bkz. Hangi verileri kullanmalıyım?.
Yeni Genie alanları varsayılan olarak kullanıcı klasörünüzde kaydedilir. Diğer çalışma alanı nesneleri gibi, izinleri kendi kapsayan klasörlerinden devralırlar. Çalışma alanı klasör yapınızı kullanarak bunları diğer kullanıcılarla paylaşabilirsiniz. Bkz. çalışma alanı nesneleriniklasörler halinde düzenleme
Belirli bir izin düzeyinde paylaşılacak belirli kullanıcıları veya grupları da belirtebilirsiniz: YÖNETEBİLİR, DÜZENLEYEBİLİR, ÇALIŞTIRABİLİR ve GÖRÜNTÜLEYEBİLİR.
Belirli kullanıcılar veya gruplarla paylaşmak için:
- Paylaş'a tıklayın.
- Alanı paylaşmak istediğiniz kullanıcıları veya grupları girin. Ardından ekle'ye tıklayın ve uygun izin düzeylerini ayarlayın.
- Genie alanına paylaşılabilir bir bağlantı almak için Paylaş iletişim kutusunun altındaki Bağlantıyı kopyala düğmesini kullanın. Ayrıcalıklı kullanıcılar bağlantıya tıklayarak Genie alanını yeni bir sekmede açabilir ve sorular sorabilir.
Genie alanını kopyala
Genie alanını kopyalamak, tüm kurulum bağlamı ve yönergeleri de dahil olmak üzere bir kopya oluşturur. İyi geliştirilmiş bir alanınız varsa ve ek test için yeni bir alan oluşturmak veya özgün alandan bağlamı yeniden kullanmak istiyorsanız bu yararlı olur. Bir alan kopyalandıktan sonra, yeni alan özgün alandan bağımsızdır ve özgün alanı etkilemeden düzenleme ve ayarlamalar yapmanıza olanak sağlar.
Aşağıdaki öğeler, kopyalanmış bir Genie alanına kopyalanır:
- Tablolar ve ayarlar
- Genel yönergeler
- Örnek SQL sorguları
- SQL işlevleri
Mevcut sohbet yazışmaları ve Geçmişi verileri yeni alana kopyalanmaz.
Genie alanını kopyalamak için aşağıdakileri yapın:
- Kopyalamak istediğiniz Genie alanını açın.
- Alanın sağ üst köşesinde
kebap menüsüne tıklayın.
- Kopyala'e tıklayın.
- (İsteğe bağlı) Kopyala iletişim kutusunda kopyalanan Genie alanı için yeni bir ad ve çalışma alanı klasörü konumu belirtin.
- Yeni alanı oluşturmak için Kopyala'ye tıklayın.
Alan hazırlama için en iyi yöntemler
En iyi yöntemler hakkında rehberlik ve sorunları giderme konusunda yardım için bkz. Etkili bir Genie alanı.
Kullanımı izleme
Genie alanınızın kullanımını izlemek için denetim günlüklerini kullanabilirsiniz. Bkz. AI/BI Genie olayları