> ## Documentation Index
> Fetch the complete documentation index at: https://ai-kb.automationanywhere.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Agents
> Auditez et inspectez chaque agent sur tous les équipes et projets depuis une vue système unique.
L'onglet Agents est une **surface d'audit système-large en lecture seule** couvrant tous les agents dans EK. Il permet aux super-administrateurs de faire l'inventaire des agents, d'inspecter leur configuration complète, de les corréler avec leur projet et leur équipe, et d'exporter les résultats pour la conformité ou le reporting de gouvernance — tout sans naviguer dans les projets individuels.
L'onglet Agents ne permet pas de modifier ou supprimer des agents. Toute modification d'un agent doit être effectuée depuis son projet propriétaire par un utilisateur ayant le rôle de projet approprié.
## Conditions préalables
Seuls les utilisateurs marqués comme super-administrateurs peuvent accéder à cet onglet. Chaque endpoint backend vérifie indépendamment le statut d'administrateur et retourne `403 Unauthorized` pour tous les autres utilisateurs — y compris les appels API directs effectués en dehors de l'interface utilisateur.
## Où le trouver
Allez à **Super Admin → Users & Workspaces → Agents**.
L'onglet s'affiche aux côtés de **App Licenses**, **Projects**, **Teams**, **Teams Bots**, et **Users** dans la zone de contenu principal du tableau de bord.
## Tableau des agents
Le tableau est trié par **Last Updated (descendant)** par défaut. Ce tri est stable entre les pages — paginer avant et arrière ne mélange jamais les lignes au cours d'une session.
| Colonne | Description |
| -------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Agent** | Le nom de l'agent. Revient à « Untitled » si vide. |
| **Agent ID** | L'identifiant public de l'agent utilisé par les routes de chat et de projet. Affiché tronqué en monospace — survolez pour la valeur complète. |
| **Project** | Le nom du projet propriétaire, avec son ID de projet sur une deuxième ligne. |
| **Team** | L'équipe qui possède le projet. |
| **Creator** | L'utilisateur qui a créé la première version de l'agent. Revient au propriétaire du projet pour les agents legacy antérieurs à l'historique des versions. Affiché comme nom avec e-mail en dessous. |
| **Created** | L'heure de création de l'agent, dans votre fuseau horaire local. |
| **Updated** | L'heure de la dernière mise à jour. Colonne de tri par défaut. |
| **Memory** | Badge On / Off. `NULL` est traité comme Off. |
| **Prompt Lib** | Badge On / Off pour la fonctionnalité Prompt Library. `NULL` est traité comme Off. |
| **Blocks** | Nombre de blocs de construction attachés à l'agent. |
| **Actions** | Icône en forme d'œil — ouvre la [modal View Details](#view-details-modal). |
Des tirets cadratins (`—`) apparaissent partout où une valeur est `NULL` ou vide, y compris les horodatages.
## Mode recherche vs mode liste
L'onglet fonctionne en deux modes selon que la zone de recherche est active.
### Mode liste (par défaut)
* Actif lorsque la zone de recherche est vide
* Le tableau est paginé à **12 lignes par page**
* Le contrôle de pagination affiche `Page X of Y`
* Les filtres s'appliquent normalement; la page revient à 1 lorsqu'un filtre change
### Mode recherche
* Activé dès que vous tapez dans la zone de recherche (délai de 400 ms)
* La pagination est masquée; le backend retourne jusqu'à **200 lignes correspondantes** dans une seule réponse
* Lorsque le nombre réel de correspondances dépasse 200, une ligne de résumé se lit : `4815 match(es) (showing first 200 — narrow the search to see more)` — affinez votre requête ou ajoutez des filtres pour voir le reste
* La recherche est une **correspondance partielle insensible à la casse** sur le nom de l'agent, l'ID de l'agent, le nom du projet, et le nom/e-mail du créateur simultanément
* Coller un UUID avec des caractères `_` ou `%` est sûr — ces caractères ne sont pas traités comme des caractères génériques
* Longueur maximale de la requête : **100 caractères**
Les filtres déroulants s'empilent au-dessus de la recherche dans les deux modes, vous pouvez donc combiner une recherche textuelle avec les filtres de projet, créateur, et fonctionnalité simultanément.
## Filtres
Quatre filtres apparaissent sous la barre de recherche. Modifier un filtre réinitialise la page à 1.
| Filtre | Comportement |
| ------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Project** | Déroulante de tous les projets qui ont au moins un agent, triés par nom. |
| **Creator** | Déroulante de tous les créateurs distincts (auteur de première version ou propriétaire du projet d'un projet avec agents). Affiché comme `name (email)`. |
| **Memory** | Tri-état : **Any** / **Enabled** / **Disabled**. Disabled inclut `FALSE` et `NULL`. |
| **Prompt Library** | Même sémantique tri-état que Memory. |
Les déroulantes Project et Creator sont limitées à **1 000 entrées**. Si la limite est atteinte, un indice ambré apparaît sous la déroulante. Utilisez la zone de recherche pour trouver les projets ou créateurs non affichés dans la liste — la recherche s'exécute sur la table complète.
Utilisez le bouton **Clear search & filters** pour réinitialiser la zone de recherche et toutes les déroulantes à la fois.
## Modal View Details
Cliquer sur l'icône en forme d'œil sur n'importe quelle ligne ouvre la configuration complète de cet agent. La modal récupère toujours les données en direct à l'ouverture.
**Grille d'en-tête** — champs de configuration clés en coup d'œil :
| Champ | Description |
| ------------------------------------------------------------ | ------------------------------------------------------------------ |
| Agent Name / Agent ID | Identifiants |
| Project (name + ID) | Projet propriétaire |
| Team (name + ID) | Équipe propriétaire |
| Creator (name + email + user ID) | Auteur de première version, avec secours au propriétaire du projet |
| Temperature | Formaté à 2 décimales |
| Created / Last Updated | Horodatages |
| Building Blocks | Nombre de blocs attachés |
| Memory Enabled / Prompt Library | Indicateurs de fonctionnalités |
| Mask URLs / Enrich Sources / Inline Citations / Filter Links | Indicateurs de comportement de réponse |
| Use Google / Use KB | Indicateurs de source |
**Blocs JSON / texte** — brut, défilable, joliment formaté :
* **Personality** — l'invite système complète (non tronquée, contrairement aux exportations)
* **Attached Blocks** — configuration des blocs de construction
* **Rules** — règles de l'agent
* **Document Keys** — configuration du périmètre du document
* **Memory Settings** — configuration de la mémoire
* **Prompt Settings** — configuration de la bibliothèque d'invite
Les valeurs vides et nulles s'affichent sous forme de `—` partout.
## Actualiser les données
Le **bouton d'actualisation** (flèche circulaire, à droite de la zone de recherche) ré-exécute la requête actuelle — même page, recherche et filtres. Il ne déclenche pas une nouvelle recherche lorsque la zone de recherche a une saisie en attente ; il attend que le délai se stabilise d'abord pour éviter d'afficher des résultats périmés pour une requête qui est sur le point de changer.
Les requêtes de table sont mises en cache pendant **30 secondes**, donc naviguer entre les pages ou les états de filtre que vous avez déjà visités est instantané.
## Exporter
Le déroulant **Export** (en haut à droite) diffuse la vue actuelle — y compris tous les termes de recherche et filtres actifs — vers un fichier téléchargeable.
| Paramètre | Détail |
| ---------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Formats** | CSV et XLSX |
| **Filename** | `agents-.csv` ou `agents-.xlsx` |
| **Row cap** | 100 000 lignes. Réduisez les filtres ou la recherche si vous dépassez cela. |
| **Timestamps** | Formatés dans le fuseau horaire local de votre navigateur |
| **Personality column** | Tronqué à 500 caractères avec `...` de fin — ouvrez View Details pour l'invite complète |
| **Column order** | Stable, commençant par : `name`, `agent_id`, `id`, `project_name`, `project_id`, `team_name`, `team_id`, `creator_name`, `creator_email`, `creator_user_id`, … |
## Flux de travail courants
### Trouver tous les agents dans un projet
1. Ouvrez **Super Admin → Agents**.
2. Sélectionnez le projet dans la déroulante du filtre **Project**.
3. Filtrez optionnellement par **Memory** ou **Prompt Library**.
4. Cliquez sur **Export** pour enregistrer le résultat dans un fichier.
### Auditer les agents par créateur
1. Choisissez un utilisateur dans la déroulante du filtre **Creator**.
2. Si l'utilisateur n'est pas dans la déroulante, tapez son nom ou son e-mail dans la zone de recherche — la recherche s'exécute sur la table complète.
### Inspecter la configuration complète d'un agent spécifique
1. Recherchez l'agent par nom, ou collez son `agent_id` dans la zone de recherche.
2. Cliquez sur l'icône en forme d'œil.
3. Consultez la grille d'en-tête pour la configuration de haut niveau et les blocs JSON pour la personnalité, les règles, les blocs attachés, et les paramètres.
### Produire un rapport de conformité
1. Appliquez les filtres pour définir la portée.
2. Cliquez sur **Export → XLSX** (ou CSV).
3. Le fichier correspond exactement à la vue à l'écran, jusqu'à 100 000 lignes.
## Dépannage
Le backend a retourné une réponse non-2xx. Ouvrez browser DevTools → Network pour voir le code d'état ; le détail complet de l'erreur se trouve dans le journal backend sous `Error fetching agents`.
La déroulante est limitée à 1 000 entrées. Cherchez l'indice ambré « Showing first 1000… » sous la déroulante. Utilisez plutôt la zone de recherche — elle interroge la table complète.
Les résultats de la recherche sont limités à 200 lignes par réponse. La ligne de résumé affiche le nombre réel de correspondances. Ajoutez des filtres ou réduisez la requête pour ramener l'ensemble de résultats sous 200.
L'agent a été créé avant l'existence de l'historique des versions. Le propriétaire du projet est utilisé comme secours délibéré pour ces agents legacy.
La colonne traite `NULL` comme Off, ce qui correspond au comportement d'exécution. Si la valeur doit être On, vérifiez `agents.memory_enabled` ou `agents.prompt_library_enabled` directement dans la base de données.
La personnalité est intentionnellement tronquée à 500 caractères dans les exportations. Ouvrez la modal View Details pour voir l'invite système complète.
Votre compte n'est pas marqué comme super-administrateur (`users.is_admin = true`). Contactez votre administrateur système.