> ## Documentation Index
> Fetch the complete documentation index at: https://docs.get-hive.ai/llms.txt
> Use this file to discover all available pages before exploring further.

> ## Agent Instructions
> Hive is an AI operations layer for small and mid-sized business teams. It reads the tools a team already runs, raises what needs attention, and acts with the approvals the team configures.
> Answer only from these pages. If a page does not cover something, say so and link the closest page rather than inferring behaviour.
> The supported programmatic entry points are incoming webhooks, public workflow forms and the remote MCP server, each documented under Developers.
> Each connected account has a level: Read, Draft or Act. New accounts start on Act. Agents and workflows take only the actions selected for them, whatever the account level.
> Describe security, sign-on and data handling only as the Security pages and the FAQ describe them, and add no certification, compliance, single sign-on or model-training claim they do not make.
> Prices and credit allowances are in GBP. Quote them only as a page states them, without converting.
> Use UK English and the product's exact UI labels. Link to pages as https://docs.get-hive.ai/<path>.

# Présentation d’Agent Studio

> Créez des agents d’IA spécialisés qui s’appuient sur votre Cerveau d’entreprise et votre Bibliothèque, n’effectuent que les actions sélectionnées et s’utilisent dans Ask, les planifications et les flux de travail.

Agent Studio vous permet de créer des **agents spécialisés que vous configurez pour une tâche — en s’appuyant sur votre Cerveau d’entreprise et en respectant vos règles.** Ask Hive est un assistant généraliste. Un agent est un spécialiste enregistré et versionné, par exemple un agent de relance des impayés qui adopte votre ton, un rédacteur de propositions qui connaît vos modèles ou un assistant de tri pour une boîte de réception partagée.

Dans la barre latérale, sélectionnez **Agent Studio** (`/agents`), juste au-dessus de **Flux de travail**. Le titre de la page est
**Agents**. La palette de commandes (<kbd>⌘</kbd> <kbd>K</kbd>) 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** :

