Écrire une bonne compétence

Compétences, puis Créer une compétence. Quatre choses à remplir.

Ou demandez-le simplement dans une conversation. Décrivez la compétence que vous voulez (« note comment on met en forme nos études de cas : le titre, puis le problème en une phrase, puis les chiffres ») et Asteria en rédige le brouillon. Une carte vous montre les instructions rédigées, la description qui décide quand la compétence se déclenche, et si elle se chargera d'elle-même ou attendra un /, et rien n'est créé tant que vous n'avez pas approuvé cette carte. Vous obtenez une compétence ordinaire : ouvrez-la ensuite ici pour la modifier, la partager ou désactiver le chargement automatique.

Nom

Ce que c'est, en deux ou trois mots. Format étude de cas, Compte rendu de réunion, Réponses politique de frais.

C'est ce que vous voyez dans la liste du /, alors faites en sorte que ça se repère d'un coup d'œil.

Description

Deux cents caractères, et le champ le plus important de la page.

L'encadré demande « Quand votre assistant doit-il utiliser cette compétence ? » et il faut le prendre au pied de la lettre. Avec le Chargement automatique activé, c'est ce texte qu'Asteria lit pour décider si la compétence s'applique. C'est un déclencheur, pas un résumé.

Écrivez-la comme une condition, pas comme une description.

Faible, parce que ça décrit au lieu de déclencher :

Notre format maison pour les études de cas client.

Forte, parce que ça dit quand :

Mise en forme d'une étude de cas client ou d'un témoignage de réussite. Couvre l'ordre des sections, la longueur et la citation obligatoire. À charger avant de rédiger toute étude de cas.

Les compétences intégrées sont toutes écrites comme ça, et elles valent le coup d'être copiées. L'une d'elles dit :

Demandes de diagramme (organigramme, architecture, pipeline, machine à états). Utiliser create_diagram, pas generate_image. À charger avant toute demande du type « dessine / schématise / représente le flux ».

Regardez ce qu'elle fait : elle nomme les situations, liste les mots qu'un utilisateur taperait vraiment, et se termine par un « à charger avant X » explicite. Cette dernière phrase travaille beaucoup.

Si votre compétence ne se déclenche jamais, c'est presque toujours la description. Ajoutez le vocabulaire que vos collègues emploieraient, y compris les mots familiers.

Chargement automatique

Activé signifie qu'Asteria peut se saisir de la compétence toute seule. C'est le bon choix pour tout ce qui doit s'appliquer dès que la situation se présente, c'est-à-dire la plupart des compétences.

Désactivé signifie / uniquement. C'est le bon choix quand :

• La compétence est tranchée et ne doit s'appliquer que sur demande
• Elle vise un cas étroit que vous préférez trancher vous-même
• Elle contredit une autre compétence, et vous voulez choisir entre les deux

Instructions

La compétence elle-même, en Markdown, avec un onglet Modifier et un onglet Aperçu.

Écrivez-la comme une procédure destinée à quelqu'un de compétent qui n'a jamais fait cette tâche-là ici. Ce qui marche :

Soyez concret sur la forme. Numérotez les sections, dites la longueur de chacune, donnez l'ordre.

Donnez un exemple. Un court exemple traité vaut trois paragraphes de description.

Dites ce qu'il ne faut pas faire, surtout là où la solution évidente est la mauvaise. « Ne commencez pas par l'historique de l'entreprise cliente. Commencez par le problème. »

Dites quoi faire quand ça ne colle pas. « S'il n'y a pas de résultat mesurable, dites-le franchement plutôt que d'en inventer un vague, et signalez-le au rédacteur. »

Ce qui ne marche pas :

Rappeler les bonnes pratiques. « Sois clair et concis » est déjà acquis et gaspille la place.

En faire un pavé. Une compétence est chargée dans la conversation quand elle se déclenche, et une compétence tentaculaire prend la place de votre vraie question. Si la vôtre s'allonge, c'est probablement deux compétences.

Recopier les instructions d'un agent. Si elle ne s'applique jamais qu'à l'intérieur d'un seul agent, et que cet agent le dit déjà, la compétence est inutile.

La tester

Ouvrez une conversation et décrivez la situation sans nommer la compétence :

Rédige une étude de cas sur le déploiement chez Acme.

Si le Chargement automatique est activé et que la description est bonne, elle se déclenche. Sinon, il manque à la description les mots que vous venez d'employer.

Vérifiez-la ensuite avec / pour confirmer que les instructions produisent bien ce que vous vouliez. Deux tests distincts, parce qu'ils échouent pour des raisons différentes : une compétence qui se déclenche mais produit la mauvaise forme a un problème d'instructions, et une compétence qui ne se déclenche jamais a un problème de description.

Pensez à retirer la pastille ensuite, sinon elle reste active pour tout le reste de cette conversation.

Partager

La fenêtre de partage habituelle, ou Publier pour la mettre dans la marketplace de votre organisation, où chacun peut l'ajouter à sa bibliothèque.

Au moment de publier, vous pouvez autoriser ou interdire la duplication. Autorisez-la si vous préférez que les gens adaptent votre compétence plutôt que de repartir de zéro. Interdisez-la si tout l'intérêt est que tout le monde suive une seule version.

Dépublier retire la compétence de la marketplace et révoque l'entrée de bibliothèque de chacun : ce que les gens ont dupliqué leur reste, ce qu'ils avaient simplement ajouté disparaît.