Configuration des agents
Cette référence énumère tous les champs de l’entité agent, ainsi que les énumérations et les indicateurs qu’elle utilise. Pour un guide pas à pas de la création ou de la modification d’un agent dans l’application, consultez Créer et configurer un agent.
Champs de l’entité agent
Section intitulée “Champs de l’entité agent”| Champ | Type | Obligatoire | Description |
|---|---|---|---|
id |
String |
Oui | Identifiant unique de l’agent |
name |
String |
Oui | Identifiant court pour les @mentions |
title |
String |
Oui | Titre de poste lisible par un humain |
agentMdPath |
String |
Oui | Chemin absolu vers le fichier de définition .md de l’agent |
workspaceId |
String |
Oui | Espace de travail propriétaire (non nul) |
reportsTo |
String? |
Non | Identifiant de l’agent parent |
skills |
AgentSkills |
Oui | Ensemble d’identifiants de skills |
persona |
String? |
Non | Instructions comportementales en texte libre |
systemPrompt |
String? |
Non | Remplacement du prompt système par défaut |
adapterId |
String? |
Non | Identifiant de l’adaptateur d’inférence |
modelId |
String? |
Non | Identifiant du modèle au sein de l’adaptateur |
strictMode |
bool |
Non | Valeur par défaut : false. Écrit dans la ligne et dans le fichier AGENTS.md de l’agent |
effort |
String? |
Non | Identifiant du niveau de raisonnement (p. ex. 'low', 'xhigh'), tiré des thinkingLevels du modèle sélectionné |
contextSize |
int? |
Non | Taille maximale de la fenêtre de contexte |
role |
AgentRole? |
Non | Rôle de l’agent |
monthlyBudgetCents |
int |
Non | Plafond de dépenses mensuelles en cents (valeur par défaut : 0, illimité) |
silenceTimeoutMinutes |
int? |
Non | Remplacement du délai d’inactivité en minutes; doit être nul ou compris entre 1 et 240 (vérifié par le constructeur) |
maxConcurrentTasks |
int |
Non | Valeur par défaut : 1. Chiffre de capacité que rapporte le modèle de présence (les décomptes d’exécutions en cours et en attente y sont comparés) |
visibility |
AgentVisibility |
Non | Valeur par défaut : workspace |
lifecycleStatus |
AgentLifecycleStatus |
Non | Statut de gouvernance (valeur par défaut : active). Écrit par l’arrêt ferme du budget et affiché dans l’organigramme et la liste de présence. Le lancement accepte tout de même du travail provenant d’un agent paused |
budgetPolicyId |
String? |
Non | Identifiant de la politique budgétaire partagée; lorsque la valeur est nulle, monthlyBudgetCents s’applique directement |
runtimeProfileId |
String? |
Non | Identifiant du profil d’exécution personnalisé |
createdAt |
DateTime |
Oui | Horodatage de création |
name et title doivent tous deux être non vides (vérifié par le constructeur). La
valeur par défaut 0 de monthlyBudgetCents signifie illimité. Définissez un plafond avec agents.upsert.
Énumération AgentRole
Section intitulée “Énumération AgentRole”| Rôle | Libellé | Description |
|---|---|---|
ceo |
CEO | Coordination et délégation |
coder |
Coder | Implémentation de code |
reviewer |
Reviewer | Révision et analyse de PR |
qa |
QA | Tests et assurance de la qualité |
designer |
Designer | Implémentation d’interface et d’expérience utilisateur |
security |
Security | Révision et audit de sécurité |
devops |
DevOps | Infrastructure et déploiement |
pm |
PM | Gestion de produit |
general |
General | Polyvalent et flexible |
Énumération AgentVisibility
Section intitulée “Énumération AgentVisibility”| Valeur | Description |
|---|---|
workspace |
Valeur par défaut; les valeurs stockées inconnues ou nulles s’y résolvent |
private |
Privé, pour l’utilisateur qui l’a créé |
Énumération AgentLifecycleStatus
Section intitulée “Énumération AgentLifecycleStatus”| Valeur | Description |
|---|---|
active |
Valeur par défaut. isDispatchable est vrai uniquement pour cette valeur |
paused |
Défini par l’arrêt ferme du budget. Affiché dans la liste de présence; le lancement accepte tout de même du travail |
archived |
Retiré et masqué des listes de présence actives |
Autorisations
Section intitulée “Autorisations”Un agent ne porte aucun indicateur d’autorisation. Pousser, ouvrir et publier des pull requests, écrire dans un outil de suivi et la sortie réseau sont des classes d’action (gitPush, prCreate, prPublish, vendorSyncWrite, networkEgress) que les garde-fous résolvent à la portée de l’espace de travail, de l’agent ou de l’espace. Le jeton GitHub d’une exécution est toujours limité à la lecture ; les push passent par la passerelle d’exécution d’agent, qui interroge la règle gitPush avant de les transmettre.
AgentSkills
Section intitulée “AgentSkills”Un ensemble immuable et insensible à la casse d’identifiants de skills. Au lancement, ces slugs sont synchronisés sous forme de liens de skills dans le dossier propre à l’agent; le harnais charge ensuite automatiquement le frontmatter des skills liés dans le prompt.
{'flutter', 'dart', 'rest-api'}AgentLiveState (dérivé)
Section intitulée “AgentLiveState (dérivé)”Non stocké. Sept valeurs. L’ordre de déclaration est l’ordre de priorité (sortPriority, figé par un test), soit l’ordre selon lequel la liste de présence trie :
| État | sortPriority |
Condition |
|---|---|---|
running |
0 | Un journal d’exécution a le statut running |
blocked |
1 | La vitalité de la dernière exécution est blocked, stalled ou looping |
failed |
2 | Le statut de la dernière exécution est error, ou sa vitalité est failed ou dead |
queued |
3 | Une exécution est lancée sans s’exécuter — en attente derrière une autre exécution du même agent, ou écrite mais pas encore démarrée |
succeeded |
4 | L’exécution s’est terminée avec succès |
idle |
5 | L’agent a déjà été exécuté et n’a rien en cours |
neverRun |
6 | Aucun journal d’exécution n’existe |
queued et succeeded sont propres à une exécution. deriveAgentLiveState, qui calcule l’état de présence d’un agent, ne produit jamais l’un ou l’autre — il renvoie neverRun, running, failed, blocked ou idle.