| Élément | Ce qu’il contrôle |
| - | - |
| **Instructions** | La mission, la persona et l’objectif de l’agent, rédigés en langage courant. |
| **Entrées** | La manière de le démarrer : un **Prompt** en texte libre (par défaut), **Hive choisit**, ou un **Formulaire** structuré avec des champs typés. |
| **Connaissances** | Les fichiers et dossiers de la Bibliothèque qu’il peut lire. Toute personne autorisée à exécuter l’agent y a accès lorsqu’elle l’exécute sur sa page d’exécution, dans Ask et dans Continuer dans la conversation, même s’il s’agit d’un fichier que vous seul pouvez ouvrir : consultez [Qui peut lire les fichiers d’un agent](#who-can-read-an-agents-files). Jusqu’à environ 50 000 jetons au total, ils sont transmis intégralement au modèle. Au-delà, l’agent reçoit une liste (nom, date, premières lignes) et ouvre les fichiers dont il a besoin un par un : lors de ses exécutions, lorsqu’une personne le sollicite dans Ask, lorsqu’un autre agent lui confie une tâche, en tant qu’étape d’un flux de travail, lors d’un Test en brouillon et via son [lien public](https://docs.get-hive.ai/agents/publish-and-evaluate.md#public-agent-links), où chaque ouverture porte sur un volume plus réduit. Un [test complet](https://docs.get-hive.ai/agents/build-an-agent.md) lit toujours les fichiers dans leur intégralité. Les agrégats issus d’une feuille de calcul liée (CSV, TSV ou Excel), tels qu’une somme, une moyenne ou un décompte, sont calculés exactement sur l’ensemble des lignes plutôt qu’estimés par le modèle. Consultez [Comment Hive lit les fichiers que vous choisissez](https://docs.get-hive.ai/fr/library/library.md#how-hive-reads-the-files-you-choose). |
| **Intégrations** | Les applications connectées avec lesquelles il travaille. Il peut toujours lire les données d’une application rattachée et n’effectue que les actions que vous activez pour lui, comme **Envoyer un e-mail** dans Gmail ou **Créer une transaction** dans HubSpot. Chaque action activée porte la mention **S’exécute automatiquement lorsqu’une personne exécute cet agent.** |
| **Comportement de l’agent** | **Ce qu’il peut faire** (**Lire et répondre uniquement** ou **Effectuer des actions dans vos applications**), les données propres à la personne qu’il peut lire (**Données propres à la personne**), **Rechercher sur le Web**, **Créer des images**, **Créativité** (**Précis**, **Équilibré** ou **Créatif**) et ce qui se passe **Lorsque les crédits ou les limites sont épuisés**. |

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](https://docs.get-hive.ai/agents/build-an-agent.md#how-the-editor-is-laid-out)). 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](#files-from-google-drive-onedrive-and-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.

Les fichiers importés sont ajoutés à votre Bibliothèque en tant que fichiers privés et sont soumis aux vérifications habituelles : jusqu’à 10 fichiers à la fois,
chacun d’un type pris en charge et ne dépassant pas 25 Mo. Vous devez disposer du rôle Opérateur ou d’un rôle supérieur pour importer des fichiers.

Chaque importation apparaît immédiatement dans la ligne **Fichiers**. Elle affiche **Traitement…** pendant que Hive lit
son contenu, puis **Joint · Enregistrer pour conserver** dès que l’agent peut l’utiliser. Enregistrez l’agent (**Enregistrer
le brouillon**, ou **Publier les modifications** pour un agent en ligne) pour conserver la pièce jointe dans une nouvelle révision ; jusque-là, **Abandonner les modifications** la retire, et le
fichier reste dans votre Bibliothèque. Si une importation échoue, sa pastille en indique la raison et propose **Réessayer** et
**Supprimer**. Il en va de même si un fichier est toujours en cours de traitement après 10 minutes ou si Hive ne parvient pas à vérifier
son état 10 fois de suite.

Sélectionnez le nom d’un fichier dans la ligne **Fichiers** pour l’ouvrir dans le même aperçu que celui de la Bibliothèque : un fichier Word ou
PowerPoint s’ouvre sur ses [pages](https://docs.get-hive.ai/fr/library/library.md#pages-and-text), avec **Texte** accessible en un clic.
L’aperçu utilise vos propres droits d’accès à la Bibliothèque : pour un fichier que vous ne pouvez pas y ouvrir, aucune action d’ouverture
n’est donc proposée ici, seulement **×** pour le retirer. Ouvrir un fichier ne modifie jamais l’agent.

### 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](https://docs.get-hive.ai/fr/integrations/overview.md) ; 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.

Aucune vérification n’a lieu en arrière-plan, et l’ouverture de l’agent par une autre personne ne déclenche aucune vérification. Lorsque
l’original a changé, Hive le copie à nouveau et conserve le contenu précédent dans l’historique des versions du fichier.
L’agent utilise immédiatement le nouveau contenu, y compris dans ses versions déployées, comme après
une modification d’un fichier de la Bibliothèque. Si une vérification ne permet pas d’accéder à l’original, la copie reste utilisable et
la ligne **Fichiers** en indique la raison, par exemple **Actualisation impossible : reconnecter Google Drive**. Voir [Fichiers copiés
depuis Google Drive, OneDrive et SharePoint](https://docs.get-hive.ai/fr/library/library.md#files-copied-from-google-drive-onedrive-and-sharepoint).

### 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](https://docs.get-hive.ai/fr/library/library.md#how-hive-reads-the-files-you-choose)).
* **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](https://docs.get-hive.ai/developers/mcp-server.md) 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.

Les fichiers qu’une personne choisit pour une exécution (une source d’exécution ou un fichier dans un champ de formulaire) sont toujours lus avec
les droits d’accès de cette personne, tout comme les fichiers d’un agent auquel un autre agent confie une tâche, ainsi que ceux
d’une exécution lancée avec **Exécuter maintenant**, selon une planification ou à la suite d’un transfert depuis les signaux. Une
étape de flux de travail lit les fichiers d’un agent avec les droits du membre sous l’identité duquel le flux de travail
s’exécute, et un [lien public](https://docs.get-hive.ai/agents/publish-and-evaluate.md) les lit avec les droits de la personne qui l’a publié.

## Où les agents s’exécutent

Tout agent déployé est disponible dans Ask, sur [sa propre page d’exécution](#run-an-agent-directly) 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.

> [card] [Ask Hive](https://docs.get-hive.ai/fr/ask/ask-hive.md)
>
> 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.

> [card] [Sa propre page d’exécution](#run-an-agent-directly)
>
> Remplissez le formulaire de l’agent, exécutez-le, lisez la réponse et consultez ses exécutions passées.

> [card] [Planifications](https://docs.get-hive.ai/admin/scheduled-tasks.md)
>
> Exécutez l’agent de manière récurrente avec un prompt et un fuseau horaire fixes.

> [card] [Flux de travail](https://docs.get-hive.ai/workflows/workflow-steps.md)
>
> Ajoutez un agent déployé à un flux de travail depuis la Bibliothèque d’agents du concepteur.

> [card] [Liens publics](https://docs.get-hive.ai/agents/publish-and-evaluate.md)
>
> 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

| Contexte d’exécution | Ce qu’il lit | Actions |
| - | - | - |
| Une conversation Ask | Ses [fichiers joints](#who-can-read-an-agents-files), ainsi que les données du membre qu’il déclare sous **Données propres à la personne** et ses applications associées, avec votre identité, et le Web lorsque cela est autorisé. Les outils **Cerveau d’entreprise**, **Graphique** et **Image**, ainsi qu’un fichier ouvert, fonctionnent également dans ce périmètre. | Ses actions sélectionnées, effectuées depuis vos propres comptes selon le niveau autorisé pour chaque compte, dans la limite de tout plafond défini pour l’espace de travail : immédiatement en mode **Action**, après votre approbation en mode **Brouillon**, et jamais en mode **Lecture** (les cartes d’approbation apparaissent dans la conversation). En mode **Action**, une action dont le destinataire, le canal, le numéro ou le lien ne provient ni des instructions de l’agent ni de vos propres messages attend tout de même votre approbation dans la conversation. Sa réponse indique ce qu’il a fait. |
| Une configuration d’exécution (une conversation Ask dédiée ou un formulaire sur sa propre page) | Ses [fichiers joints](#who-can-read-an-agents-files), ainsi que les sources d’exécution que vous choisissez, les données du membre qu’il déclare sous **Données propres à la personne** et ses applications associées et connectées, avec votre identité, et le Web lorsque cela est autorisé. | Ses actions sélectionnées, effectuées depuis vos propres comptes selon le niveau autorisé pour chaque compte, dans la limite de tout plafond défini pour l’espace de travail : immédiatement en mode **Action**, après votre approbation en mode **Brouillon**, et jamais en mode **Lecture**. Elles sont consignées dans l’exécution, à raison de cinq au maximum par exécution. En mode **Action**, une action dont le destinataire, le canal, le numéro ou le lien ne provient ni des instructions de l’agent ni de ce que vous avez saisi pour l’exécution attend tout de même votre approbation. Avec un modèle de fichier Word ou Excel, jusqu’à trois [nouveaux fichiers dans votre Bibliothèque](#files-a-run-writes-to-your-library). |
| Une étape de flux de travail | Ses connaissances et ses sources d’exécution, les données du membre qu’il déclare sous **Données propres à la personne** et ses applications associées et connectées, avec l’identité du membre sous laquelle le flux de travail s’exécute, et le Web lorsque cela est autorisé. Une recherche sur le Web peut inclure tout ce que l’étape a lu, et le fournisseur de recherche de Hive reçoit ces informations. | Ses actions sélectionnées, effectuées depuis les comptes de ce membre selon le niveau autorisé pour chaque compte, dans la limite de tout plafond défini pour l’espace de travail : immédiatement en mode **Action**, après approbation en mode **Brouillon**, et jamais en mode **Lecture**. Jusqu’à cinq par étape. En mode **Action**, une action dont le destinataire, le canal, le numéro ou le lien ne provient ni des instructions de l’agent ni d’une valeur fixe saisie dans l’étape attend tout de même une approbation. |
| Un lien public | Uniquement ses propres connaissances et le message du visiteur. | Aucune. |

Les [compétences obligatoires](https://docs.get-hive.ai/skills/skills.md#how-hive-uses-skills) 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](https://docs.get-hive.ai/workflows/workflow-steps.md#web-hive-data-and-connected-apps-in-an-agent-library-step). 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](https://docs.get-hive.ai/workflows/workflow-steps.md#agent-library).

## 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](https://docs.get-hive.ai/fr/library/library.md). 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.

Un agent plus ancien, enregistré avant l’apparition des configurations d’exécution, affiche à la place un formulaire plus simple : ses champs,
**Instructions d’exécution (facultatif)** et **Exécuter maintenant**, sans importation ni Continuer dans la conversation.

Sélectionnez **Exécuter**. La réponse apparaît sous le formulaire, en premier, avec ses sources et les fichiers
créés dans une section repliée en dessous. Lorsque vos instructions d’exécution demandent un graphique, par exemple « représenter le chiffre d’affaires par
région », l’agent le crée à partir d’une feuille de calcul qui lui est jointe ou qu’il lit, ou de chiffres que vous
avez saisis. Le graphique est affiché et enregistré avec la réponse, sa source étant indiquée en dessous, comme dans
[Visualiser les données](https://docs.get-hive.ai/ask/tools-and-modes.md). Une exécution lancée depuis Agent Studio — **Exécuter maintenant**, une planification, un
événement d’application, un signal ou un autre agent — conserve aussi les graphiques créés, jusqu’à quatre, affichés sous sa
réponse lorsque vous ouvrez l’exécution ; un graphique créé à partir de chiffres d’exemple porte la mention « données d’exemple », et sa
réponse le précise. Les graphiques sont affichés ou masqués exactement comme la réponse de l’exécution. Si l’agent autorise les questions de suivi, **Continuer dans la conversation** ouvre l’exécution sous forme de
conversation Ask pour vous permettre de poursuivre l’échange, en vous appuyant sur un maximum de 50 réponses antérieures ; au-delà,
Hive vous demande de démarrer une nouvelle session. Sinon, chaque exécution fournit une seule réponse : relancez-la pour
poser une nouvelle question.

Une exécution démarre dès que vous sélectionnez **Exécuter**. Hive lit ses sources une seule fois, avec vos droits d’accès actuels,
lorsque l’agent prépare la réponse : si vous ne pouvez plus ouvrir une source, l’exécution échoue et le signale.
Une étape de flux de travail utilisant un agent enregistré fonctionne de la même manière. Si l’exécution a mis des actions en attente en raison de leur
destination, sa réponse indique combien attendent votre approbation sous **Examiner la décision** sur
votre page **Signaux**.

### Fichiers qu’une exécution écrit dans votre Bibliothèque

Un agent doté d’un [modèle de fichier](https://docs.get-hive.ai/agents/build-an-agent.md#ground-it-in-your-knowledge) 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](https://docs.get-hive.ai/approvals/audit-log.md) sous
  « Une exécution d’agent a créé un fichier dans la Bibliothèque », avec l’agent, l’exécution et le fichier.

L’exécution d’une étape de flux de travail (y compris une exécution planifiée ou déclenchée par un événement d’application), un **Test** lancé par l’auteur et un
[lien public](https://docs.get-hive.ai/agents/publish-and-evaluate.md) n’écrivent jamais de fichiers : utilisez l’étape
[Créer un PDF](https://docs.get-hive.ai/workflows/workflow-steps.md#create-pdf) d’un flux de travail pour enregistrer un PDF depuis ce flux de travail. Vous devez disposer du
rôle Opérateur ou d’un rôle supérieur et avoir accès à la Bibliothèque, comme pour tout fichier que vous ajoutez.

Si le modèle d’IA de l’agent échoue en cours d’exécution, l’exécution indique quel modèle a échoué, ce que son fournisseur d’IA
a signalé (par exemple, le rejet de la requête, avec le statut HTTP et le
code d’erreur du fournisseur) et la marche à suivre : patienter et réessayer lorsque le fournisseur est occupé, modifier
la requête lorsqu’un filtre de sécurité l’a bloquée, ou réessayer puis choisir un autre modèle dans les
paramètres de l’agent si le fournisseur continue de la rejeter. Le même message apparaît dans Agent Studio, dans
Ask et dans l’étape d’agent enregistré d’un flux de travail.

### 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](https://docs.get-hive.ai/admin/credits-and-usage.md).
* 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](https://docs.get-hive.ai/fr/get-started/inbox.md#suggested-for-your-workspace)) 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](https://docs.get-hive.ai/agents/build-an-agent.md#templates-by-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](https://docs.get-hive.ai/agents/build-an-agent.md#start-a-new-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 :

| Action | Fonction | Qui la voit |
| - | - | - |
| **Modifier** / **Ouvrir** | Ouvre l’agent. Les propriétaires et les administrateurs qui peuvent le modifier voient **Modifier** ; les autres voient **Ouvrir**. | Toute personne qui peut voir l’agent |
| **Exécuter** | Ouvre la [page d’exécution](#run-an-agent-directly) de l’agent, avec son formulaire et son historique des exécutions. Uniquement pour les agents au statut **Déployé** que vous pouvez exécuter. | Les membres qui peuvent exécuter l’agent |
| **Utiliser dans Ask** | Démarre une nouvelle conversation Ask avec l’agent sélectionné. Uniquement pour les agents au statut **Déployé** que vous pouvez exécuter. | Les membres qui peuvent exécuter l’agent |
| **Épingler** / **Désépingler** | Ajoute l’agent aux **Agents épinglés** ou l’en retire. | Tout le monde |
| **Copier le lien** | Copie un lien qui ouvre l’agent dans Agent Studio. Seules les personnes qui peuvent voir l’agent peuvent l’ouvrir. | Tout le monde |
| **Dupliquer** | Copie l’agent dans un nouveau brouillon privé, après que vous lui avez donné un nom. | Les membres qui peuvent modifier l’agent et créer des agents |
| **Partager** | Ouvre les paramètres de partage de l’agent. | Les propriétaires et les administrateurs qui peuvent gérer l’accès à l’agent |
| **Lien public** | Ouvre les options du lien public de l’agent, où vous pouvez l’activer ou le révoquer. Consultez [Liens publics des agents](https://docs.get-hive.ai/agents/publish-and-evaluate.md#public-agent-links). | Les propriétaires et les administrateurs, pour les agents dont ils sont propriétaires |
| **Archiver** | Archive l’agent après confirmation. Il passe en lecture seule et son historique est conservé. Si l’agent est occupé à ce moment-là (par exemple, pendant le démarrage d’une de ses exécutions), Hive attend quelques secondes ; s’il est toujours occupé, le message « Hive est occupé avec cet agent. Réessayez dans un instant. » s’affiche et rien n’a changé : réessayez. La mise en pause fonctionne de la même manière. | Les propriétaires et les administrateurs |
| **Supprimer définitivement** | Supprime un agent archivé après que vous avez saisi son nom pour confirmer. Cette action est irréversible. Ses exécutions passées et leur utilisation restent dans les registres de votre espace de travail et continuent de compter dans l’utilisation de votre forfait. Cela inclut un agent que vous avez autrefois partagé via un lien public : le lien reste désactivé, et les conversations des visiteurs ainsi que leur utilisation restent dans vos registres. Les conversations qui utilisaient l’agent restent des conversations ordinaires, et les exécutions de flux de travail qui l’utilisaient peuvent toujours être ouvertes : son étape affiche **Agent supprimé**, et les résultats de cette étape et des suivantes ne sont plus affichés, mais le statut, la durée et le coût de chaque étape restent visibles. Vous ne pouvez pas supprimer l’agent tant qu’une de ses exécutions est en cours. | Les propriétaires et les administrateurs |

### Statuts des agents

| Statut | Signification |
| - | - |
| `draft` (**Brouillon**) | En cours de création. Vous pouvez le prévisualiser, mais pas planifier son exécution ni le publier. |
| `deployed` (**Déployé**) | Une révision enregistrée est déployée et peut être utilisée dans Ask, les planifications et les flux de travail. |
| `paused` (**En pause**) | Temporairement arrêté. **Reprendre** le réactive avec la même révision. |
| `archived` (**Archivé**) | Retiré et masqué de l’utilisation courante. |

## Qui peut faire quoi

Agent Studio respecte les rôles de votre espace de travail (voir [Rôles et autorisations](https://docs.get-hive.ai/admin/roles-and-permissions.md)) :

* **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](#who-can-read-an-agents-files). 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](https://docs.get-hive.ai/fr/ask/ask-hive.md#use-an-agent-in-ask).

Les administrateurs peuvent désactiver Agent Studio pour l’espace de travail ou en limiter l’accès à certains membres et groupes dans les [paramètres de l’espace de travail](https://docs.get-hive.ai/admin/workspace-settings.md).

## 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](https://docs.get-hive.ai/integrations/accounts-and-autonomy.md#what-agents-and-workflows-do).
* **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](https://docs.get-hive.ai/agents/build-an-agent.md)). Consultez [La destination d’une action](https://docs.get-hive.ai/integrations/accounts-and-autonomy.md#where-an-action-sends).
* **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](https://docs.get-hive.ai/admin/earlier-plans.md), 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](https://docs.get-hive.ai/workflows/runs-and-errors.md#waiting-for-credits)).
* **É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](https://docs.get-hive.ai/integrations/accounts-and-autonomy.md#when-an-action-keeps-failing).
* **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](https://docs.get-hive.ai/admin/safety-and-control.md), 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](https://docs.get-hive.ai/approvals/audit-log.md).

Vous pouvez toujours consulter l’état d’une exécution enregistrée et arrêter une exécution inachevée si sa source dans la Bibliothèque devient
indisponible. Une exécution terminée conserve sa réponse : vous pouvez l’ouvrir ultérieurement même si vous avez depuis perdu
l’accès à une source qu’elle a lue. La perte d’accès s’applique à partir de votre prochaine exécution ou question, qui ne
lit plus cette source et ne la cite plus.

> [!NOTE]
>
> 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](https://docs.get-hive.ai/agents/publish-and-evaluate.md#public-agent-links).

## Les limites en bref

| Élément | Limite |
| - | - |
| Prompt de base | 16 000 caractères |
| Persona, objectif | 4 000 caractères chacun |
| Entrées | 50 |
| Liens vers les connaissances | 100 |
| Applications associées | 20, avec jusqu’à 50 actions sélectionnées chacune |
| Compétences | 10 |
| Questions suggérées | 12 |
| Appels au modèle (tours) par exécution | Le budget d’appels au modèle de l’agent (8 par défaut), jusqu’à 16 |
| Nouveaux fichiers écrits dans la Bibliothèque par exécution | 3 |
| Délégations à d’autres agents | 20, sur 5 niveaux de profondeur au maximum |
| Agents par espace de travail (agents non archivés de tous les membres) | Aucune limite sur Business et Team ; 3 sur Starter |
| Jetons par exécution, y compris les exécutions planifiées, déclenchées par un événement et publiques (entrée / sortie) | 3 000 000 / 300 000 sur Business, Team et Enterprise (modifiable par contrat sur Enterprise) ; 300 000 / 30 000 sur Starter |
| Modèles pour les exécutions déclenchées par une planification, un événement d’application ou un signal | Efficient ou Balanced ; Frontier est refusé sauf si la clé propre à votre organisation est utilisée |

Consultez le [référentiel des limites](https://docs.get-hive.ai/developers/limits-reference.md#agent-studio) pour connaître toutes les limites.

## Voir aussi

> [card] [Créer un agent](https://docs.get-hive.ai/agents/build-an-agent.md)
>
> Décrivez, configurez, testez et déployez votre premier agent.

> [card] [Publier et évaluer](https://docs.get-hive.ai/agents/publish-and-evaluate.md)
>
> Analyses, retours, planifications et liens publics.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.