Description des compétences
La description de la compétence (description) est la partie la plus importante d'une compétence. Elle détermine si l'agent peut identifier correctement quand la compétence doit être activée. Cette section vous apprendra à rédiger des descriptions de compétences efficaces.
Pourquoi les descriptions sont importantes
La description de la compétence joue un rôle clé dans le processus de chargement des compétences de l'agent :
- Pendant la phase de découverte, l'agent ne charge que le nom et la description de chaque compétence
- La description est le principal élément sur lequel l'agent se base pour décider d'activer ou non la compétence
- Une bonne description peut améliorer la précision d'activation de la compétence
Si la description est mal rédigée, l'agent peut :
- Activer la compétence alors qu'elle n'est pas nécessaire (faux positif)
- Ne pas activer la compétence alors qu'elle est nécessaire (faux négatif)
- Activer la mauvaise compétence
Conseil : la qualité de la description de la compétence affecte directement l'utilisabilité de la compétence. Cela vaut la peine de consacrer du temps à optimiser la description.
Structure de base de la description
Une bonne description de compétence doit comprendre deux parties :
- Description fonctionnelle: décrit ce que la compétence peut faire
- Conditions de déclenchement: explique quand l'utiliser
description: 从 PDF 文件中提取文本和表格,填写 PDF 表单,合并多个 PDF。处理 PDF 文档或用户提及 PDF、表单或文档提取时使用。 # ↑ 功能说明 ↑ 触发条件
Conseils pour rédiger des descriptions efficaces
1. Inclure des mots-clés de déclenchement spécifiques
Incluez dans la description des mots et expressions spécifiques que les utilisateurs sont susceptibles d'employer. Ces mots-clés aident l'agent à identifier les tâches pertinentes.
Bonne description :
description: 提取 PDF 文本和表格,填写表单,合并 PDF。使用场景:处理 PDF 文件、提取文档内容、填写 PDF 表单、合并多个 PDF、用户提及「PDF」「提取」「表单」「合并」等关键词。
2. Être spécifique plutôt que général
Évitez les descriptions trop larges, car cela empêcherait l'agent de porter des jugements précis.
# 不好的描述 - 太笼统 description: 帮助处理各种文件。 # 好的描述 - 具体明确 description: 处理图像文件,包括调整大小、转换格式、应用滤镜。使用场景:处理图片、调整图像尺寸、转换图片格式。
3. Spécifiez plusieurs scénarios d'utilisation
Listez les différents scénarios auxquels la compétence peut s'appliquer, ce qui aide l'agent à établir des correspondances plus précises.
description: 执行代码审查,检查安全漏洞、代码质量和性能问题。使用场景:代码审查、PR 审查、代码检查、安全扫描、质量评估、用户要求「review」「检查代码」「安全性」等。
4. Distinguez des compétences similaires
Si vous avez plusieurs compétences associées, assurez-vous que leurs descriptions sont clairement distinguables.
# 技能 1:PDF 文本提取 name: pdf-extract description: 从 PDF 文件中提取文本内容和表格数据。使用场景:提取 PDF 文字、读取 PDF 内容、PDF 转文本、用户提及「PDF 提取」「读取 PDF」等。 # 技能 2:PDF 表单处理 name: pdf-form description: 填写 PDF 表单字段,提取表单数据。使用场景:填写 PDF 表单、填充表单字段、PDF 表单数据处理、用户提及「PDF 表单」「填写表单」等。
Contrôle de la longueur de la description
La longueur maximale du champ description est de 1024 caractères. Mais ce n'est pas l'objectif ; la description doit être concise et précise.
| Cas | Longueur recommandée |
|---|---|
| Compétence simple | 50-100 caractères |
| Compétence de complexité moyenne | 100-200 caractères |
| Compétence complexe | 200-400 caractères |
Remarque : Une description plus longue n'est pas nécessairement meilleure. Une description trop longue peut contenir trop d'informations non pertinentes et nuire au jugement de l'agent.
La longueur maximale du champ description est de 1024 caractères. Mais ce n'est pas l'objectif ; la description doit être concise et précise.
Après avoir créé une compétence, vous devez tester si la description peut correctement déclencher la compétence. Voici les étapes de test :
1. Test fonctionnel de base
Testez avec les mots-clés inclus dans la description pour confirmer que la compétence peut être activée.
2. Test des cas limites
Testez quelques scénarios qui pourraient déclencher la compétence mais ne devraient pas la déclencher.
3. Optimisation itérative
Ajustez la description en fonction des résultats des tests :
- Si les faux positifs augmentent : ajoutez plus de conditions de qualification à la description
- Si les faux négatifs augmentent : ajoutez plus de mots déclencheurs possibles à la description
- Si la mauvaise compétence est activée : assurez-vous que la description est suffisamment distincte des autres compétences similaires
Exemple d'optimisation :
# 初始版本 - 可能漏报 description: 提取 PDF 文本。 # 优化版本 - 减少漏报 description: 从 PDF 文件中提取文本内容和表格数据。使用场景:提取 PDF 文字、读取 PDF 内容、PDF 转文本。 # 最终版本 - 进一步优化 description: 从 PDF 文件中提取文本内容和表格数据。使用场景:提取 PDF 文字、读取 PDF 内容、PDF 转文本、用户提及「PDF 提取」「读取 PDF」「PDF 文字」「PDF 内容」等关键词时使用。
Problèmes courants et solutions
Problème 1 : La compétence est toujours activée
Cela signifie que la description est trop générale. La solution consiste à ajouter davantage de conditions de qualification et de scénarios d'utilisation.
Solution :
# 修改前 - 太宽泛 description: 处理文本。 # 修改后 - 更具体 description: 使用正则表达式处理和转换文本字符串。使用场景:文本匹配、字符串替换、模式提取、数据清洗。
Problème 2 : La compétence n'est jamais activée
Cela signifie que la description manque de mots-clés que les utilisateurs peuvent utiliser. La solution consiste à ajouter davantage de mots déclencheurs.
Solution :
# 修改前 - 关键词太少 description: 优化数据库查询。 # 修改后 - 添加更多触发词 description: 优化 SQL 查询性能,分析执行计划,添加索引。使用场景:SQL 优化、查询慢、数据库性能、调优索引、执行计划分析。
Problème 3 : La mauvaise compétence est activée
Cela signifie que les descriptions de plusieurs compétences sont trop similaires. La solution consiste à rendre les descriptions plus distinctes.
Autres extensionsAstuce : Il est bon de tester et d'optimiser régulièrement les descriptions de vos compétences. À mesure que les scénarios d'utilisation augmentent, vous constaterez peut-être que les descriptions nécessitent des ajustements.