Sous-agents Codex

Les sous-agents sont une fonctionnalité avancée de Codex qui vous permet de décomposer de grandes tâches en parties plus petites et de les traiter en parallèle ou séquentiellement. Cette section détaille comment configurer et utiliser les sous-agents.

Qu'est-ce qu'un sous-agent ?

Les sous-agents sont des agents auxiliaires que Codex peut invoquer en parallèle pour gérer différentes parties d'une tâche complexe. En configurant les sous-agents, vous pouvez :

  • Décomposer de grandes tâches en parties gérables
  • Traiter plusieurs tâches indépendantes en parallèle
  • Configurer des agents spécialisés pour différents types de tâches
  • Améliorer l'efficacité lors de la gestion de grands projets

Les sous-agents sont particulièrement adaptés aux scénarios qui nécessitent de traiter plusieurs fichiers ou plusieurs tâches indépendantes en même temps.

Configurer les sous-agents

Configuration de base

Configurer les sous-agents

# Activer la fonctionnalité multi-agent
[features]
multi_agent = true

# Configurer les paramètres de l'agent
[agents]
# Nombre maximal de threads parallèles
max_threads = 6

# Profondeur maximale d'imbrication
max_depth = 1

# Durée maximale d'exécution d'une tâche (secondes)
job_max_runtime_seconds = 1800

Rôles d'agent personnalisés

Vous pouvez définir des rôles d'agent personnalisés dans la configuration :

Définition des rôles d'agent

# Définir un agent de revue de code
[agents.reviewer]
description = "Se concentrer sur la revue de code et les problèmes de qualité"
nickname_candidates = ["Reviewer", "CodeChecker", "QualityBot"]

# Peut pointer vers un fichier de configuration
# config_file = "agents/reviewer.toml"

Utiliser les sous-agents

Invoquer manuellement des sous-agents

Dans Codex, vous pouvez invoquer des sous-agents des manières suivantes :

Appeler des sous-agents

# Utiliser @ pour mentionner des sous-agents
@reviewer, examine le fichier src/auth.py

# Utiliser la commande /agents
/agents run reviewer --task "Examiner tous les fichiers de test"

Utilisation automatique des sous-agents

Codex peut automatiquement choisir d'utiliser des sous-agents en fonction de la tâche. Par exemple, pour une tâche de refactorisation importante, Codex peut automatiquement lancer plusieurs sous-agents pour gérer différents modules.

Comment fonctionnent les sous-agents

Traitement parallèle

Lorsque les tâches peuvent être décomposées en parties indépendantes, les sous-agents peuvent travailler en parallèle :

任务：审查整个代码库
  ├─ 子代理 1：审查 src/auth/ 目录
  ├─ 子代理 2：审查 src/api/ 目录
  ├─ 子代理 3：审查 src/utils/ 目录
  └─ 主代理：汇总结果

Traitement séquentiel

Lorsque les tâches ont des dépendances, les sous-agents travaillent séquentiellement :

任务：实现新功能
  └─ 子代理 1：创建数据模型
       └─ 子代理 2：创建 API 端点
            └─ 子代理 3：编写测试

Profondeur d'imbrication

Le max_depth dans la configuration contrôle le nombre de niveaux d'imbrication des agents :

  • Profondeur 0 : session racine
  • Profondeur 1 : sous-agents directs
  • Profondeur 2 : sous-agents de sous-agents
Il est recommandé de maintenir max_depth à 1 ou 2, car une imbrication trop profonde augmente la complexité et le coût.

Appels d'outils

Les sous-agents peuvent utiliser tous les outils standard de Codex :

  • Lecture et modification de fichiers
  • Exécuter les commandes
  • Utiliser des compétences
  • Appel des serveurs MCP

Résumé des résultats

L'agent principal est responsable d'agréger les résultats de tous les sous-agents et de fournir une sortie unifiée.

Configuration du rôle d'agent

Créer des rôles d'agent personnalisés

Créer des fichiers de configuration des rôles d'agent

# agents/tester.toml

description = "Se concentrer sur l'écriture de tests unitaires et de tests d'intégration"
nickname_candidates = ["Tester", "TestBot", "QABot"]

[behavior]
# Configuration du comportement de l'agent
test_framework = "pytest" # Framework de test préféré
include_coverage = true # Nécessite un rapport de couverture

Référencement dans la configuration principale

Référencement de la configuration de l'agent

[agents.tester]
config_file = "agents/tester.toml"

Surveiller les sous-agents

Affichage des agents actifs

Affichage des agents actifs

# Voir dans Codex
/agents status

# Voir les détails
/agents list

Sortie de l'agent

Codex affiche la sortie de chaque sous-agent et résume les résultats dans l’interface principale.

Un indicateur de progression est affiché pendant l’exécution des sous-agents, vous permettant de comprendre l’état global de la tâche.

Bonnes pratiques

Décomposition des tâches

  • Décomposez les tâches volumineuses en sous-tâches indépendantes
  • Assurez-vous qu’il n’existe pas de fortes dépendances entre les sous-tâches (lorsque la parallélisation est possible)
  • Définissez des entrées et des sorties claires pour chaque sous-tâche

Optimisation de la configuration

  • Ajustez max_threads en fonction de la complexité de la tâche
  • Configurez des rôles d’agent spécialisés pour différents types de tâches
  • Définissez une valeur raisonnable pour job_max_runtime_seconds afin d’éviter les processus de longue durée

Surveillance et débogage

  • Vérifiez régulièrement la sortie des sous-agents
  • Utilisez /agents status pour vérifier la progression globale.
  • Annuler des sous-agents spécifiques lorsque nécessaire
Les sous-agents sont une fonctionnalité avancée ; il est recommandé de vous familiariser avec les opérations de base de Codex avant de les utiliser.

FAQ

Q : Quelle est la différence entre les sous-agents et les compétences ?

Les sous-agents sont des agents IA indépendants qui peuvent effectuer des tâches complexes à plusieurs étapes. Les compétences sont des flux de travail prédéfinis qui se concentrent sur des types de tâches spécifiques.

Q : Quel est le nombre maximum de sous-agents pouvant s'exécuter simultanément ?

Contrôlé via la configuration max_threads, la valeur par défaut est 6. Le nombre réel disponible dépend de votre plan d'abonnement.

Q : Les sous-agents peuvent-ils accéder à mes fichiers ?

Oui, les sous-agents peuvent lire et modifier les fichiers, mais ils sont soumis aux restrictions des politiques de sandbox et de sécurité.

Q : Comment déboguer les problèmes liés aux sous-agents ?

Utilisez /agents status pour vérifier l'état des agents, et examinez leurs journaux de sortie pour localiser les problèmes.

autres extensions