/agents), juste au-dessus de Flux de travail. Le titre de la page est
Agents. La palette de commandes (⌘ K) permet aussi d’y accéder.
Qu’est-ce qu’un agent ?
Un agent réunit cinq éléments, tous enregistrés ensemble sous forme de révision :
Un agent lit ses propres fichiers rattachés pour toute personne qui l’exécute et, pour le reste, uniquement ce que le membre au nom duquel il s’exécute peut voir. Il n’effectue que les actions sélectionnées pour lui. Hive considère la persona et le texte de la tâche comme non fiables : aucune instruction de l’agent ne peut donc élargir ses autorisations ni ajouter une action.
Joindre des fichiers comme connaissances
À l’étape 2 de l’éditeur d’agent, Connaissances et outils, la ligne Fichiers répertorie les fichiers de la Bibliothèque que l’agent lit (voir Organisation de l’éditeur). Pour en ajouter un :- Sélectionnez + Ajouter des fichiers et choisissez des fichiers déjà présents dans votre Bibliothèque, ou ouvrez Importer des fichiers dans le même sélecteur pour en importer de nouveaux.
- Ouvrez Google Drive, OneDrive ou SharePoint dans le même sélecteur pour ajouter un fichier depuis votre propre compte connecté : recherchez vos fichiers Drive et OneDrive par nom, en commençant par ceux qui ont été modifiés le plus récemment, ou parcourez un site SharePoint, ses bibliothèques de documents et leurs dossiers. Voir Fichiers provenant de Google Drive, OneDrive et SharePoint.
- Faites glisser des fichiers depuis votre ordinateur sur la ligne Fichiers ou sur la zone de saisie Concevoir. Un cadre en pointillés Déposez des fichiers pour les ajouter à cet agent indique où ils seront déposés.
Fichiers provenant de Google Drive, OneDrive et SharePoint
Un fichier que vous ajoutez depuis Google Drive, OneDrive ou SharePoint est copié dans votre Bibliothèque, puis joint comme un fichier importé (Joint · Enregistrer pour conserver). L’agent lit la copie, jamais le fichier d’origine : une exécution n’attend donc jamais l’original et n’échoue pas à cause de lui. Vous devez disposer du rôle Opérateur ou d’un rôle supérieur, et il doit s’agir d’un compte que vous avez vous-même connecté dans Intégrations ; si aucun compte n’est connecté, le sélecteur l’indique. Dans la ligne Fichiers, une copie indique sa provenance et la date de la dernière vérification par Hive, par exemple Copié depuis Google Drive · vérifié il y a 2 h. Seule la personne qui l’a ajoutée peut l’actualiser :- Sélectionnez Actualiser sur le fichier pour vérifier l’original immédiatement.
- Lorsque vous ouvrez l’agent dans Agent Studio, Hive vérifie vos copies dont la dernière vérification remonte à plus d’une heure.
- Lorsque vous déployez l’agent, Hive vérifie à nouveau vos copies.
Qui peut lire les fichiers d’un agent
Les fichiers et dossiers joints à un agent font partie de celui-ci. Lorsque vous le partagez, toutes les personnes qui peuvent l’exécuter ont accès à ces fichiers lorsqu’elles l’exécutent sur sa page d’exécution, dans Ask et dans Continuer dans la conversation, même aux fichiers que vous seul pouvez ouvrir dans la Bibliothèque :- Lors de ses exécutions. L’agent lit ses fichiers joints sur sa page d’exécution, dans une conversation Ask où quelqu’un le sélectionne et dans Continuer dans la conversation. Hive les lit avec les droits d’accès à la Bibliothèque de la personne qui a enregistré la dernière version de l’agent.
- Images. Lorsque le modèle de l’agent lit les images (modèle de vision), une image JPEG, PNG, GIF ou WebP jointe lui est transmise en tant qu’image sur sa page d’exécution, dans Ask et dans Tester dans l’éditeur. Un modèle qui ne lit pas les images reçoit à la place la description de l’image fournie par Hive (voir Comment Hive lit les fichiers que vous choisissez).
- Dans ses conversations. La personne qui exécute l’agent peut ouvrir un fichier utilisé par l’agent depuis cette conversation, en lecture seule : sélectionnez le nom du fichier sous Sources. Un PDF ou une image s’ouvre dans un nouvel onglet ; tout autre fichier est téléchargé.
- Nulle part ailleurs. Les fichiers ne sont pas ajoutés à la Bibliothèque de la personne qui exécute l’agent, à sa recherche ni à Drive, et cette personne ne peut les ouvrir nulle part en dehors d’une conversation avec l’agent. L’ouverture de l’original dans Google Drive, OneDrive ou SharePoint n’est possible que si le service concerné l’y autorise.
- Retirer un fichier de l’agent et enregistrer ce dernier met immédiatement fin à cet accès : les nouvelles exécutions ne le lisent plus, il ne s’ouvre plus depuis les conversations de l’agent, et les réponses antérieures de ses conversations qui l’utilisaient sont masquées. Le résultat propre à une exécution reste visible sur sa page d’exécution pour la personne qui l’a lancée.
- Si la personne qui a enregistré la dernière version de l’agent quitte l’espace de travail ou ne peut plus ouvrir elle-même l’un de ses fichiers, les fichiers de l’agent ne sont lus que pour les personnes qui peuvent les ouvrir dans leur propre Bibliothèque, jusqu’à ce qu’une personne pouvant tous les ouvrir enregistre à nouveau l’agent.
- Une personne à qui votre espace de travail interdit l’accès à la Bibliothèque ne peut pas utiliser les fichiers d’un agent, comme auparavant. Un client IA connecté au serveur MCP de Hive ne peut ni exécuter des agents ni ouvrir leurs conversations ; il ne lit donc jamais les fichiers d’un agent de cette manière.
Où les agents s’exécutent
Tout agent déployé est disponible dans Ask, sur sa propre page d’exécution et dans les flux de travail. Vous ne choisissez pas où il apparaît. Le lien public est distinct : vous l’activez depuis Lien public dans l’éditeur.Ask Hive
Choisissez l’agent dans le sélecteur d’agents de la zone de saisie d’Ask, à la place de Hive, sélectionné par défaut.
Sa propre page d’exécution
Remplissez le formulaire de l’agent, exécutez-le, lisez la réponse et consultez ses exécutions passées.
Planifications
Exécutez l’agent de manière récurrente avec un prompt et un fuseau horaire fixes.
Flux de travail
Ajoutez un agent déployé à un flux de travail depuis la Bibliothèque d’agents du concepteur.
Liens publics
Partagez un agent en dehors de l’espace de travail, si cette option y est activée.
Ce qu’un agent peut utiliser selon son contexte d’exécution
Les compétences obligatoires de votre espace de travail s’ajoutent aux
instructions de l’agent dans chacun de ces contextes, sauf pour un lien public.
Utiliser un agent dans les flux de travail
Déployez l’agent. Ses révisions déployées apparaissent alors dans la Bibliothèque d’agents du concepteur de flux de travail, sous Agents dans le menu Ajouter une étape et dans le volet Ajouter une étape. Une étape de flux de travail reste liée à la révision avec laquelle elle a été ajoutée ; lorsque vous en déployez une plus récente, l’étape propose Mettre à jour vers la révision N. Une étape de flux de travail ne lit que les fichiers et dossiers de la Bibliothèque ou les liens Google Docs comme connaissances et sources d’exécution. La Bibliothèque d’agents grise donc tout agent ayant d’autres connaissances, des compétences, des sous-agents ou une opération de connecteur qui écrit des données, ou encore d’autres sources, et indique ce qu’il faut modifier. L’accès au Web, les Données propres à la personne (données Hive comprises) et les applications connectées en lecture seule fonctionnent dans une étape : voir Web, données Hive et applications connectées. Ses actions sélectionnées s’exécutent dans l’étape. Un agent créé avant l’existence des étapes de flux de travail doit être recréé à partir d’un modèle réutilisable. Voir Étapes de la Bibliothèque d’agents.Exécuter un agent directement
Chaque agent déployé dispose de sa propre page d’exécution à l’adresse/agents/<agent id>/run. Ouvrez-la avec Exécuter dans
le menu ⋯ de la carte de l’agent, ou avec Exécuter cet agent et voir ses exécutions dans le volet Tester
de l’éditeur. Vous pouvez l’utiliser si vous avez le rôle opérateur ou supérieur et un droit d’exécution sur l’agent : vous n’avez pas besoin
de pouvoir modifier l’agent, et la page n’affiche jamais ses versions brouillon.
La page affiche le nom et la description de l’agent, puis son formulaire :
- Champs : les entrées demandées par l’agent.
- Sources : les fichiers et dossiers de la Bibliothèque, ou d’autres sources, que l’agent lit pour cette exécution. Lorsqu’une source accepte des fichiers de la Bibliothèque, vous pouvez ajouter un fichier qui n’y figure pas encore avec Importer dans la Bibliothèque dans son sélecteur ; Hive le sélectionne pour vous une fois importé. Vous devez avoir le rôle opérateur ou supérieur. Chaque fichier peut peser jusqu’à 25 Mo et doit être d’un type accepté par la Bibliothèque. Il est placé à la racine de votre Bibliothèque et respecte les règles de partage de la Bibliothèque, comme tout autre fichier importé.
- Comptes : les comptes connectés que l’agent utilise lorsqu’il travaille avec des applications connectées.
- Instructions d’exécution (facultatif) : une note pour cette exécution.
- Questions suggérées : les questions suggérées de l’agent, affichées sous Instructions d’exécution (facultatif). Sélectionnez-en une pour l’insérer dans les instructions d’exécution ; cela ne lance pas l’exécution.
Fichiers qu’une exécution écrit dans votre Bibliothèque
Un agent doté d’un modèle de fichier Word ou Excel peut écrire le document ou le classeur prévu, comme une lettre de mission ou une proposition, sous forme de nouveau fichier dans votre Bibliothèque lorsque vous le lancez vous-même depuis sa page d’exécution :- Votre fichier. Le fichier vous appartient et est écrit en votre nom : à la racine de votre Bibliothèque ou dans l’un des dossiers associés à l’agent, à condition que ce dossier vous soit privé et que vous puissiez y ajouter des fichiers. Un dossier partagé avec une autre personne ou un dossier de la Base de connaissances n’est jamais utilisé, afin que ce que l’agent a lu pour vous ne se retrouve jamais à un endroit où l’auteur de l’agent ou un collègue pourrait l’ouvrir.
- Sur le modèle de l’agent. Un fichier Word est créé à partir du modèle Word de l’agent, et un classeur à partir de son modèle Excel, si vous pouvez ouvrir ce modèle. Un modèle privé n’est utilisé que pour un fichier qui reste privé pour vous ; sinon, le fichier reprend la mise en forme propre à votre espace de travail. Avec l’un des modèles de démarrage de Hive, l’en-tête et le pied de page affichent le nom de votre cabinet à la place de « [Nom de l’entreprise] » et « [Nom du cabinet] » : le nom figurant sur la fiche de votre cabinet ou, à défaut, celui de votre espace de travail. Si Hive ne connaît aucun des deux, les espaces réservés restent dans le fichier pour que vous les remplissiez.
- Uniquement de nouveaux fichiers. Une exécution ne modifie, ne remplace, ne déplace ni ne supprime jamais un fichier déjà présent dans votre Bibliothèque. Elle écrit au maximum trois fichiers, chacun étant un brouillon à vérifier.
- Dans le résultat. Chaque fichier figure sous Artefacts dans le résultat de l’exécution, avec l’option Ouvrir, qui l’ouvre dans votre Bibliothèque ; la réponse contient également un lien vers ce fichier.
- Traçabilité. Chaque fichier écrit par une exécution est consigné dans le journal d’audit sous « Une exécution d’agent a créé un fichier dans la Bibliothèque », avec l’agent, l’exécution et le fichier.
Historique des exécutions
Sous le formulaire, Historique des exécutions répertorie les exécutions de l’agent, de la plus récente à la plus ancienne :- Vous voyez vos propres exécutions. Les administrateurs de l’espace de travail voient les exécutions de tous les membres et peuvent filtrer par personne.
- Chaque exécution indique qui l’a lancée : Vous pour vos propres exécutions, le nom du membre pour celles d’une autre personne, ou Membre de l’espace de travail pour une personne qui n’en fait plus partie. La liste Exécutions récentes sur la page de l’agent dans Agent Studio affiche les mêmes informations, sur chaque ligne et dans Lancée par lorsque vous ouvrez une exécution.
- Filtrez par statut. Charger plus affiche les exécutions plus anciennes.
- L’historique inclut les exécutions lancées depuis cette page, dans Ask, par une planification, par un flux de travail, ainsi que les anciennes exécutions lancées avec Exécuter maintenant.
- Chaque exécution possède son propre lien : une notification concernant une exécution l’ouvre donc ici.
- Une exécution arrêtée par une limite apparaît comme bloquée, avec le motif : l’espace de travail n’a plus de crédits, la limite mensuelle d’un membre ou de l’agent est atteinte, l’espace de travail est en lecture seule ou présente un retard de paiement, ou la politique relative aux modèles n’autorise pas le modèle de l’agent. Consultez Crédits et utilisation.
- La demande et le début de la réponse ne s’affichent que pour vos propres exécutions. Pour l’exécution d’une autre personne, un administrateur voit qui l’a lancée, quand, comment elle a démarré et son statut, mais pas la demande, la réponse, ses graphiques ni ses étapes. Cela s’applique à la page d’exécution, à l’historique des exécutions et aux exécutions récentes sur la page de l’agent. La réponse d’un agent dans une conversation Ask fait partie de cette conversation : toute personne qui peut ouvrir la conversation la voit, y compris un administrateur autorisé à lire les conversations des membres.
- Une exécution dont la conversation Ask a été supprimée est en lecture seule : vous pouvez l’ouvrir et lire sa réponse, mais pas la poursuivre.
Parcourir et organiser les agents
La liste affiche les agents dont vous êtes propriétaire et ceux partagés avec vous. Les administrateurs peuvent également voir les agents de tout l’espace de travail.- Trier par Les plus populaires, Récemment mis à jour ou A – Z.
- Chaque carte indique le nombre d’exécutions de l’agent au cours des 30 derniers jours et la date de sa dernière exécution. Tous les modes d’exécution sont comptabilisés : Exécuter maintenant, planifications et déclencheurs, page de l’agent, Ask et étapes de flux de travail. Pour vous, seules les exécutions que vous avez lancées sont comptabilisées ; pour un administrateur, celles de tout le monde le sont. Le tri Les plus populaires repose sur ces mêmes exécutions.
- Chaque carte indique le propriétaire de l’agent : Vous, ou le membre qui l’a créé. Un agent configuré pour vous par Hive dans votre espace de travail (voir Suggestions pour votre espace de travail) affiche Hive comme propriétaire, jamais le nom d’une personne.
- Filtrer par statut : En service, Brouillon, En pause ou Archivé.
- Rechercher des agents par nom et description. Épinglez ceux que vous utilisez le plus pour qu’ils apparaissent sous Agents épinglés.
- Importer un agent importe un agent exporté sous forme de nouveau brouillon. Parcourir les modèles vous permet de partir d’un agent prêt à l’emploi créé par Hive (voir Modèles de Hive). + Créer un agent ouvre l’outil de création, où vous pouvez saisir ou dicter ce que l’agent doit faire (voir Créer un nouvel agent).
- Lorsqu’un onglet ne contient pas encore d’agents, il l’indique et propose Créer un agent si votre rôle le permet. Si une recherche ou un filtre ne donne aucun résultat, un message vous invite plutôt à l’effacer.
Actions rapides sur une carte d’agent
Chaque carte d’agent dispose d’un menu ⋯ qui vous permet d’agir sur l’agent sans l’ouvrir :Statuts des agents
Qui peut faire quoi
Agent Studio respecte les rôles de votre espace de travail (voir Rôles et autorisations) :- Créer un agent : responsable de département, administrateur ou propriétaire. Les autres membres voient le message « Seul un responsable, un administrateur ou un propriétaire peut créer des agents. » Avec Starter, un espace de travail peut compter 3 agents non archivés, tous membres confondus ; Team et les offres supérieures n’ont pas de limite fixe. Une fois la limite atteinte, la création ou la copie d’un agent supplémentaire est refusée. Un espace de travail qui dépasse la limite de son offre (après un passage à une offre inférieure, par exemple) ne peut déployer aucun agent tant que certains n’ont pas été archivés.
- Exécuter un agent : opérateur ou rôle supérieur, avec un droit d’exécution sur cet agent.
- Supprimer un agent : responsable de département ou rôle supérieur.
- Gérer les paramètres des agents de l’espace de travail : administrateur ou rôle supérieur.
- Partager : un agent reste privé et accessible uniquement à son propriétaire tant que celui-ci ne le partage pas avec des collaborateurs désignés. Le partage d’un agent ne partage jamais les comptes connectés de son propriétaire. Il permet toutefois à toute personne autorisée à l’exécuter d’utiliser les fichiers joints à l’agent lors d’une exécution sur sa page d’exécution, dans Ask et dans Continuer dans la conversation, ainsi que de les ouvrir depuis ses conversations, sans les ajouter à sa Bibliothèque : voir Qui peut lire les fichiers d’un agent. Son nom et son icône restent visibles sur les réponses qu’il a données dans une conversation Ask, pour toutes les personnes avec lesquelles la conversation est partagée ; voir Utiliser un agent dans Ask.
La sécurité intégrée
Les actions d’un agent suivent ces règles :- Les actions sélectionnées suivent le niveau du compte. Une action sélectionnée de l’agent s’exécute depuis le compte propre au membre, et le niveau de ce compte — dans la limite de tout plafond défini pour l’espace de travail — détermine son comportement : en mode Action, elle s’exécute immédiatement ; en mode Brouillon, elle attend sur une carte d’approbation ; en mode Lecture, aucune action n’est effectuée et la réponse le précise. Cela s’applique quel que soit le déclencheur de l’exécution : un membre, une planification, un événement d’application ou un signal. Consultez Ce que les agents et les flux de travail font de manière autonome.
- La destination d’une action. Une action dont le destinataire, le canal, le numéro de téléphone ou le lien ne provient ni des instructions de l’agent ni de ce que le membre a saisi dans Hive pour cette exécution, comme une adresse trouvée par l’agent dans un e-mail qu’il a lu, attend l’approbation de ce membre sous forme de carte au lieu de s’exécuter : dans la conversation, ou sous Examiner la décision sur sa page Signaux. Les données d’entrée enregistrées d’une planification ne sont pas considérées comme les propos personnels de quiconque. Inscrivez vous-même dans les instructions les adresses, canaux et liens que l’agent peut utiliser : Décrire l’agent et la conversation Créer n’en ajoutent jamais si vous ne les avez pas enregistrés ou saisis dans votre description, et le précisent à la place (voir Créer un agent). Consultez La destination d’une action.
- Actions activées ou désactivées. Réglez Ce qu’il peut faire sur Lecture et réponses uniquement sous Avancé à l’étape 3, Entrées et sortie, et l’agent n’effectue aucune action.
- Uniquement les actions sélectionnées. Un agent effectue uniquement les actions sélectionnées pour ses applications associées. Hive refuse toute autre action avant qu’elle n’atteigne un compte. Un agent configuré avant que les actions soient choisies par application n’en effectue aucune tant que vous ne les avez pas sélectionnées.
- Des outils MCP pour chaque personne qui l’exécute. Un outil MCP sélectionné s’exécute via la connexion propre à la personne qui lance l’exécution, sur le même serveur. Si cette personne n’en possède pas, elle est invitée à connecter le serveur (ou, si Hive n’a pas pu charger ses outils, elle en est informée) ; si elle possède deux connexions à ce serveur, elle est invitée à en déconnecter une. Un outil modifié par le serveur depuis qu’il a été coché est refusé, avec une note demandant à l’auteur de le cocher à nouveau dans Agent Studio, et la réponse signale les outils cochés uniquement pour la connexion propre à leur auteur. Seuls les outils des serveurs auxquels la personne qui modifie l’agent s’est connectée peuvent être nouvellement cochés.
- Budgets. Des limites strictes s’appliquent à la durée d’exécution, aux appels au modèle, aux étapes d’action, aux écritures externes et aux jetons. Une exécution compte au maximum autant de tours que son budget d’appels au modèle, et jamais plus de 16. Les nouveaux agents démarrent avec les valeurs par défaut de Hive (8 appels au modèle) ; un agent créé à partir d’un modèle qui enchaîne plusieurs outils démarre avec davantage d’appels ; la sélection de la première action d’un agent autorise une écriture externe par exécution ; et les agents créés auparavant conservent les budgets avec lesquels ils ont été enregistrés. Une fois le budget d’écriture épuisé, Hive refuse toute action supplémentaire. Une action en attente d’approbation en raison de sa destination ne consomme aucun budget d’écriture, mais compte comme une étape d’action de l’exécution. Le plafond de jetons par exécution de votre forfait s’applique en complément, y compris dans Ask.
- Limites de l’espace de travail. La limite horaire d’actions et les plafonds de dépenses s’appliquent toujours aux actions. Une action qu’ils bloquent est refusée, et l’agent en explique la raison.
- Crédits. Le travail du modèle d’un agent, qu’il s’exécute ici, selon une planification ou lorsqu’une personne le sollicite dans Ask, consomme des crédits d’IA : sur Business, les crédits du membre qui l’exécute (pour une exécution planifiée, le propriétaire de la planification ; pour un lien public, la personne qui l’a publié), sans limite mensuelle par agent au-delà des crédits propres au membre et de sa limite de recharge ; sur un ancien forfait, la réserve partagée de l’espace de travail, dans la limite mensuelle par agent de 2 000 crédits sur Starter et Team, et de 10 000 sur Business et Enterprise. Si vous avez augmenté le budget de jetons d’un agent au-delà de la valeur par défaut, une exécution dont Hive estime le coût à plus de £5 (500 crédits sur un ancien forfait) vous demande confirmation avant de démarrer ; un agent doté du budget par défaut ne la demande jamais. La boîte de dialogue Déployer affiche le coût maximal estimé de chaque exécution avant la mise en service de l’agent : en livres sterling sur Business, en crédits sur un ancien forfait. Une exécution planifiée ou déclenchée par un événement dont les crédits sont épuisés attend des crédits pendant 72 heures au maximum, et la carte de l’agent dans Agent Studio affiche 1 exécution en attente de crédits (ou le nombre correspondant), ou Exécuter au retour des crédits ? lorsqu’une exécution a attendu 72 heures (voir En attente de crédits).
- Échecs répétés. Une action qui échoue trois fois en une heure sur le même compte est mise en pause sur ce compte uniquement, et l’agent indique jusqu’à quand. Reconnecter le compte lève la pause. Consultez Lorsqu’une action échoue de façon répétée.
- Contenu externe. Un agent déclenché par un événement d’application (un nouvel e-mail, une nouvelle transaction) lit ce qu’une personne extérieure à votre espace de travail a écrit et agit malgré tout. Une action qui enverrait des informations à une adresse, un canal ou un lien issu de ce contenu attend une approbation, mais une action sur un enregistrement existant, comme répondre à un ticket d’assistance, envoyer ou annuler une facture ou supprimer un contact, n’est pas suspendue de cette manière. Ne sélectionnez que les actions que vous acceptez qu’il effectue à partir de tels contenus, et maintenez son budget d’écriture à un niveau faible.
- Arrêt d’urgence. Lorsqu’un administrateur active l’arrêt d’urgence, les agents cessent d’agir, comme tout le reste. Une exécution ou un test déjà en cours s’arrête avant d’effectuer une action, d’accéder à un service extérieur à Hive (une recherche sur le Web ou une application connectée) ou d’enregistrer sa réponse. D’ici là, d’autres appels au modèle peuvent avoir lieu et sont facturés comme d’habitude, mais rien de ce qui est produit n’est enregistré ni transmis. Mettre l’agent en pause, l’archiver ou annuler son déploiement, ou retirer la personne qui a lancé l’exécution (ou lui attribuer un rôle inférieur à Opérateur), arrête une exécution en cours aux mêmes points.
- Comptes rendus. Les actions terminées sont consignées dans le journal d’audit.
Les agents réutilisables des membres sont désactivés par défaut. Vous ne les verrez que si Hive les a activés pour votre espace de travail. Les liens publics d’agents sont disponibles pour tous les espaces de travail : consultez Liens publics d’agents.
Les limites en bref
Consultez le référentiel des limites pour connaître toutes les limites.
Voir aussi
Créer un agent
Décrivez, configurez, testez et déployez votre premier agent.
Publier et évaluer
Analyses, retours, planifications et liens publics.