Skills-Beschreibung
Die Skill-Beschreibung (description) ist der wichtigste Teil eines Skills. Sie bestimmt, ob der Agent korrekt erkennen kann, wann der Skill aktiviert werden sollte. In diesem Abschnitt erfahren Sie, wie Sie effektive Skill-Beschreibungen schreiben.
Warum Beschreibungen wichtig sind
Die Skill-Beschreibung spielt eine Schlüsselrolle beim Laden der Skills durch den Agenten:
- Während der Entdeckungsphase lädt der Agent nur den Namen und die Beschreibung jedes Skills
- Die Beschreibung ist die Hauptgrundlage für den Agenten, um zu entscheiden, ob der Skill aktiviert werden soll
- Eine gute Beschreibung kann die Aktivierungsgenauigkeit des Skills verbessern
Wenn die Beschreibung schlecht geschrieben ist, kann der Agent:
- Den Skill aktivieren, wenn er nicht benötigt wird (falsch positiv)
- Den Skill nicht aktivieren, wenn er benötigt wird (falsch negativ)
- Die falsche Fähigkeit aktivieren
Tipp: Die Qualität der Fähigkeitsbeschreibung wirkt sich direkt auf die Nutzbarkeit der Fähigkeit aus. Es lohnt sich, Zeit in die Optimierung der Beschreibung zu investieren.
Grundlegende Struktur der Beschreibung
Eine gute Fähigkeitsbeschreibung sollte zwei Teile enthalten:
- Funktionale Beschreibung: beschreibt, was die Fähigkeit tun kann
- Auslösebedingungen: erklärt, wann sie eingesetzt werden sollte
description: 从 PDF 文件中提取文本和表格,填写 PDF 表单,合并多个 PDF。处理 PDF 文档或用户提及 PDF、表单或文档提取时使用。 # ↑ 功能说明 ↑ 触发条件
Tipps für das Verfassen effektiver Beschreibungen
1. Spezifische Trigger-Schlüsselwörter einbeziehen
Fügen Sie in die Beschreibung spezifische Wörter und Formulierungen ein, die Benutzer möglicherweise verwenden. Diese Schlüsselwörter helfen dem Agenten, relevante Aufgaben zu identifizieren.
Gute Beschreibung:
description: 提取 PDF 文本和表格,填写表单,合并 PDF。使用场景:处理 PDF 文件、提取文档内容、填写 PDF 表单、合并多个 PDF、用户提及「PDF」「提取」「表单」「合并」等关键词。
2. Seien Sie konkret statt allgemein
Vermeiden Sie übermäßig breit gefasste Beschreibungen, da dies den Agenten daran hindert, genaue Beurteilungen vorzunehmen.
# 不好的描述 - 太笼统 description: 帮助处理各种文件。 # 好的描述 - 具体明确 description: 处理图像文件,包括调整大小、转换格式、应用滤镜。使用场景:处理图片、调整图像尺寸、转换图片格式。
3. Mehrere Anwendungsszenarien angeben
Listen Sie die verschiedenen Szenarien auf, auf die der Skill angewendet werden kann, damit der Agent genauer zuordnen kann.
description: 执行代码审查,检查安全漏洞、代码质量和性能问题。使用场景:代码审查、PR 审查、代码检查、安全扫描、质量评估、用户要求「review」「检查代码」「安全性」等。
4. Ähnliche Skills unterscheiden
Wenn Sie mehrere verwandte Skills haben, stellen Sie sicher, dass ihre Beschreibungen klar unterscheidbar sind.
# 技能 1:PDF 文本提取 name: pdf-extract description: 从 PDF 文件中提取文本内容和表格数据。使用场景:提取 PDF 文字、读取 PDF 内容、PDF 转文本、用户提及「PDF 提取」「读取 PDF」等。 # 技能 2:PDF 表单处理 name: pdf-form description: 填写 PDF 表单字段,提取表单数据。使用场景:填写 PDF 表单、填充表单字段、PDF 表单数据处理、用户提及「PDF 表单」「填写表单」等。
Steuerung der Beschreibungslänge
Die maximale Länge des Beschreibungsfelds beträgt 1024 Zeichen. Das ist aber nicht das Ziel; die Beschreibung sollte prägnant und genau sein.
| Fall | Empfohlene Länge |
|---|---|
| Einfacher Skill | 50-100 Zeichen |
| Skill mittlerer Komplexität | 100-200 Zeichen |
| Komplexe Fähigkeit | 200-400 Zeichen |
Hinweis: Eine längere Beschreibung ist nicht unbedingt besser. Eine übermäßig lange Beschreibung kann zu viele irrelevante Informationen enthalten und stattdessen das Urteilsvermögen des Agenten beeinträchtigen.
Die maximale Länge des Beschreibungsfelds beträgt 1024 Zeichen. Das ist aber nicht das Ziel; die Beschreibung sollte prägnant und genau sein.
Nachdem du eine Fähigkeit erstellt hast, solltest du testen, ob die Beschreibung die Fähigkeit korrekt auslösen kann. Im Folgenden findest du die Testschritte:
1. Grundlegende Funktionstests
Teste mit den in der Beschreibung enthaltenen Schlüsselwörtern, um zu bestätigen, dass die Fähigkeit aktiviert werden kann.
2. Edge-Case-Tests
Teste einige Szenarien, die die Fähigkeit auslösen könnten, sie aber nicht auslösen sollten.
3. Iterative Optimierung
Passe die Beschreibung basierend auf den Testergebnissen an:
- Wenn falsch-positive Ergebnisse zunehmen: Füge der Beschreibung mehr qualifizierende Bedingungen hinzu
- Wenn falsch-negative Ergebnisse zunehmen: Füge der Beschreibung mehr mögliche Auslösewörter hinzu
- Wenn der falsche Skill aktiviert wird: Stellen Sie sicher, dass die Beschreibung ausreichend von anderen ähnlichen Skills unterscheidbar ist
Optimierungsbeispiel:
# 初始版本 - 可能漏报 description: 提取 PDF 文本。 # 优化版本 - 减少漏报 description: 从 PDF 文件中提取文本内容和表格数据。使用场景:提取 PDF 文字、读取 PDF 内容、PDF 转文本。 # 最终版本 - 进一步优化 description: 从 PDF 文件中提取文本内容和表格数据。使用场景:提取 PDF 文字、读取 PDF 内容、PDF 转文本、用户提及「PDF 提取」「读取 PDF」「PDF 文字」「PDF 内容」等关键词时使用。
Häufige Probleme und Lösungen
Problem 1: Der Skill wird immer aktiviert
Das bedeutet, die Beschreibung ist zu allgemein. Die Lösung besteht darin, mehr qualifizierende Bedingungen und Anwendungsszenarien hinzuzufügen.
Lösung:
# 修改前 - 太宽泛 description: 处理文本。 # 修改后 - 更具体 description: 使用正则表达式处理和转换文本字符串。使用场景:文本匹配、字符串替换、模式提取、数据清洗。
Problem 2: Der Skill wird nie aktiviert
Das bedeutet, der Beschreibung fehlen Schlüsselwörter, die Benutzer verwenden könnten. Die Lösung besteht darin, mehr Triggerwörter hinzuzufügen.
Lösung:
# 修改前 - 关键词太少 description: 优化数据库查询。 # 修改后 - 添加更多触发词 description: 优化 SQL 查询性能,分析执行计划,添加索引。使用场景:SQL 优化、查询慢、数据库性能、调优索引、执行计划分析。
Problem 3: Der falsche Skill wird aktiviert
Das bedeutet, die Beschreibungen mehrerer Skills sind zu ähnlich. Die Lösung besteht darin, die Beschreibungen unverwechselbarer zu machen.
Weitere ErweiterungenTipp: Es ist eine gute Gewohnheit, Ihre Skill-Beschreibungen regelmäßig zu testen und zu optimieren. Wenn die Anwendungsszenarien zunehmen, stellen Sie möglicherweise fest, dass die Beschreibungen angepasst werden müssen.