Databricks uygulamasına Genie alan kaynağı ekleme

Uygulamalarınızda doğal dil sorgulamayı etkinleştirmek için Databricks Apps kaynakları olarak AI/BI Genie alanları ekleyin. Genie spaces, veri keşfi için konuşma arabirimi sağlayarak kullanıcıların iş sorularını düz İngilizce olarak sormasına ve seçilen veri kümelerinden SQL tabanlı içgörüler almasına olanak sağlar.

Kaynak olarak genie alanı eklediğinizde uygulamanız şunları yapabilir:

• Kullanıcılardan gelen doğal dil sorgularını SQL'e dönüştürme
• Önceden yapılandırılmış iş bağlamı ve meta verilerine erişme
• Seçilen örnek sorguları ve veri tanımlarını kullanma
• Kuruluşunuzun veri kümelerini temel alan yanıtlar oluşturma

Genie alan kaynağı ekleme

Kaynak olarak genie alanı eklemeden önce uygulama kaynağı önkoşullarını gözden geçirin.

1. Bir uygulama oluşturduğunuzda veya düzenlediğinizde Yapılandır adımına gidin.
2. Uygulama kaynakları bölümünde + Kaynak ekle'ye tıklayın.
3. Kaynak türü olarak Genie alanı'nı seçin.
4. Çalışma alanınızdaki kullanılabilir alanlar listesinden bir Genie alanı seçin.
5. Uygulamanız için izin düzeyini seçin:
   • Görüntüleyebilir: Uygulamaya Genie alan yapılandırmasını ve meta verilerini okuma izni verir.
   • Şu komutu çalıştırabilir: Uygulamaya Genie alanına sorgu gönderme ve yanıt alma izni verir.
   • Düzenleyebilir: Uygulamaya Genie alanı yapılandırmasını değiştirme izni verir.
   • Yönetilebilir: Uygulamaya Genie alanına tam yönetim erişimi verir.
6. (İsteğe bağlı) Uygulama yapılandırmanızda Genie alanına nasıl başvuracağınız için özel bir kaynak anahtarı belirtin. Varsayılan anahtardır genie-space.

Genie uzay kaynağı eklediğinizde:

• Azure Databricks, uygulamanızın hizmet sorumlusuna seçili Genie alanı üzerinde belirtilen izinleri verir.
• Uygulama alana doğal dil sorguları gönderebilir ve SQL sorguları ve sonuçlarıyla yapılandırılmış yanıtlar alabilir.
• Uygulama meta veriler, örnek sorgular ve veri tanımları dahil olmak üzere alanın seçilmiş iş bağlamlarına erişir.
• Erişimin kapsamı yalnızca seçili alan olarak belirlenmiştir. Uygulamanız, ayrı kaynaklar olarak eklemediğiniz sürece diğer Genie alanlarına erişemez.

Uyarı

Uygulamanın hizmet sorumlusunun, Genie alanı tarafından sorgulanması için temel alınan veri kaynakları üzerinde de uygun izinlere sahip olması gerekir. Bu genellikle ilgili Unity Kataloğu tablo ve USE CATALOG görünümlerinde , USE SCHEMAve izinlerini içerirSELECT.

Ortam değişkenleri

Genie uzay kaynağıyla bir uygulama dağıttığınızda Azure Databricks, alan kimliğini yapılandırmanızdaki valueFrom alanı kullanarak app.yaml başvurabileceğiniz ortam değişkenleri aracılığıyla kullanıma sunar.

Örnek yapılandırma:

env:
  - name: GENIE_SPACE_ID
    valueFrom: genie-space # Use your custom resource key if different

Uygulamanızda alan kimliğini kullanma:

import os
from databricks.sdk import WorkspaceClient

# Access the Genie space using the injected environment variable
space_id = os.getenv("GENIE_SPACE_ID")

# Initialize the workspace client
w = WorkspaceClient()

# Start a conversation with a natural language query
response = w.genie.start_conversation_and_wait(
    space_id=space_id,
    content="What were our top-selling products last quarter?"
)

# Process the response (responses contain attachments with text, queries, and so on)
for attachment in response.attachments:
    print(f"Genie response: {attachment.text.content}")

# Continue the conversation with additional questions
follow_up = w.genie.create_message_and_wait(
    space_id=space_id,
    conversation_id=response.conversation_id,
    content="Can you break that down by product category?"
)

Daha fazla bilgi için bkz. Kaynaklardan ortam değişkenlerine erişme.

Genie alan kaynağını kaldırma

Bir uygulamadan Genie alan kaynağını kaldırdığınızda, uygulamanın hizmet sorumlusu alana erişimi kaybeder. Genie alanının kendisi değişmeden kalır ve uygun izinlere sahip diğer kullanıcılar ve uygulamalar için kullanılabilir olmaya devam eder.

Genie alanlarını diğer uygulama kaynaklarıyla birleştirme

Genie alanlarını diğer Databricks Apps kaynaklarıyla birleştirerek daha karmaşık veri uygulamaları oluşturun. Yaygın tümleştirme desenleri şunlardır:

Doğal dil analizi panosu

Etkileşimli analiz çalıştırmak için aşağıdaki kaynakları birlikte kullanın:

• Genie uzayı: Kullanıcı sorularını SQL sorgularına dönüştürür
• SQL ambarı: Sorguları çalıştırır ve görselleştirme sonuçlarını döndürür
• Sır -larını: Dış görselleştirme araçları için API anahtarlarını depolar

Örnek yapılandırma:

env:
  - name: GENIE_SPACE_ID
    valueFrom: genie-space
  - name: SQL_WAREHOUSE_ID
    valueFrom: sql-warehouse
  - name: EXTERNAL_API_KEY
    valueFrom: viz-secret

Yapay zeka destekli iş zekası

Yapay zeka modelleriyle tümleştirmek için aşağıdaki kaynakları kullanın:

• Genie uzayı: İlk sorguyu ve veri bağlamını oluşturur
• Model sunma uç noktası: Yapay zeka tarafından oluşturulan özetleri ve önerileri döndürür
• SQL ambarı: Karmaşık analitik sorgular çalıştırır

Hizmet sorumlusu izinleri

Diğer uygulama kaynaklarıyla tümleştirme yaparken uygulamanızın hizmet sorumlusuna aşağıdaki izinleri verin:

• CAN RUN Genie alanında
• CAN USE SQL ambarı üzerinde (Genie alanından ayrı bir tane kullanıyorsanız)
• CAN QUERY uç noktaları sunan modelde
• USE CATALOG ve USE SCHEMA ilgili Unity Kataloğu nesnelerinde
• SELECT tablolarda uygulama doğrudan sorgular

En iyi yöntemler

Genie uzay kaynaklarıyla çalışırken şu en iyi yöntemleri izleyin:

• En düşük izinleri verin. Yalnızca uygulamanızın çalışması için gereken belirli Genie alanlarına erişim sağlayın.
• Genie alanının, doğal dil sorgu yanıtlarının kalitesini artırmak için iyi seçilmiş veri kümeleri ve meta veriler içerdiğinden emin olun.
• Beklenen kullanıcı soruları için doğru sonuçlar oluşturabildiğini doğrulamak için uygulamanızın sorgularını Genie alanında test edin.
• Yanıt sürelerini iyileştirmek için sorgu performansını izleyin ve uygulamanızın Genie alanıyla etkileşim desenlerini ayarlayın.
• Genie alanının kullanıcı sorgularını etkili bir şekilde yorumlayemediği veya yanıtlayemediği durumlar için hata işleme uygulayın.