Bagikan melalui

Perluas Kode Genie dengan keahlian agen

Buat keterampilan 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.

Nota

Keterampilan hanya didukung dalam mode Agen Kode Genie.

Buat kemampuan

Keterampilan berada di direktori /Users/{username}/.assistant/skills/. Setiap keterampilan harus memiliki folder sendiri dan file SKILL.md dalam folder tersebut.

Untuk membuat keterampilan baru:

  1. Di folder ruang kerja pengguna Anda, buat folder keterampilan baru. Jalur folder harus: /Users/{username}/.assistant/skills/.

    Setelah pembuatan, Anda dapat dengan cepat mengakses folder ini 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. Misalnya, jika Anda membuat keterampilan untuk alur kerja pribadi, struktur folder Anda mungkin:

    /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, Anda mungkin memiliki keterampilan alur kerja pribadi yang mereferensikan praktik terbaik ETL, templat dasbor, dan skrip untuk penyiapan dan penyebaran alur. Folder keterampilan Anda dapat mencakup file berikut:

    /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
         └── model-deploy.py     # Model deployment automation

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:

  • 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.

Baca juga

  • Last updated on