Databricks uygulamasına Genie Agent kaynağı ekleme

Uygulamalarınızda doğal dil sorgulamayı etkinleştirmek için Genie Aracılarını Databricks Uygulamaları kaynakları olarak ekleyin. Genie Agents, 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ğlayan, veri keşfetmeye yönelik bir konuşma arabirimi sağlar.

Genie Agent'ı kaynak olarak 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 Agent kaynağı ekleme

Genie Agent'ı kaynak olarak eklemeden önce uygulama kaynağı önkoşullarını gözden geçirin.

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

Genie Agent kaynağı eklediğinizde:

• Azure Databricks, uygulamanızın hizmet sorumlusuna seçili Genie Aracısı üzerinde belirtilen izinleri verir.
• Uygulama, aracıya 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 aracının seçilmiş iş bağlamlarına erişir.
• Erişimin kapsamı yalnızca seçili aracıya göre belirlenir. Uygulamanız, ayrı kaynaklar olarak eklemediğiniz sürece diğer Genie Aracılarına erişemez.

Uyarı

Uygulamanın hizmet sorumlusunun, Genie Aracısı tarafından sorgulanması için temel alınan veri kaynakları üzerinde de uygun izinlere sahip olması gerekir. Bu genellikle ilgili Unity Kataloğu tabloları ve görünümleri, USE CATALOG, USE SCHEMA ve SELECT izinlerini içerir.

Ortam değişkenleri

Bir uygulamayı Genie Agent kaynağıyla dağıttığınızda Azure Databricks, alan kimliğini, valueFrom yapılandırmanızdaki app.yaml alanını kullanarak 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 Agent 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 Aracısı kaynağını kaldırma

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

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

Genie Aracılarını diğer Databricks Apps kaynaklarıyla birleştirerek daha gelişmiş 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 Aracısı: 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ırlar: 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 Aracısı: İ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 Aracısı'nda
• CAN USE SQL ambarı üzerinde (Genie Aracısı'ndan ayrı bir tane kullanıyorsanız)
• CAN QUERY uç noktaları sunan modelde
• USE CATALOG ve USE SCHEMA ilişkili Unity Kataloğu nesnelerinde
• SELECT uygulama doğrudan tablolarda sorgulama yapar

En iyi yöntemler

Genie Agent 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 Aracılarına erişim sağlayın.
• Genie Agent'ı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 Aracısı'na karşı test edin.
• Sorgu performansını izleyin ve yanıt sürelerini iyileştirmek için Genie Aracısı ile uygulamanızın etkileşim desenlerini ayarlayın.
• Genie Aracısı'nın kullanıcı sorgularını etkili bir şekilde yorumlayabildiği veya yanıtlayemediği durumlar için hata işleme uygulayın.