Perluas Kode Genie dengan keahlian agen

Kode Genie dilengkapi dengan keterampilan bawaan yang telah dikonfigurasi sebelumnya untuk alur kerja Azure Databricks umum, seperti menulis kode di buku catatan Azure Databricks, menjelajahi data di Katalog Unity, membangun dasbor, membuat alur, dan bekerja dengan MLflow. Anda juga dapat membuat keterampilan Anda sendiri untuk memperluas Kode Genie dalam mode Agen dengan kemampuan khusus untuk tugas khusus domain Anda. Halaman ini menjelaskan cara membuat dan mengoptimalkan keterampilan.

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. Dalam mode Agen, Genie Code 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. Admin ruang kerja dapat membuat keterampilan ruang kerja dan memberi orang lain akses ke folder keterampilan untuk menambahkan lebih banyak. Gunakan keterampilan ruang kerja untuk alur kerja yang berguna secara luas di seluruh tim Anda, seperti alur kerja pembelajaran mesin atau proses khusus domain.
  • Keterampilan pengguna: Hanya tersedia untuk Anda. Gunakan keterampilan pengguna untuk alur kerja pribadi yang tidak relevan dengan anggota ruang kerja lainnya.

Nota

Keterampilan hanya didukung dalam mode Agen Kode Genie.

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 mendeteksi keterampilan Anda saat Anda menggunakannya pada mode Agen. Anda juga @ dapat menyebutkan keterampilan agar Genie Code menggunakannya.

Praktik terbaik

Ikuti panduan ini untuk menulis keterampilan yang efektif:

  • Pilih jenis keterampilan yang sesuai. Gunakan keterampilan ruang kerja untuk alur kerja yang menguntungkan banyak pengguna, seperti alur pembelajaran mesin bersama atau proses khusus domain. Gunakan keterampilan pengguna untuk alur kerja pribadi yang tidak relevan dengan orang lain.
  • 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.
  • 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.

Baca juga

  • Last updated on