Démarrage rapide

Afficher en Markdown

Ce guide vous accompagne dans la création d’un agent qui fait quelque chose de vraiment utile, plutôt qu’un gadget qui se contente de parler. À la fin, vous aurez un agent doté de sa propre identité, une connexion à un outil et un résultat concret à montrer.

Avant de commencer

Vérifiez que vous disposez de :

Un compte endue, avec une session ouverte sur le web.
Une dizaine de minutes.
Un compte sur un service avec lequel l’agent doit travailler : Gmail, Google Calendar, Slack, Notion ou n’importe quel autre. L’étape 3 en connecte un. Utilisez un compte dont les données peuvent servir à des essais sans que cela vous pose problème.

Créer votre premier agent

Créez l’agent.

Allez dans Agents et choisissez Nouvel agent. Donnez-lui un nom : l’identifiant qui servira ensuite à l’interpeller est généré automatiquement à partir de ce nom.

Décrivez en une phrase à quoi sert cet agent. Visez la précision : « Résume chaque matin mes e-mails non lus et signale ceux qui demandent une réponse » donne un bien meilleur agent que « assistant e-mail ».
Donnez-lui un prompt système.

Ouvrez l’agent et rédigez son prompt système : les instructions permanentes qu’il lit avant chaque conversation. Indiquez ce qu’il doit faire, ce qu’il ne doit jamais faire et à quoi ressemble un bon résultat.

endue conserve chaque version de ce prompt. Modifiez-le librement ; si un changement dégrade l’agent, revenez à la révision qui fonctionnait.
Connectez un outil.

Ouvrez Connecteurs dans Agent Builder et connectez le service avec lequel l’agent doit travailler : Gmail, Google Calendar, Slack, Notion ou tout autre service du catalogue complet.

Le fournisseur vous demandera alors de vous connecter et d’autoriser l’accès. endue ne reçoit que les autorisations affichées sur cet écran de consentement, et vous pouvez les révoquer à tout moment.

Associez ensuite la connexion à votre agent : c’est cet agent qui pourra l’utiliser, et non tous les agents de votre compte.

Les connexions sont liées à un compte précis chez le fournisseur. Si vous avez à la fois un compte Google professionnel et un compte personnel, vérifiez avec lequel vous vous connectez.
Confiez-lui une vraie tâche.

Ouvrez une conversation avec l’agent et donnez-lui une vraie tâche, pas un test : « Trouve tous les e-mails de cette semaine auxquels je n’ai pas répondu et résume ce que chacun demande. »

L’agent travaille dans une exécution : il décide quels outils appeler, les appelle, lit les résultats et continue jusqu’à obtenir une réponse. Vous pouvez suivre chaque étape en direct.
Guidez-le s’il fait fausse route.

Inutile d’attendre la fin d’une exécution mal engagée. Envoyez une correction pendant qu’il travaille encore : l’agent en tient compte à l’étape suivante.
Approuvez tout ce qui sort de votre compte.

Si l’agent tente d’envoyer un e-mail, de publier un message ou de supprimer quelque chose, il s’arrête et vous demande d’abord votre accord. Si vous approuvez, l’agent effectue exactement l’action que vous avez vue ; si vous refusez, il s’adapte.

Ce contrôle n’est pas facultatif et ne peut pas être désactivé pour les actions sortantes ou destructrices.
Retrouvez ce qu’il a produit.

Tout ce que l’agent rédige de substantiel (un rapport, un résumé, un document) devient un livrable, avec sa propre page dans Livrables. Par défaut, vos livrables sont privés. Partagez-en un par lien quand vous voulez qu’une personne extérieure le lise, sans lui donner accès à quoi que ce soit d’autre.

Rendre la tâche récurrente

L’agent que vous venez de créer travaille quand vous le lui demandez. L’essentiel de sa valeur apparaît quand il travaille sans vous.

Transformez la même tâche en routine planifiée : du lundi au vendredi à 8 h, chaque lundi, le premier du mois. La routine s’exécute qu’endue soit ouvert ou non, et ce qu’elle produit vous attend à votre retour. Si elle a besoin d’une décision, elle vous la demande, et la demande vous attend dans le tableau Activité.

Obtenir un meilleur agent

Ce qui distingue un agent utile d’un agent agaçant tient généralement à la façon dont vous le configurez, pas au modèle qu’il utilise. Une fois ces conseils essayés, Tester et itérer explique comment modifier un agent sans casser un agent qui fonctionne déjà.

Dire à quoi ressemble un bon résultat

L’agent choisit lui-même ses étapes. Ce qu’il ne peut pas deviner, c’est votre critère de « terminé ».

Au lieu de « résume mes e-mails », essayez « résume mes e-mails non lus ; regroupe-les par expéditeur ; pour chaque message qui me pose une question directe, cite la question mot pour mot pour que je puisse répondre sans l’ouvrir. »

Mettre les règles permanentes dans le prompt système, pas dans chaque message

Tout ce que vous répéteriez dans chaque conversation a sa place dans le prompt système : qui vous êtes, ce qui compte pour vous, ce que l’agent ne doit jamais faire, le format dans lequel vous voulez les résultats.

Les prompts sont versionnés, vous pouvez donc les faire évoluer sans risque : modifiez, voyez si l’agent s’améliore, revenez en arrière si ce n’est pas le cas.

Lui confier une seule mission

Un agent à la mission précise, doté de trois outils, fait mieux qu’un agent à la mission floue qui en a vingt. Créez un deuxième agent plutôt que d’élargir le premier.

Le corriger pendant qu'il travaille

Regarder une exécution partir dans la mauvaise direction et attendre qu’elle se termine, c’est gâcher toute l’exécution. Envoyez la correction dès que vous voyez le problème : l’agent en tient compte à l’étape suivante.

N'associer que les connexions nécessaires

Si les connexions s’associent agent par agent, ce n’est pas un hasard. Un agent qui n’a pas besoin de votre agenda ne devrait pas y avoir accès : cela réduit ce qui peut mal tourner et rend les choix de l’agent plus prévisibles.

Obtenir de l’aide

Rechercher dans la documentation — appuyez sur Ctrl/⌘ + K depuis n’importe quelle page.
Demander à votre agent — chaque page de ce site existe en Markdown, et l’ensemble du site est indexé dans /llms.txt. Indiquez-le à un agent et posez vos questions.
Nous écrire — [email protected].