Unity Catalog'daki Ajan Hizmetleri

Important

Bu özellik Beta sürümündedir. Hesap yöneticileri bu özelliğe erişimi hesap konsolu Önizlemeler sayfasından denetleyebilir. Bkz. Azure Databricks önizlemelerini yönetme.

Aracı Hizmetleri, tüm yapay zeka aracılarınıza Unity Kataloğu'nda bir ev sağlar. Herhangi bir ekipteki ajanları tek bir yerde kaydedin, bunlara tablolarınız, modelleriniz ve işlevlerinizle birlikte göz atıp keşfedin ve diğer Unity Catalog varlıklarınızı koruyan aynı yetkilendirmelerle izinleri ayarlayın.

Katalog Gezgini'nde aracıları bulma

Bir aracı hizmeti kaydedildikten sonra Katalog Gezgini'nde oluşturulduğu şemanın altında görünür. Aracı hizmetinde READ_METADATA olan herkes, aynı şemadaki tablolar, modeller ve fonksiyonlarla birlikte ona göz atabilir. Adını, açıklamasını, bağlantısını ve geçerli izinlerini görüntülemek için bir aracı hizmeti seçin.

Bir aracı hizmeti oluştururken veya güncellerken açıklama eklemek için comment alanını kullanın. Bu açıklama Katalog Gezgini'nde görünür ve ekip arkadaşlarının aracıya göz attıklarında onun ne işe yaradığını anlamalarına yardımcı olur.

Bu, kuruluşunuza hangi aracıların var olduğunu, kimlerin sahip olduğunu ve kimlerin erişimi olduğunu ayrı sistemlerde veya belgelerde izlemek zorunda kalmadan tek bir yer sağlar.

Requirements

  • Bir ajan hizmeti oluşturmak için, üst katalog ve şema üzerinde USE CATALOG ve USE SCHEMA, şema üzerinde CREATE SERVICE ve ajan hizmetinin başvurduğu bağlantı üzerinde USE CONNECTION ayrıcalıklarına sahip olmanız gerekir.
  • Bir aracı hizmetinde izinleri yönetmek için, aracı hizmetinde MANAGE_ACCESS_CONTROL sahip olmanız gerekir.

Aracı hizmet oluşturun

Bir aracı hizmeti, aracı için ana bilgisayar ve kimlik bilgilerini içeren mevcut bir Unity Catalog bağlantısına başvurur. Aracı hizmeti oluşturmadan önce bağlantıyı oluşturun.

Aşağıdaki örnek, şemada support_agent adlı main.default bir aracı hizmeti oluşturur:

databricks api post \
  "/api/2.1/unity-catalog/agent-services?parent=schemas/main.default&agent_service_id=support_agent" \
  --json '{
    "agent_service_type": "AGENT_SERVICE_TYPE_EXTERNAL",
    "comment": "Support agent for the customer team",
    "config": {
      "connection": {
        "name": "connections/main.default.my_agent_connection"
      },
      "base_path": "/v1/chat",
      "system_prompt": "You are a helpful support assistant."
    }
  }'

Yanıt, aracı hizmetinin kaynak adını içerir:

{
  "name": "agent-services/main.default.support_agent",
  "agent_service_type": "AGENT_SERVICE_TYPE_EXTERNAL",
  "created_by": "you@company.com",
  "config": {
    "connection": { "name": "main.default.my_agent_connection" },
    "base_path": "/v1/chat",
    "system_prompt": "You are a helpful support assistant."
  }
}

Ajan hizmetlerini al ve listele

Tam adını kullanarak tek bir ajan hizmeti getirin:

databricks api get "/api/2.1/unity-catalog/agent-services/main.default.support_agent"

Şemadaki tüm aracı hizmetlerini listeleyin:

databricks api get "/api/2.1/unity-catalog/agent-services?parent=schemas/main.default"

Meta veri deposunun tamamında aracı hizmetlerini listelemek için şema filtresini atla:

databricks api get "/api/2.1/unity-catalog/agent-services"

Aracı hizmetini güncelleştirme

Belirli alanları başkalarının üzerine yazmadan güncelleştirmek için bir PATCH istek kullanın ve hangi alanların değiştirileceğini belirtin. Aşağıdaki örnek, sistem istemini güncelleştirirken diğer tüm alanları değiştirmeden bırakır:

databricks api patch \
  "/api/2.1/unity-catalog/agent-services/main.default.support_agent?update_mask=config.system_prompt" \
  --json '{ "config": { "system_prompt": "You are a concise support assistant." } }'

Güncelleştirebileceğiniz alanlar: comment, config.system_prompt, config.base_path.

Erişim izni ver

Diğer Unity Kataloğu güvenliği sağlanabilir nesnelerinizi koruyan aynı verme modeline sahip bir aracı hizmetinde izinleri ayarlayın. EXECUTE öğesini kullanıcılara ve hizmet sorumlularına verin:

databricks api patch \
  "/api/2.1/unity-catalog/permissions/AGENT_SERVICE/main.default.support_agent" \
  --json '{
    "changes": [
      { "principal": "teammate@company.com", "add": ["EXECUTE"] }
    ]
  }'

Geçerli izinleri inceleyin:

databricks api get "/api/2.1/unity-catalog/permissions/AGENT_SERVICE/main.default.support_agent"

Erişimi iptal et:

databricks api patch \
  "/api/2.1/unity-catalog/permissions/AGENT_SERVICE/main.default.support_agent" \
  --json '{
    "changes": [
      { "principal": "teammate@company.com", "remove": ["EXECUTE"] }
    ]
  }'

Atanabilir ayrıcalıklar: EXECUTE, READ_METADATA, MANAGE, MANAGE_ACCESS_CONTROL, ALL_PRIVILEGES.

Bir aracı hizmeti silme

databricks api delete "/api/2.1/unity-catalog/agent-services/main.default.support_agent"

Limitations

Beta sırasında aşağıdaki sınırlamalar geçerlidir:

  • Çalışma zamanı çağırma işlemi kullanılamıyor. Aracılar, kayıtlı bir aracı hizmeti üzerinden çağrılamaz. Kayıt ve izin yönetimi artık kullanılabilir.
  • Hizmet ilkeleri ve hız sınırları API tarafından desteklenmez. Bu alanları ayarlamaya çalışmak bir hata döndürür.
  • Aracı hizmetleri için SQL DDL kullanılamaz. REST API ile aracı hizmetleri oluşturun ve yönetin.
  • full_name ve owner alanları bu sürümde null yanıtlarında GET döndürür.
  • Unity Catalog Genel Arama, ajan hizmetlerini göstermez.

Sonraki Adımlar

  • Last updated on