Menggunakan keterampilan Agen dengan GitHub Copilot di SQL Server Management Studio

Keterampilan agen adalah serangkaian instruksi yang dapat digunakan kembali yang menginstruksikan GitHub Copilot cara melakukan tugas tertentu. Setiap keterampilan adalah file markdown yang Anda tentukan satu kali, menghemat waktu, dan memastikan perilaku yang konsisten di seluruh alur kerja Anda. Anggap skill sebagai runbook, bukan satu prompt besar. Saat Anda menggunakan mode Agent (pratinjau), Copilot secara otomatis menemukan dan menerapkan keterampilan yang relevan berdasarkan apa yang Anda minta.

Note

Mode Agen GitHub Copilot di SQL Server Management Studio (SSMS) saat ini masih dalam pratinjau.

Tidak seperti instruksi kustom, yang mengatur preferensi umum untuk setiap respons, keterampilan memberikan panduan khusus tugas terfokus yang dapat ditemukan dan digunakan oleh agen mana pun. Tentukan keterampilan sekali, dan berlaku secara konsisten di seluruh sesi dan di seluruh tim Anda.

Prasyarat

Cara kerja keahlian Agent

Saat Anda menggunakan mode Agent, Copilot memindai lokasi skill yang dikenali di repositori dan profil pengguna Anda. Jika deskripsi keterampilan cocok dengan niat permintaan Anda, Copilot mengaktifkan keterampilan dan menerapkan instruksinya sebagai konteks tambahan. Saat keterampilan aktif, namanya muncul di obrolan sehingga Anda tahu bahwa keterampilan sedang diterapkan.

Copilot memutuskan keterampilan mana yang akan diaktifkan berdasarkan kolom description dalam frontmatter masing-masing keterampilan. Deskripsi yang jelas dan kaya kata kunci membantu Copilot mengidentifikasi kapan keterampilan relevan.

Lokasi keterampilan

Copilot menemukan kemampuan di lokasi berikut:

Ruang lingkup Paths Rincian
Ruang kerja (dibagikan dengan tim Anda) .github/skills/, .claude/skills/, .agents/skills/ Disimpan di akar repositori Anda. Berkomitmen pada kontrol sumber sehingga semua anggota tim mendapatkan keterampilan yang sama.
Pribadi (hanya profil Anda) ~/.copilot/skills/, ~/.claude/skills/, ~/.agents/skills/ Berlaku di semua proyek Anda. Tidak berkomitmen pada repositori apa pun.

Keterampilan di ruang kerja diprioritaskan daripada konvensi khusus proyek. Keterampilan pribadi berguna untuk alur kerja dan preferensi yang tetap terbawa saat Anda berpindah antar proyek.

Buat kemampuan

Anda dapat membuat keterampilan dari panel Keterampilan di SSMS atau secara manual di sistem file Anda.

Membuat keterampilan dari panel Keterampilan

  1. Di jendela Copilot Chat, pilih ikon Tools.
  2. Pilih panel Keterampilan .
  3. Di panel Keterampilan, pilih tombol + .
  4. Pilih cakupan: keterampilan ruang kerja (disimpan di repositori) atau keterampilan pribadi (disimpan di profil pengguna Anda).
  5. Masukkan nama untuk keterampilan. Nama menjadi nama direktori dan harus menggunakan huruf kecil, angka, dan tanda hubung saja.
  6. SSMS menghasilkan SKILL.md template di direktori skill baru. Edit templat dan tambahkan instruksi Anda ke file.

Membuat keahlian secara manual

  1. Buat direktori keterampilan di lokasi yang sesuai. Untuk skill workspace, buat .github/skills/ di root repositori Anda.
  2. Buat subdirektori untuk keterampilan Anda. Setiap keterampilan harus memiliki direktorinya sendiri. Misalnya: .github/skills/tsql-style-guide/.
  3. Buat file SKILL.md di dalam direktori skill.
  4. Secara opsional, tambahkan file pendukung seperti skrip, dokumen referensi, atau contoh output.

Struktur direktori keahlian

your-repo/
└── .github/
    └── skills/
        └── index-verification/
        │   ├── SKILL.md          # Required: metadata and instructions
        │   └── references/       # Optional: supplementary documentation
        └── agent-job-failure-triage/
            ├── SKILL.md
            └── examples/         # Optional: example scripts

format SKILL.md

Setiap SKILL.md file harus berisi frontmatter YAML diikuti dengan instruksi Markdown. Frontmatter menyediakan metadata yang Copilot gunakan untuk menemukan dan mengaktifkan keterampilan.

Properti Frontmatter

Property Required Description
name Yes Huruf kecil, angka, dan tanda hubung saja. Harus cocok dengan nama direktori induk. Maksimum 64 karakter.
description Yes Menjelaskan apa yang dilakukan oleh fitur ini dan kapan harus menggunakannya. Maksimum 1.024 karakter. Sertakan kata kunci tertentu yang memberi sinyal ketika keterampilan relevan.
license No Nama lisensi atau referensi ke file lisensi yang disertakan dengan skill.
compatibility No Persyaratan lingkungan, seperti produk yang dimaksudkan atau kemampuan sistem yang diperlukan.
metadata No Pasangan kunci-nilai bebas untuk metadata lainnya.
allowed-tools No Daftar nama alat yang dipisahkan dengan spasi dan telah disetujui sebelumnya untuk digunakan oleh skill.

