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.

Genie Code becerileri 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

Varsayılan olarak, beceriler klasörde .assistant/skills/ 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.

Başka bir klasörden beceri ekle

Varsayılan olarak, Genie Code yetenekleri klasörlerden .assistant/skills/ yükler. Ayrıca ek beceri klasörleri kaydedebilirsiniz; böylece çalışma alanınızın başka yerlerinde bulunan beceriler, .assistant/skills/ içine taşınmadan kullanılabilir olur. Bu, yetenekleri ilişkili oldukları proje kodunun yanında bir Databricks Git klasöründe sakladığınızda faydalıdır.

Kaydettiğiniz klasör, yetenek alt klasörleri içeren bir ana klasör olmalı, aynı yapıya .assistant/skills/sahiptir. Her becerinin hâlâ içinde bir SKILL.md dosyası bulunan kendi alt klasörüne sahip olması gerekir. Doğrudan dosya SKILL.md içeren bir klasörü kaydetmeyin.

Örneğin, aşağıdaki yapıya sahip olduğunda kayıt /Users/{username}/my-skills/ yapın:

/Users/{username}/my-skills/
├── etl-checks/
│   └── SKILL.md
└── release-notes/
    └── SKILL.md

Ekstra bir yetenek klasörü kaydetmek için:

  1. Genie Code bölmesinde, beceri ayarlarını açmak için Dişli simgesi Ayarlar seçeneğine tıklayın.
  2. Bir yetenek ekleme sırasında, (örneğin, /Users/{username}/my-skills) ile / başlayan bir çalışma alanı yolunu girin veya bir klasör seçmek için göz atma butonunu kullanın. Alan, bir beceri adını veya bir klasör yolunu kabul eder (Skill name or /path/to/skills/folder).
  3. Ekle klasörüne tıklayın.

Kayıtlı klasörler, varsayılan yeteneklerinizin yanındaki yetenek listesinde görünür ve her yeteneği anahtarla açıp kapatabilirsiniz. Varsayılan .assistant/skills/ klasörleriniz kullanılabilir kalır. Ekstra klasörler ekleyicidir.

Yazma becerileri için 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. O klasörü çalışma alanınızın herhangi bir yerinde tutabilir ve ekstra yetenek klasörü olarak kaydedebilirsiniz, böylece klonlamanıza .assistant/skills/gerek kalmaz.

Ek kaynaklar

  • Son güncelleştirme: