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 retourne403 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. |
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
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.
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 |
- 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
— 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-<timestamp>.csv ou agents-<timestamp>.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
- Ouvrez Super Admin → Agents.
- Sélectionnez le projet dans la déroulante du filtre Project.
- Filtrez optionnellement par Memory ou Prompt Library.
- Cliquez sur Export pour enregistrer le résultat dans un fichier.
Auditer les agents par créateur
- Choisissez un utilisateur dans la déroulante du filtre Creator.
- 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
- Recherchez l’agent par nom, ou collez son
agent_iddans la zone de recherche. - Cliquez sur l’icône en forme d’œil.
- 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é
- Appliquez les filtres pour définir la portée.
- Cliquez sur Export → XLSX (ou CSV).
- Le fichier correspond exactement à la vue à l’écran, jusqu’à 100 000 lignes.
Dépannage
Échec du chargement des agents
Échec du chargement des agents
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.Projet ou créateur manquant de la déroulante de filtre
Projet ou créateur manquant de la déroulante de filtre
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.
La recherche affiche moins de lignes que prévu
La recherche affiche moins de lignes que prévu
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.
La colonne Creator affiche le propriétaire du projet, pas l'auteur réel
La colonne Creator affiche le propriétaire du projet, pas l'auteur réel
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.
Memory ou Prompt Lib affichent Off mais la fonctionnalité semble configurée
Memory ou Prompt Lib affichent Off mais la fonctionnalité semble configurée
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.Le fichier d'exportation manque le texte de la personnalité au-delà de ~500 caractères
Le fichier d'exportation manque le texte de la personnalité au-delà de ~500 caractères
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.
403 Unauthorized sur chaque requête
403 Unauthorized sur chaque requête