Construire un agent

Agents dans la barre latérale, puis Créer un agent. Le constructeur est une longue page unique, avec un panneau Tester à côté, pour essayer l'agent pendant que vous le construisez.

Ou demandez-le simplement dans une conversation. Décrivez l'agent que vous voulez (« crée un agent qui consulte l'actualité tous les matins à 7 h et m'en écrit un résumé ») et Asteria en rédige le brouillon. Une carte vous montre le nom, les instructions, les outils et la planification avec sa prochaine exécution, et rien n'est créé tant que vous n'avez pas approuvé cette carte. Vous obtenez un agent ordinaire : vous pouvez ensuite l'ouvrir dans ce constructeur et le modifier comme n'importe quel autre.

La plupart des agents ont besoin de trois choses : un nom, des instructions, et éventuellement une collection. Tout le reste est là pour le jour où vous en aurez besoin.

Nom et description

Le Nom est ce que vous et vos collègues taperez après @ : gardez-le court et précis. Brand Voice Check vaut mieux que Assistant Marketing v2.

La Description dit ce qu'il fait. Vos collègues la voient sur la fiche de l'agent, alors écrivez-la pour eux plutôt que pour vous.

Sous le nom, vous verrez un identifiant du genre brand-voice-check-a1b2c. C'est l'identifiant permanent de l'agent, utilisé par l'API. Il ne change pas quand vous renommez l'agent.

Instructions

La zone la plus importante de la page, et celle dans laquelle les gens investissent le moins. Jusqu'à 5000 caractères.

Écrivez-la comme un brief destiné à un nouveau collègue compétent. Couvrez :

Qui il est et qui il sert. « Tu relis les textes marketing d'une fintech B2B qui vend à des directeurs financiers. »

À quoi ressemble le bon travail. « Assuré, simple, concret. Phrases courtes. Pas de superlatifs. »

Ce qu'il faut éviter, concrètement. « N'utilise jamais : révolutionnaire, fluide, disruptif, libérer. Ne promets jamais de résultats que nous ne pouvons pas prouver. »

Quoi faire en cas de doute. C'est celle que tout le monde oublie et elle vaut plus que toutes les autres. « Si l'affirmation est factuelle et que tu ne peux pas la vérifier depuis la collection, signale-la plutôt que de la réécrire. »

La forme de la réponse. « Réponds d'abord avec le texte corrigé, puis une courte liste de ce que tu as changé et pourquoi. »

Des instructions floues donnent des agents flous. « Sois utile et professionnel » ne lui apprend rien qu'il ne faisait déjà.

Outils

Ce que l'agent a le droit de faire. Ajouter un outil ouvre un catalogue regroupé par source :

Les capacités Intégrés, proposées par lots :

• Recherche Web : chercher sur internet et récupérer le contenu d'une URL
• Sandbox : exécuter du code, calculer sur des données, produire des graphiques et des fichiers
• Documents : créer et modifier documents, présentations et tableurs, avec historique des versions
• Diagrammes : dessiner et modifier des organigrammes et des schémas d'architecture

Les services connectés, si votre organisation les a activés et que vous avez lié votre compte : Gmail, Google Agenda, Drive, Docs, Sheets, Slides.

Certains outils en entraînent d'autres dont ils dépendent, et le catalogue vous le dit (« Active aussi… »). Un outil ajouté de cette façon est signalé, pour que vous sachiez pourquoi il est là.

Vous pouvez aussi remplacer la description d'un outil pour dire à cet agent quand l'utiliser. N'y touchez pas, sauf si un outil est employé au mauvais moment.

Connaissances

Deux mécanismes différents, et la différence compte.

Collections épinglées

Des collections que l'agent consulte toujours, sans que personne ait à les nommer. C'est là qu'est le gain : dans une conversation ordinaire, vous devez nommer la collection, alors qu'un agent avec des collections épinglées n'en a pas besoin.

Épinglez les collections dont le travail a toujours besoin. Pour un gros volume de documents, c'est le bon outil.

Fichiers importés

Des fichiers dont le contenu est placé directement dans le contexte de l'agent, à chaque tour. Ils ne sont pas cherchés : ils sont là.

Utilisez cela pour du matériel de référence court et toujours pertinent : une charte éditoriale d'une page, un glossaire, un arbre de décision. Un budget de jetons s'affiche au fur et à mesure que vous ajoutez des fichiers, et chacun est limité à 10 Mo.

La règle simple : une poignée de pages, épinglez-les en fichiers. Une pile de documents, mettez-les dans une collection. L'application vous le dit d'ailleurs quand vous approchez de la limite, parce que les fichiers consomment du contexte qui aurait pu servir à votre vraie question.

Compétences

Des procédures que l'agent peut charger quand elles sont pertinentes, plutôt que de les porter en permanence dans ses instructions. Voir Compétences.

Attachez celles que le travail de cet agent implique. Elles ne coûtent rien tant qu'elles ne servent pas.

Sous-agents

D'autres agents à qui celui-ci peut confier du travail, jusqu'à dix. Chacun reçoit une Indication de délégation qui dit au parent quand y recourir.

Délègue à Data Analyst quand la question exige des chiffres calculés à partir d'un tableur.

