Asteria Docs
Agents

Tutoriel : votre premier agent

Construisez un agent qui marche, de bout en bout, en une vingtaine de minutes, à partir d'un travail que vous avez vraiment.

Nous allons construire Brand Voice Check, un agent qui relit vos textes à l'aune de votre charte éditoriale. Remplacez le sujet par le vôtre au fil de la lecture : la forme convient à la plupart des travaux.

À la fin, vous aurez un agent que vous pourrez appeler avec @, et que vous pourriez partager avec votre équipe.

Avant de commencer

Ayez sous la main un document qui décrit la façon d'écrire de votre organisation : une charte éditoriale, une page sur le ton de voix, ou même un bon exemple de texte dont vous étiez content. Une seule page suffit.

Mettez la référence là où l'agent peut l'atteindre

Si c'est une ou deux pages, vous l'attacherez directement à l'agent plus tard. Rien à faire pour l'instant.

Si c'est une vraie pile (une charte éditoriale, plus des campagnes passées, plus les messages produit), créez d'abord une collection et mettez-les dedans. Appelez-la Brand Guidelines.

Créez l'agent

Agents dans la barre latérale, puis Créer un agent.

Nom : Brand Voice Check

Description : Relit les textes à l'aune de notre ton de voix et signale tout ce qui sort de la marque.

Écrivez les instructions

C'est la partie qui vaut douze de vos vingt minutes. À adapter :

Tu relis les textes écrits à l'aune de notre voix de marque, pour une
fintech B2B qui vend à des directeurs financiers d'entreprises de
taille moyenne.

Comment nous écrivons :
- Assuré et simple. Phrases courtes. Noms concrets.
- Nous expliquons, nous ne vendons pas. Pas de superlatifs.
- Français de France.

N'utilise jamais : révolutionnaire, fluide, disruptif, libérer,
incontournable, sans effort.

Quand tu relis un texte :
1. Donne d'abord la version corrigée, prête à coller.
2. Puis liste ce que tu as changé et pourquoi, une ligne chacun.
3. Puis signale à part tout ce qui est une affirmation factuelle
   que nous devrions pouvoir prouver. Ne les réécris pas.
   Pose la question.

Si le texte est déjà dans la marque, dis-le franchement plutôt que
d'inventer des changements pour te justifier.

Si tu n'es pas sûr qu'une règle soit enfreinte, dis que tu n'es pas
sûr et explique la tension. Ne tranche pas en silence.

Les deux derniers paragraphes sont ceux qui le rendent utile. Sans eux, un agent trouvera toujours quelque chose à changer, parce qu'il croit que c'est ce que vous lui avez demandé.

Donnez-lui la référence

Descendez jusqu'à Connaissances.

Une collection : sous Collections épinglées, épinglez Brand Guidelines. L'agent la consulte désormais automatiquement, sans que personne la nomme.

Une page ou deux : sous Fichiers importés, importez la charte éditoriale. Son contenu est sous les yeux de l'agent à chaque tour.

Ne faites pas les deux avec le même document. Choisissez celui qui correspond à la taille.

Décidez pour les outils

Pour cet agent, probablement aucun. Il lit des textes et donne un avis.

Résistez à l'envie d'ajouter la recherche web « au cas où ». Un outil dont le travail n'a pas besoin est un moyen pour l'agent de partir ailleurs, et il ralentit toutes les réponses.

Ajoutez des questions suggérées

Sous Questions suggérées, ajoutez-en deux ou trois :

  • Relis le titre et le sous-titre de cette page d'accueil.
  • Cet e-mail est-il trop commercial ?
  • Réécris ce paragraphe dans notre voix.

Sautez cette étape et un collègue qui ouvre votre agent devra deviner.

Enregistrez, puis testez sérieusement

Valider pour enregistrer. Utilisez maintenant le panneau Tester à droite, et ne testez pas le cas facile.

Donnez-lui un texte déjà correct. Le dit-il, ou invente-t-il des modifications ? S'il invente, renforcez cette instruction.

Donnez-lui un texte avec une affirmation factuelle. « Notre plateforme réduit le temps de rapprochement de 90 %. » Signale-t-il l'affirmation au lieu de la polir ?

Donnez-lui quelque chose hors sujet. « Écris-moi un plan de projet. » Décline-t-il correctement ?

Ajustez les instructions et retestez. Deux ou trois tours, c'est normal, et cette boucle est le vrai travail de construction d'un agent.

Utilisez-le

De retour dans la conversation, tapez @ et choisissez Brand Voice Check, ou cliquez dessus dans la barre latérale sous Mes agents. Mettez-lui une étoile pour l'épingler en haut.

L'améliorer sur les deux semaines qui suivent

Un agent n'est pas terminé quand vous l'enregistrez. La boucle utile :

Quand il se trompe, corrigez les instructions, pas le message. Reformuler votre demande répare une conversation. Modifier le brief répare toutes les suivantes.

Ajoutez les exceptions au fur et à mesure que vous les rencontrez. La première fois qu'il signale quelque chose qu'il n'aurait pas dû, ajoutez une ligne qui le dit.

Restez court. Des instructions qui s'étalent sur 4000 caractères de cas particuliers deviennent moins bonnes, pas meilleures : les règles importantes s'y noient. Si cela s'allonge, c'est peut-être que le travail fait deux agents, ou que les détails relèvent d'une compétence.

Quand vous êtes prêt à le partager

Donnez-le d'abord à un ou deux collègues et regardez ce qu'ils tapent. Ils demanderont des choses que vous n'auriez jamais demandées, et c'est le retour le moins cher qui existe. Voyez ensuite Partage et marketplace.

La suite

  • Compétences pour les procédures que vous voulez dans n'importe quelle conversation, pas seulement celle de cet agent.
  • Déclencheurs pour exécuter un agent selon un planning.
  • Workflows pour les travaux en plusieurs étapes qui tournent sans vous.

On this page