Používání dovedností agenta s GitHub Copilot v SQL Server Management Studio

Dovednosti agenta jsou znovu použitelné sady pokynů, které určují GitHub Copilotu, jak provádět konkrétní úlohy. Každá dovednost je soubor markdownu, který definujete jednou, ušetříte čas a zajistíte konzistentní chování v rámci pracovního postupu. Představte si dovednosti spíše jako runbook než jako jeden obří prompt. Když použijete režim Agent (Preview), Copilot automaticky zjistí a použije relevantní dovednosti na základě toho, co se ptáte.

Poznámka:

Režim agenta GitHub Copilot v SQL Server Management Studio (SSMS) je momentálně ve verzi Preview.

Na rozdíl od vlastních instrukcí, které nastavily obecné předvolby pro každou odpověď, poskytují dovednosti pokyny specifické pro konkrétní úkoly, které může každý agent objevit a používat. Stačí dovednost definovat jednou a bude se používat konzistentně ve všech relacích i v celém týmu.

Předpoklady

Jak fungují dovednosti agenta

Když používáte režim Agent, Copilot prohledává známá umístění dovedností ve vašem úložišti a uživatelském profilu. Pokud popis dovednosti odpovídá záměru vaší žádosti, Copilot aktivuje dovednost a použije její pokyny jako další kontext. Když je dovednost aktivní, její název se zobrazí v chatu, takže víte, že se používá.

Copilot rozhodne, které dovednosti se mají aktivovat na základě pole description v frontmatteru každé dovednosti. Jasný popis s klíčovými slovy pomáhá Copilot identifikovat, kdy je dovednost relevantní.

Místa pro dovednosti

Copilot objevuje dovednosti v následujících umístěních:

Scope Paths Podrobnosti
Pracovní prostor (sdílený s týmem) .github/skills/, .claude/skills/, .agents/skills/ Uložené v kořenovém adresáři úložiště. Zavázali se ke správě zdrojového kódu, aby všichni členové týmu získali stejné dovednosti.
Osobní (pouze váš profil) ~/.copilot/skills/, ~/.claude/skills/, ~/.agents/skills/ Platí pro všechny vaše projekty. Neschová se do žádného úložiště.

Dovednosti pracovního prostoru mají přednost před konvencemi specifickými pro projekty. Osobní dovednosti jsou užitečné pro pracovní postupy a předvolby, které s vámi cestují napříč projekty.

Vytvoření dovednosti

Dovednosti můžete vytvořit na panelu Dovedností v nástroji SSMS nebo ručně ve vašem systému souborů.

Vytvoření dovednosti na panelu Dovednosti

  1. V okně Copilot Chat vyberte ikonu Nástroje.
  2. Vyberte panel Dovednosti .
  3. Na panelu Dovednosti vyberte + tlačítko.
  4. Zvolte obor: dovednost pracovního prostoru (uložená v úložišti) nebo osobní dovednost (uložená ve vašem profilu uživatele).
  5. Zadejte název dovednosti. Název se stane názvem adresáře a musí používat jenom malá písmena, číslice a pomlčky.
  6. SSMS vygeneruje SKILL.md šablonu v novém adresáři dovedností. Upravte šablonu a přidejte do souboru pokyny.

Vytvoření dovednosti ručně

  1. Vytvořte adresář dovedností na příslušném místě. Pro dovednost pro pracovní prostor vytvořte .github/skills/ v kořenovém adresáři vašeho úložiště.
  2. Vytvořte podadresář pro svou dovednost. Každá dovednost musí mít svůj vlastní adresář. Například: .github/skills/tsql-style-guide/.
  3. Vytvořte SKILL.md soubor v adresáři dovedností.
  4. Volitelně můžete přidat podpůrné soubory, jako jsou skripty, referenční dokumenty nebo ukázkový výstup.

Struktura adresáře dovedností

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

formát SKILL.md

Každý soubor SKILL.md musí obsahovat YAML frontmatter následovaný pokyny v Markdownu. Frontmatter poskytuje metadata, která Copilot používá k nalezení a aktivaci dovednosti.

Vlastnosti frontmatteru

Property Povinné Description
name Yes Malá písmena, číslice a spojovníky. Musí odpovídat názvu nadřazeného adresáře. Maximálně 64 znaků.
description Yes Popisuje, co dovednost dělá a kdy ji používat. Maximálně 1 024 znaků. Uveďte konkrétní klíčová slova, která signalizují, když je dovednost relevantní.
license No Název licence nebo odkaz na licenční soubor, který je součástí dovednosti.
compatibility No Požadavky na prostředí, například zamýšlený produkt nebo požadované systémové funkce.
metadata No Libovolné páry klíč-hodnota pro jiná metadata.
allowed-tools No Mezerami oddělený seznam názvů nástrojů, které má dovednost předem schválené k použití.

Správa dovedností na panelu Dovednosti

Výběrem ikony Nástroje v okně Copilot Chat otevřete panel Skills. Panel zobrazuje všechny dovednosti, které Copilot zjistí pro vaše aktuální relace.

Na panelu můžete:

  • Úpravy: Přímo v editoru otevřete soubor SKILL.md libovolné dovednosti z nabídky ....
  • Otevřít umístění souboru: Přejděte na složku dovedností na disku.
  • Hledání: Filtrování dovedností podle názvu nebo klíčového slova

Panel také zobrazí diagnostiku všech chyb konfigurace dovedností, takže můžete rychle identifikovat a opravit problémy.

Tipy pro psaní efektivních dovedností

  • Udržujte SKILL.mdto stručné: Mířte na méně než 300 řádků. Přesuňte podrobný referenční materiál do samostatných souborů v příslušných podadresářích.
  • Napište popis s relevantními klíčovými slovy: Copilot používá description k rozhodnutí, kdy aktivovat dovednost. Uveďte konkrétní úkoly, objekty a scénáře, ve kterých se dovednost vztahuje.
  • Při postupech používejte číslované kroky: Pokyny krok za krokem se modelu řídí snáze než souvislý text.
  • Uveďte příklady očekávaného výstupu: Zobrazit vzorový kód, formáty tabulek nebo bloky komentářů, aby model věděl, jak vypadá "hotovo".
  • Nastavte jasné hranice: Řekněte dovednosti, co nemá dělat. Například: „Nedoporučujte odstraňovat indexy z tabulek s více než 10 miliony řádků bez předchozího uvedení objemu zápisů.“
  • Referenční podpůrný materiál: Ukládat související obsah a skripty v souborech v rámci references\, scripts\nebo examples\ a odkazovat na konkrétní obsah z dovednosti.

Příklady dovedností SQL

Následující příklady ukazují, jak psát dovednosti pro běžné SQL Server úkoly. Používejte je jako výchozí body a přizpůsobte je konvencím vašeho týmu.

Ověření indexu

Než doporučíte nové indexy, zkontrolujte existující indexy, abyste se vyhnuli duplikaci.

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

Analýza selhání úloh agenta

Analyzujte historii neúspěšných úloh agenta SQL a proveďte doporučení k vyřešení problému s kořenovým serverem.

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

Související obsah

  • Last updated on