Genie Code'u ajan becerileriyle genişlet

Genie Code, genel Azure Databricks iş akışları için yerleşik becerilerle birlikte sunulur: not defterlerinde kod yazma, Unity Kataloğu'ndaki verileri keşfetme, pano oluşturma, işlem hatları oluşturma ve MLflow ile çalışma. Genie Code'u ekibinizin etki alanına özgü görevleri için özel özelliklerle genişletmek için özel beceriler oluşturun. Bu sayfada bunları oluşturma ve iyileştirme açıklanmaktadır.

Beceriler nelerdir?

Genie Code'u özel özelliklerle genişletmek için beceriler oluşturun. Beceriler, Etken Becerileri açık standardını takip eder. Beceri paketi, Genie Code'un belirli görevleri gerçekleştirmek için uygun olduğunda yükleyebileceği etki alanına özgü bilgileri ve iş akışlarını paketler. Beceriler rehberlik, en iyi yöntemler, yeniden kullanılabilir kod ve yürütülebilir betikler içerebilir.

Beceriler etki alanına özgü görevler için uyarlanmalıdır. Yönergelerle sağlayabileceğinizden daha geniş bir bağlamı, becerilerle (betikler, örnekler ve diğer kaynaklar gibi) sunabilirsiniz. Genel olarak uygulanan özel yönergelerin aksine, beceriler otomatik olarak ve yalnızca ilgili bağlamda yüklenir. Genie Code, isteğinize ve beceri açıklamasına göre ilgili olduğunda becerileri otomatik olarak yükler. Ayrıca, @ becerileri manuel olarak belirterek çağırabilirsiniz. Bu, verimli bir bağlam penceresi sağlar ve birden çok sohbette aynı bağlamı sağlama gereksinimini azaltır.

