Verwenden von Agentenkenntnissen mit GitHub Copilot in SQL Server Management Studio

Agentenkenntnisse sind wiederverwendbare Sätze von Anweisungen, die GitHub Copilot die Ausführung bestimmter Aufgaben anweisen. Jede Fähigkeit ist eine Markdown-Datei, die Sie einmal definieren, wodurch Sie Zeit sparen und ein konsistentes Verhalten in Ihrem gesamten Workflow sicherstellen. Betrachten Sie Fähigkeiten wie ein Runbook, nicht als einen einzigen großen Prompt. Wenn Sie Agent-Modus (Vorschau) verwenden, erkennt Copilot automatisch relevante Fähigkeiten basierend auf dem, was Sie fragen.

Im Gegensatz zu benutzerdefinierten Anweisungen, die allgemeine Einstellungen für jede Antwort festlegen, bieten Fähigkeiten gezielte aufgabenspezifische Anleitungen, die jeder Agent entdecken und verwenden kann. Definieren Sie einmal eine Fähigkeit, und sie gilt für alle Sitzungen und für Ihr Team einheitlich.

Voraussetzungen

• SSMS 22.7 oder eine höhere Version mit der AI Assistance Workload.
• Ein GitHub Konto mit Copilot Zugriff. Alternativ GitHub Copilot kostenlos in SQL Server Management Studio verwenden.

So funktionieren Agentenfähigkeiten

Wenn Sie den Agent-Modus verwenden, überprüft Copilot die bekannten Qualifikationsstandorte für Ihr Repository und Ihr Benutzerprofil. Wenn die Beschreibung einer Qualifikation mit der Absicht Ihrer Anforderung übereinstimmt, aktiviert Copilot die Fähigkeit und wendet ihre Anweisungen als zusätzlichen Kontext an. Wenn eine Fähigkeit aktiv ist, wird ihr Name im Chat angezeigt, damit Sie wissen, dass sie angewendet wird.

Copilot entscheidet, welche Fähigkeiten basierend auf dem Feld description im Frontmatter der einzelnen Fähigkeiten aktiviert werden sollen. Eine klare, schlüsselwortreiche Beschreibung hilft Copilot zu identifizieren, wann eine Fähigkeit relevant ist.

Qualifikationsstandorte

Copilot findet Kompetenzen an den folgenden Orten:

Arbeitsbereichskenntnisse haben Vorrang für projektspezifische Konventionen. Persönliche Fähigkeiten sind nützlich für Workflows und Vorlieben, die mit Ihnen über Projekte hinweg reisen.

Erstellen einer Fähigkeit

Sie können eine Fähigkeit aus dem Bereich "Fähigkeiten " in SSMS oder manuell in Ihrem Dateisystem erstellen.

Eine Skill im Bereich „Skills“ erstellen

1. Wählen Sie im fenster Copilot Chat das Symbol Tools aus.
2. Wählen Sie den Bereich "Fähigkeiten " aus.
3. Wählen Sie im Bereich "Fähigkeiten" die + Schaltfläche aus.
4. Wählen Sie den Bereich aus: eine Arbeitsbereichskompetenz (gespeichert im Repository) oder eine persönliche Fähigkeit (gespeichert in Ihrem Benutzerprofil).
5. Geben Sie einen Namen für die Fähigkeit ein. Der Name wird zum Verzeichnisnamen und darf nur Kleinbuchstaben, Zahlen und Bindestriche verwenden.
6. SSMS generiert eine SKILL.md Vorlage im neuen Qualifikationsverzeichnis. Bearbeiten Sie die Vorlage, und fügen Sie der Datei Ihre Anweisungen hinzu.

Manuelles Erstellen einer Fähigkeit

1. Erstellen Sie ein Fähigkeitenverzeichnis am geeigneten Speicherort. Erstellen Sie für einen Workspace-Skill .github/skills/ im Stammverzeichnis Ihres Repositorys.
2. Erstellen Sie ein Unterverzeichnis für Ihre Fähigkeiten. Jede Fähigkeit muss über ein eigenes Verzeichnis verfügen. Beispiel: .github/skills/tsql-style-guide/.
3. Erstellen Sie eine SKILL.md-Datei im Skill-Verzeichnis.
4. Fügen Sie optional unterstützende Dateien wie Skripts, Referenzdokumente oder Beispielausgabe hinzu.