Il y a deux formes à connaître, et elles conviennent à des problèmes de tailles différentes.

Un agent qui délègue de temps en temps

Votre agent fait son travail et confie une étape spécialisée. L'agent de voix de marque qui passe une question de chiffres à un analyste.

Choisissez cela quand une tâche est essentiellement une seule chose, avec un détour occasionnel.

Un orchestrateur avec une équipe derrière lui

Pour une tâche vraiment complexe, construisez-la comme vous la doteriez en personnel. Plusieurs agents spécialistes, chacun étroit et bon à une seule chose, avec seulement les outils et les collections que cette chose exige. Puis un agent orchestrateur qui est votre point d'entrée dans la conversation, dont les instructions portent surtout sur quel spécialiste appeler et quand.

Pour un rapport mensuel sur la concurrence, cela pourrait donner :

• Market Researcher : recherche web uniquement. Trouve et résume ce que les concurrents ont publié.
• Data Analyst : le sandbox et la collection de métriques. Calcule nos chiffres.
• Report Writer : les outils documents et la collection de marque. Transforme les constats en livrable.
• Competitor Report (l'orchestrateur) : pas d'outils à lui, ou presque. Il connaît la séquence, appelle chaque spécialiste et assemble le résultat.

Vous ne parlez jamais qu'à l'orchestrateur.

Les raisons pour lesquelles cela vaut mieux qu'un seul gros agent :

Chaque spécialiste a un brief court et net. Un agent unique qui couvrirait les trois métiers aurait besoin d'instructions assez longues pour que les règles importantes commencent à s'y perdre.

Les outils restent cadrés. Le chercheur ne peut pas écrire de documents et le rédacteur ne peut pas naviguer sur le web : ni l'un ni l'autre ne s'égare dans un travail qui n'est pas le sien.

Vous pouvez corriger une partie sans toucher au reste. Un rédacteur qui produit une prose terne, c'est une modification dans un seul brief.

Les spécialistes sont réutilisables. Data Analyst peut servir sous trois orchestrateurs différents.

Le coût est réel : chaque passage de relais ajoute du temps et de l'argent, et une indication de délégation mal écrite fait que l'orchestrateur appelle le mauvais spécialiste ou fait le travail lui-même. Écrivez donc les indications comme des règles de décision, pas comme des descriptions :

Délègue à Market Researcher tout ce qui exige une information à jour venue de l'extérieur de l'entreprise. N'essaie pas de répondre de mémoire.

Délègue à Report Writer seulement une fois les constats arrêtés. Ne lui demande jamais de collecter quoi que ce soit.

Quand s'abstenir

La plupart des agents ne devraient pas avoir de sous-agents du tout. Un agent bien briefé bat un comité, et si vous ne pouvez pas dire en une phrase pourquoi une étape mérite son propre agent, c'est qu'elle ne le mérite pas.

Déclencheurs

Un planning, pour que l'agent tourne sans que personne ne surveille. Ajouter un déclencheur, puis choisissez une fréquence :

Tous les jours, Jours ouvrés, Chaque semaine, Chaque mois, ou Personnalisé (cron) pour tout le reste. Réglez l'heure et votre fuseau horaire.

Chaque déclencheur affiche sa dernière et sa prochaine exécution, et peut être désactivé sans être supprimé.

La sortie part dans la conversation Sortie du déclencheur de l'agent, accessible depuis la barre latérale. Elle est en lecture seule, mais vous pouvez sélectionner n'importe quel texte et le reprendre dans une conversation normale.

Modèle par défaut et température

Le Modèle par défaut s'applique aux exécutions planifiées. Laissez-le vide et c'est votre modèle par défaut qui sert.

La Température contrôle la variété des réponses, et elle est désactivée par défaut (elle hérite de votre préférence personnelle). Baissez-la pour tout ce qui est factuel et répétitif, montez-la pour du brainstorming. La plupart des agents n'en ont jamais besoin.

Questions suggérées

Des questions de démarrage affichées quand quelqu'un ouvre une conversation avec cet agent. Purement pour les humains, et particulièrement utiles sur un agent partagé : elles apprennent à un collègue à quoi sert l'agent, dans les deux secondes avant qu'il ne tape quelque chose de vague.

Statut et la zone dangereuse

Le Statut bascule l'agent en Actif ou Inactif. Inactif garde tout mais le retire de la circulation, ce qui est la façon réversible de mettre quelque chose à la retraite.

Supprimer l'agent est définitif.

Tester au fur et à mesure

Le panneau Tester, à droite, parle à l'agent avec sa configuration actuelle, y compris les modifications non enregistrées des instructions. Enregistrez d'abord, testez ensuite, puis ajustez.

Testez les cas pénibles, pas le cas facile. Donnez-lui quelque chose hors de son domaine et voyez s'il décline correctement. Donnez-lui quelque chose d'ambigu et voyez s'il demande ou s'il devine. C'est là qu'un brief faible se voit.

Utilisation

Une fois l'agent en service, sa section Utilisation montre à quelle fréquence il est invoqué, par combien de personnes, et quand il a servi pour la dernière fois. Pratique pour décider si un agent partagé a pris ou s'il est mort en silence.