İki tür beceri vardır:

  • Çalışma alanı becerileri: Çalışma alanındaki herkes tarafından kullanılabilir. Çalışma alanı yöneticileri çalışma alanı becerileri oluşturabilir ve daha fazlasını eklemek için başkalarına beceri klasörüne erişim verebilir. Kuruluş genelinde standartları zorunlu kılmak, kullanıcılar genelinde tutarlı çıktılar sunmak (örneğin, hassas sütunları maskeleyen bir PII işleme becerisi) veya farklı ekiplere (örneğin, veri mühendisleri için işlem hattı şablonları ve ML platformu kullanıcıları için model eğitim playbook'ları) hizmet vermek için çalışma alanı becerilerini kullanın.
  • Kullanıcı becerileri: Yalnızca sizin kullanımınıza sunulur. Tercih edilen kitaplıklar, kodlama stili veya rol ve arka plan bağlamı gibi kişisel tercihler için kullanıcı becerilerini kullanın. Kullanıcı becerileri, bir beceriyi çalışma alanı düzeyine yükseltmeden önce prototip oluşturmak için de yararlıdır.

Beceri oluşturma

Beceriler bir .assistant/skills/ dizinde bulunur. Her becerinin kendi klasörü ve bu klasör içinde bir SKILL.md dosyası olmalıdır. Konum, beceri türüne bağlıdır:

  • Çalışma alanı becerileri: Workspace/.assistant/skills/
  • Kullanıcı becerileri: /Users/{username}/.assistant/skills/

Yeni bir beceri oluşturmak için:

  1. Beceri türünüz için uygun yolda yeni bir beceri klasörü oluşturun.

    Oluşturma işleminden sonra Genie Code bölmesindeki beceri klasörünüze hızla erişebilirsiniz. Dişli simgesine tıklayın. Ayarlar'ı ve ardından Simgedeki Ok'a tıklayın. Beceri klasörünü açın.

  2. Beceri klasörünün içinde beceriniz için ayrılmış bir klasör oluşturun. Her becerinin kendi klasörü olmalıdır. Örneğin:

    Workspace/.assistant/skills/
└── ml-workflows/
    └── SKILL.md

/Users/{username}/.assistant/skills/
└── personal-workflows/
    └── SKILL.md

  3. Beceri klasörünüzün içinde bir SKILL.md dosya oluşturun. Bu dosya gereklidir ve beceriyi tanımlar. Beceriler, Temsilci Becerileri özelliklerini takip eder.

  4. Beceriniz için gerekli ön bilgiyi ekleyin.

    ---
name: skill-name
description: A description of what this skill does and when to use it.
---

  5. Beceri yönergelerini ön bilgilendirmeden sonra Markdown biçiminde ekleyin. Aşağıdaki bölümlerin eklenmesi önerilir:

    • Adım adım yönergeler: Açık yordam kılavuzu
    • Örnekler: Örnek girişler ve beklenen çıkışlar
    • Sınır durumlar: Yaygın çeşitlemeler ve istisnalar

  6. (İsteğe bağlı) Daha karmaşık beceriler için ek kaynaklar sağlayabilir ve bunlara başvurabilirsiniz:

    • Aracının çalıştırabileceği yürütülebilir kod içeren betikler.
    • Başvuruda bulunılması gereken en iyi yöntemler ve şablonlar gibi ek belgeler içeren dosyalar.

    Diğer dosyalara başvururken kök beceriden göreli yollar kullanın.

    Örneğin, bir çalışma alanı makine öğrenmesi iş akışı becerisi ve kişisel iş akışı becerisi aşağıdaki yapıya sahip olabilir:

    Workspace/.assistant/skills/
├── ml-workflows/
   ├── SKILL.md                # Workflow overview and best practices
   ├── training-patterns.md    # Standard ML training patterns
   └── scripts/
         └── model-deploy.py   # Model deployment automation

/Users/{username}/.assistant/skills/
├── personal-workflows/
   ├── SKILL.md                # Workflow overview and best practices
   ├── etl-patterns.md         # Personal ETL best practices
   ├── dashboard-templates.md   # Reusable dashboard patterns
   └── scripts/
         └── pipeline-setup.sh   # Environment setup scripts

Genie Code, becerilerinizi bir sonraki kullanışınızda otomatik olarak alır. Genie Code'un bunları kullandığından emin olmak için becerilerden de @ bahsedebilirsiniz.

Mevcut bir yeteneği düzenlediğinizde, değişikliklerinizi uygulamak için yeni bir sohbet başlatın. Düzenlemeler aktif sohbetlerde etkili olmuyor. Eski davranışı veya güncel olmayan bir açıklamayı gösterme gibi bir beceri yine de eski görünüyorsa, önbelleğe alınmış beceri meta verilerini temizlemek için tarayıcı sekmesini sabit olarak yenileyin.

En iyi uygulamalar

Etkili beceriler yazmak için şu yönergeleri izleyin:

  • Uygun beceri türünü seçin. Her kullanıcının tutarlı çıkış elde edebilmesi için paylaşılan standartları (PII işleme, adlandırma kuralları veya takıma özgü şablonlar gibi) koordine etmek için çalışma alanı becerilerini kullanın. Kişisel tercihler için kullanıcı becerilerini kullanın ve çalışma alanına yükseltmeden önce bir becerinin prototipini oluşturun.
  • Becerilerin odaklanmış kalmasını sağlayın. Beceriler tek bir göreve veya iş akışına odaklandığında en iyi şekilde çalışır. Dar kapsam, Genie Code'un bir becerinin ne zaman geçerli olduğunu tanımasını kolaylaştırır.
  • Açık ve anlaşılır adlar ve açıklamalar kullanın. Genie Code'un doğru beceriyi doğru istekle eşleştirmesine yardımcı olan kısa, açıklayıcı bir ad ve özet.
  • Açık ve örnek temelli olun. İş akışlarını adım adım açıklayın ve Genie Code'un yeniden kullanabileceği somut örnekler veya desenler ekleyin.
  • Gereksiz bağlamlardan kaçının. Yalnızca görev için gereken bilgileri ekleyin. Ek ayrıntılar, becerilerin güvenilir bir şekilde uygulanmasını zorlaştırabilir.
  • Zaman içinde tekrarla. Becerileri canlı iş akışları olarak değerlendirin. Gerçek kullanıma dayalı küçük güncelleştirmeler sonuçları önemli ölçüde iyileştirebilir.
  • Genie Code ile becerilerinizi yazın. Becerilerin taslağını hazırlamak ve geliştirmek için Genie Code kullanın. Temsilcinin nerede zorlandığına bakmak için temsilci görevlerinde yeni veya güncelleştirilmiş becerileri test edin, ardından bu boşlukları kapatmak için yönergeleri güncelleştirin.
  • Kılavuzu otomasyondan ayırın. Amacı ve en iyi yöntemleri açıklamak için markdown'ı ve yinelenebilir eylemlere yönelik betikleri kullanın. Bu endişelerin ayrı tutulması, becerilerin korunmasını ve yeniden kullanılmasını kolaylaştırır.
  • Becerilerinizi versiyon kontrolü ile yönetin. Değişiklikleri izlemek, ekip arkadaşlarınızla işbirliği yapmak ve gerektiğinde geri almak için Databricks Git klasörleriyle beceri klasörünüzü geri alın.

Ek kaynaklar

  • Last updated on