Kompetenzverzeichnisstruktur

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

SKILL.md Format

Jede SKILL.md Datei muss YAML-Frontmatter enthalten, gefolgt von Markdown-Anweisungen. Das Frontmatter stellt die Metadaten bereit, die Copilot verwendet, um den Skill zu erkennen und zu aktivieren.

Frontmatter-Eigenschaften

Verwalten Sie Fähigkeiten im Bereich „Fähigkeiten“

Wählen Sie im fenster Copilot Chat das Symbol Tools aus, um den Bereich Skills zu öffnen. Im Panel werden alle Fähigkeiten angezeigt, die Copilot für Ihre aktuelle Sitzung entdeckt.

Folgende Optionen stehen Ihnen im Bereich zur Verfügung:

• Bearbeiten: Öffnen Sie die Datei einer beliebigen Fähigkeit SKILL.md direkt im Editor über das ... Menü.
• Dateispeicherort öffnen: Wechseln Sie zum Verzeichnis der Fähigkeiten auf dem Datenträger.
• Suche: Filtern sie Fähigkeiten nach Name oder Schlüsselwort.

Das Panel zeigt auch diagnosen für alle Fähigkeitskonfigurationsfehler an, sodass Sie Probleme schnell erkennen und beheben können.

Tipps zum Schreiben effektiver Fähigkeiten

• Kurz haltenSKILL.md: Ziel unter 300 Zeilen. Verschieben Sie detailliertes Referenzmaterial in separate Dateien in den entsprechenden Unterverzeichnissen.
• Verfassen Sie eine stichwortreiche Beschreibung: Copilot verwendet die description, um zu entscheiden, wann die Funktion aktiviert werden soll. Fügen Sie die spezifischen Aufgaben, Objekte und Szenarien ein, in denen die Fähigkeit gilt.
• Verwenden Sie nummerierte Schritte für Verfahren: Schritt-für-Schritt-Anleitungen sind für das Modell einfacher zu befolgen als Prose.
• Fügen Sie Beispiele für die erwartete Ausgabe ein: Zeigen Sie Beispielcode, Tabellenformate oder Kommentarblöcke, damit das Modell weiß, wie das Endergebnis aussehen soll.
• Legen Sie explizite Grenzen fest: Sagen Sie den Fähigkeiten, was nicht zu tun ist. Beispiel: „Empfehlen Sie nicht, Indizes in Tabellen mit mehr als 10 Millionen Zeilen zu entfernen, ohne zuvor das Schreibvolumen anzugeben.“
• Referenzmaterial: Speichern Sie zugehörige Inhalte und Skripte in Dateien innerhalb von references\, scripts\ oder examples\ und verweisen Sie aus der Skill heraus auf bestimmte Inhalte.

Beispiel für SQL-Fähigkeiten

Die folgenden Beispiele veranschaulichen, wie Sie Fähigkeiten für allgemeine SQL Server Aufgaben schreiben. Verwenden Sie sie als Ausgangspunkte, und passen Sie sie an die Konventionen Ihres Teams an.

Indexüberprüfung

Überprüfen Sie vorhandene Indizes, bevor Sie neue empfehlen, Duplizierungen zu vermeiden.

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

Analyse von Agent-Job-Fehlern

Analysieren Sie den Verlauf fehlgeschlagener SQL-Agent-Aufträge, und nehmen Sie Empfehlungen vor, um das Stammproblem zu beheben.

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

Verwandte Inhalte

• Use GitHub Copilot Agent Mode (Vorschau) in SQL Server Management Studio
• Verwenden Sie MCP-Server mit GitHub Copilot in SQL Server Management Studio
• Verwenden Sie benutzerdefinierte Anweisungen mit GitHub Copilot in SQL Server Management Studio
• Fehlerbehebung von GitHub Copilot in SQL Server Management Studio