Perluas Kode Genie dengan keahlian agen

Genie Code hadir dengan kemampuan bawaan untuk alur kerja umum di Azure Databricks: menulis kode di notebook, menjelajahi data di Unity Catalog, membuat dasbor, membuat pipeline, dan bekerja dengan MLflow. Buat keterampilan kustom untuk memperluas Kode Genie dengan kemampuan khusus untuk tugas khusus domain tim Anda. Halaman ini menjelaskan cara membuat dan mengoptimalkannya.

Apa itu keterampilan?

Buat keterampilan untuk memperluas Kode Genie dengan kemampuan khusus. Keterampilan mengikuti standar terbuka Keterampilan Agen. Keterampilan mencakup pengetahuan dan alur kerja khusus domain yang dapat dimuat oleh Kode Genie ketika relevan untuk melakukan tugas tertentu. Keterampilan dapat mencakup panduan, praktik terbaik, kode yang dapat digunakan kembali, dan skrip yang dapat dieksekusi.

Keterampilan harus disesuaikan untuk tugas yang bersifat khusus domain. Dengan keterampilan, Anda dapat memberikan konteks yang lebih besar (seperti skrip, contoh, dan sumber daya lainnya) untuk tugas daripada yang Anda bisa dengan instruksi. Tidak seperti instruksi kustom, yang diterapkan secara global, keterampilan dimuat secara otomatis dan hanya dalam konteks yang relevan. Kode Genie secara otomatis memuat keterampilan jika relevan, berdasarkan permintaan Anda dan deskripsi keterampilan. Anda juga dapat memanggil keterampilan secara manual dengan @ menyebutkannya. Ini mempertahankan jendela konteks yang efisien dan mengurangi kebutuhan untuk memberikan konteks yang sama di beberapa obrolan.

Ada dua jenis keterampilan:

  • Keterampilan ruang kerja: Tersedia untuk semua orang di ruang kerja. Administrator ruang kerja dapat membuat keterampilan ruang kerja dan memberi orang lain akses ke folder keterampilan untuk menambahkan lebih banyak. Gunakan keterampilan ruang kerja untuk menegakkan standar di seluruh organisasi, memberikan output yang konsisten di seluruh pengguna (misalnya, keterampilan penanganan PII yang menutupi kolom sensitif), atau melayani tim yang berbeda (misalnya, templat alur untuk teknisi data dan playbook pelatihan model untuk pengguna platform ML).
  • Keterampilan pengguna: Hanya tersedia untuk Anda. Gunakan keterampilan pengguna untuk preferensi pribadi seperti pustaka pilihan, gaya pengodean, atau konteks peran dan latar belakang. Keterampilan pengguna juga berguna untuk membuat prototipe keterampilan sebelum mempromosikannya ke tingkat ruang kerja.

Buat kemampuan

Keterampilan disimpan di direktori .assistant/skills/. Setiap keterampilan harus memiliki folder sendiri dan file SKILL.md dalam folder tersebut. Lokasi tergantung pada jenis keterampilan:

  • Keterampilan ruang kerja: Workspace/.assistant/skills/
  • Keterampilan pengguna: /Users/{username}/.assistant/skills/

