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 pas à pas de création ou de modification d’un agent dans l’application, consultez Créer et configurer un agent.

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	Intitulé 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 (jamais nul)
`reportsTo`	`String?`	Non	Identifiant de l’agent parent
`skills`	`AgentSkills`	Oui	Ensemble d’identifiants de skills
`persona`	`String?`	Non	Instructions de comportement en texte libre
`systemPrompt`	`String?`	Non	Remplace le 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	Par défaut `false`. Écrit dans la ligne et dans l’`AGENTS.md` de l’agent
`effort`	`String?`	Non	Identifiant du niveau de raisonnement (par 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 (par défaut `0`, illimité)
`silenceTimeoutMinutes`	`int?`	Non	Remplacement du délai de silence en minutes ; doit être nul ou compris entre 1 et 240 (vérifié par le constructeur)
`maxConcurrentTasks`	`int`	Non	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 file d’attente y sont comparés)
`visibility`	`AgentVisibility`	Non	Par défaut `workspace`
`lifecycleStatus`	`AgentLifecycleStatus`	Non	Statut de gouvernance (par défaut `active`). Écrit par l’arrêt net du budget et affiché dans l’organigramme et la liste de présence. Le lancement accepte toujours du travail d’un agent `paused`
`budgetPolicyId`	`String?`	Non	Identifiant de la politique budgétaire partagée ; lorsqu’il est nul, `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). Un monthlyBudgetCents par défaut de 0 signifie illimité. Définissez un plafond avec agents.upsert.

Énumération AgentRole

Rôle	Libellé	Description
`ceo`	CEO	Coordination et délégation
`coder`	Coder	Implémentation de code
`reviewer`	Reviewer	Revue de PR et analyse
`qa`	QA	Tests et assurance qualité
`designer`	Designer	Implémentation UI/UX
`security`	Security	Revue et audit de sécurité
`devops`	DevOps	Infrastructure et déploiement
`pm`	PM	Gestion de produit
`general`	General	Polyvalent, tous usages

Énumération AgentVisibility

Valeur	Description
`workspace`	La valeur par défaut ; les valeurs stockées inconnues ou nulles y sont résolues
`private`	Privé pour l’utilisateur qui l’a créé

Énumération AgentLifecycleStatus

Valeur	Description
`active`	La valeur par défaut. `isDispatchable` n’est vrai que pour cette valeur
`paused`	Défini par l’arrêt net du budget. Affiché dans la liste de présence ; le lancement accepte toujours du travail
`archived`	Retiré et masqué des listes de présence actives

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

Un ensemble immuable et insensible à la casse d’identifiants de skills. Au lancement, ces slugs sont synchronisés comme liens de skills dans le répertoire superposé de l’agent ; le harnais charge ensuite automatiquement le frontmatter des skills liés dans le prompt.

{'flutter', 'dart', 'rest-api'}

AgentLiveState (dérivé)

Non stocké. Sept valeurs. L’ordre de déclaration est l’ordre de priorité (sortPriority, épinglé par un test), qui est l’ordre de tri de la liste de présence :

État	`sortPriority`	Condition
`running`	0	Un journal d’exécution a le statut `running`
`blocked`	1	L’état de vivacité de la dernière exécution est `blocked`, `stalled` ou `looping`
`failed`	2	Le statut de la dernière exécution est `error`, ou son état de vivacité est `failed` ou `dead`
`queued`	3	Une exécution est lancée mais ne s’exécute pas — 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 s’est déjà 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 d’un agent dans la liste de présence, ne produit jamais ni l’un ni l’autre — il renvoie neverRun, running, failed, blocked ou idle.