Mengelola keterampilan dari panel Keterampilan

Pilih ikon Tools di jendela Copilot Chat untuk membuka panel Skills. Panel menunjukkan setiap keterampilan yang Copilot temukan untuk sesi Anda saat ini.

Dari panel, Anda dapat:

  • Edit: Buka file SKILL.md dari keterampilan apa pun langsung di editor dari menu ....
  • Buka lokasi file: Menuju direktori skill pada disk.
  • Pencarian: Memfilter keterampilan menurut nama atau kata kunci.

Panel ini juga menampilkan diagnostik untuk kesalahan konfigurasi keterampilan apa pun, sehingga Anda dapat dengan cepat mengidentifikasi dan memperbaiki masalah.

Tips untuk menulis keterampilan yang efektif

  • Tetap SKILL.md ringkas: Bidik di bawah 300 baris. Pindahkan materi referensi terperinci ke file terpisah di subdirektori yang relevan.
  • Tulis deskripsi yang kaya kata kunci: Copilot menggunakan description untuk memutuskan kapan harus mengaktifkan keterampilan. Sertakan tugas, objek, dan skenario tertentu tempat keterampilan berlaku.
  • Gunakan langkah-langkah bernomor untuk prosedur: Instruksi langkah demi langkah lebih mudah diikuti model daripada prosa.
  • Sertakan contoh output yang diharapkan: Tampilkan kode sampel, format tabel, atau blok komentar sehingga model tahu seperti apa tampilan "selesai".
  • Atur batas eksplisit: Beri tahu keterampilan apa yang tidak boleh dilakukan. Misalnya, "Jangan merekomendasikan penurunan indeks pada tabel dengan lebih dari 10 juta baris tanpa melaporkan volume tulis terlebih dahulu."
  • Materi referensi pendukung: Simpan konten dan skrip terkait dalam file di dalam references\, scripts\, atau examples\, lalu rujuk konten tertentu dari skill.

Contoh keterampilan SQL

Contoh berikut menunjukkan cara menulis keterampilan untuk tugas SQL Server umum. Gunakan sebagai titik awal dan sesuaikan dengan konvensi tim Anda.

Verifikasi indeks

Tinjau indeks yang ada sebelum merekomendasikan indeks baru untuk menghindari duplikasi.

---
name: index-verification
description: Use when an index recommendation has been generated and must be validated before implementation. Verifies workload benefit, redundancy, write overhead, storage impact, and existing index coverage.
---

# Index Verification

## Use this skill when

- A missing index recommendation exists
- An agent generated an index recommendation
- Query tuning suggests adding an index
- A user asks whether an index should be created

## Never assume

- Missing index DMVs are recommendations, not requirements.
- Do not recommend index creation until validation is complete.

## Verification Checklist

### 1. Check Existing Indexes

Determine whether:

- An equivalent index already exists
- A wider index already covers the workload
- Included columns already satisfy the query
- The recommendation duplicates another recommendation

### 2. Estimate Read Benefit

Evaluate:

- Query execution frequency
- Current execution cost
- Expected seek/selectivity improvement
- Number of affected queries

### 3. Evaluate Write Cost

Determine:

- Insert impact
- Update impact
- Delete impact
- Additional maintenance cost

### 4. Evaluate Storage Impact

Estimate:

- Index size on disk
- Memory pressure
- Replication impact

### 5. Make Recommendation

Return one of:

- Create index
- Modify existing index
- Consolidate with existing recommendation
- Reject recommendation

## Avoid

- Blindly trusting missing-index DMVs
- Creating overlapping indexes
- Recommending indexes for one-off queries
- Ignoring write-heavy workloads

## Output Format

Format output as a table: index name, columns, type, and recommendation (create / modify / consolidate / reject).

Triase kegagalan tugas agen

Analisis riwayat pekerjaan Agen SQL yang gagal dan buat rekomendasi untuk mengatasi masalah akar.

---
name: agent-job-failure-triage
description: Use when an automated job, workflow, maintenance task, or agent execution fails. Determines root cause and appropriate remediation while avoiding unsafe recovery actions.
---
# Agent Job Failure Triage

## Objective

Identify root cause before attempting remediation.

## First Rule

Never retry repeatedly without understanding why the job failed.

## Investigation Order

### 1. Collect Failure Details

Gather:

- Job name
- Error message
- Start time
- End time
- Retry history

### 2. Classify Failure

Determine whether failure is:

- Resource-related
- Permission-related
- Configuration-related
- Data-related
- Dependency-related
- Other or unknown

### 3. Check Recent Changes

Investigate:

- Deployments
- Configuration changes
- Schema changes
- Security changes
- Infrastructure changes

### 4. Determine Blast Radius

Identify:

- Data modified by job
- Schema modified by job
- Affected users or departments
- Downstream jobs
- SLA impact
- Data correctness risk

## Safe Actions

- Collect logs
- Validate dependencies
- Escalate when root cause is unknown

## Unsafe Actions

- Retry job
- Disable job
- Force-completing jobs
- Disabling validation checks
- Modifying production data to "make it pass"
- Restarting the SQL Agent service

Konten terkait

  • Last updated on