Untuk membuat keterampilan baru:

  1. Buat folder keterampilan baru di jalur yang sesuai untuk jenis keterampilan Anda.

    Setelah pembuatan, Anda dapat dengan cepat mengakses folder keterampilan Anda di panel Kode Genie. Klik ikon Roda Gigi Pengaturan, lalu klik Ikon Panah Buka folder skill.

  2. Buat folder khusus untuk keterampilan Anda di dalam folder keterampilan. Setiap keterampilan harus memiliki folder sendiri. Contohnya:

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

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

  3. Di dalam folder kemampuan Anda, buat sebuah file SKILL.md. File ini diperlukan dan mendefinisikan keterampilan. Keterampilan mengikuti spesifikasi Keterampilan Agen.

  4. Tambahkan frontmatter yang diperlukan untuk keterampilan Anda:

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

  5. Tambahkan instruksi keterampilan dalam format Markdown setelah bagian frontmatter. Disarankan untuk menyertakan bagian berikut:

    • Instruksi langkah demi langkah: Panduan prosedural yang jelas
    • Contoh: Contoh input dan output yang diharapkan
    • Kasus Edge: Variasi dan pengecualian umum

  6. (Opsional) Untuk keterampilan yang lebih kompleks, Anda dapat menyediakan dan mereferensikan sumber daya tambahan:

    • Skrip yang berisi kode yang dapat dieksekusi yang dapat dijalankan agen.
    • File yang berisi dokumentasi tambahan untuk dirujuk, seperti praktik terbaik dan templat.

    Saat mereferensikan file lain, gunakan jalur relatif dari root skill.

    Misalnya, keterampilan alur kerja pembelajaran mesin ruang kerja dan keterampilan alur kerja pribadi mungkin memiliki struktur berikut:

    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 secara otomatis mengenali keterampilan Anda saat berikutnya Anda menggunakannya. Anda juga @ dapat menyebutkan keterampilan agar Genie Code menggunakannya.

Saat Anda mengedit keterampilan yang sudah ada, mulai obrolan baru untuk menerapkan perubahan Anda. Edit tidak berlaku di chat aktif. Jika keterampilan masih tampak basi, seperti menampilkan perilaku lama atau deskripsi yang kedaluarsa, refresh tab browser secara permanen untuk menghapus metadata keterampilan yang di-cache.

Praktik terbaik

Ikuti panduan ini untuk menulis keterampilan yang efektif:

  • Pilih jenis keterampilan yang sesuai. Gunakan keterampilan ruang kerja untuk mengkodifikasi standar bersama (seperti penanganan PII, konvensi penamaan, atau templat khusus tim) sehingga setiap pengguna mendapatkan output yang konsisten. Gunakan keterampilan pengguna untuk preferensi pribadi dan untuk membuat prototipe keterampilan sebelum mempromosikannya ke ruang kerja.
  • Pastikan keterampilan tetap terfokus. Keterampilan berfungsi paling baik ketika mereka fokus pada satu tugas atau alur kerja. Cakupan sempit memudahkan Genie Code untuk mengenali kapan keterampilan berlaku.
  • Gunakan nama dan deskripsi yang jelas. Nama dan ringkasan yang ringkas dan deskriptif membantu Kode Genie mencocokkan keterampilan yang tepat dengan permintaan yang tepat.
  • Jadilah eksplisit dan digerakkan oleh contoh. Jelaskan alur kerja langkah demi langkah dan sertakan contoh konkret atau pola yang dapat digunakan kembali Kode Genie.
  • Hindari konteks yang tidak perlu. Hanya sertakan informasi yang diperlukan untuk tugas tersebut. Detail ekstra dapat membuat keterampilan lebih sulit diterapkan dengan andal.
  • Iterasi seiring waktu. Perlakukan keterampilan sebagai alur kerja hidup. Pembaruan kecil berdasarkan penggunaan nyata dapat secara signifikan meningkatkan hasil.
  • Keahlian penulis dengan Genie Code. Gunakan Genie Code untuk menyusun dan menyempurnakan keterampilan. Uji keterampilan baru atau yang diperbarui pada tugas perwakilan untuk menemukan di mana agen berjuang, lalu perbarui instruksi untuk menutup celah tersebut.
  • Panduan dipisahkan dari otomatisasi. Gunakan markdown untuk menjelaskan niat dan praktik terbaik, dan skrip untuk tindakan yang dapat diulang. Menjaga aspek-aspek ini tetap berbeda membuat kemampuan lebih mudah dipelihara dan digunakan kembali.
  • Versi kontrol keterampilan Anda. Kembalikan folder keterampilan Anda dengan folder Databricks Git untuk melacak perubahan, berkolaborasi dengan rekan satu tim, dan putar kembali saat diperlukan.

Sumber daya tambahan

  • Last updated on