logo
Développement
AperçuEspaceDéveloppementEspaceDeTravailRéférenceAPIMeilleurePratiqueJournalDesModifications
Rechercher
Français
EspaceDeTravail / ParamètresApp / GestionSousAgents
Enregistrement et gestion des sous-agents
Dernière mise à jour：9 days ago

Enregistrement et gestion des sous-agents

Vue d'ensemble

La page de gestion des sous-agents sert à pré-enregistrer des sous-agents dotés d'une configuration spécifique. Les sous-agents pré-enregistrés sont automatiquement injectés dans l'invite système de l'Agent principal, qui les sélectionne et les appelle automatiquement lorsqu'il rencontre une tâche correspondante.

Page de gestion des sous-agents-CN

Configuration des sous-agents pré-enregistrés

Configuration de base

Paramètre Description Obligatoire
name Nom du sous-agent Oui
description Description des capacités (injectée dans l'invite système de l'Agent parent) Oui
systemPrompt Définition de l'identité/du rôle Oui

Configuration des outils

Paramètre Description
tools Liste blanche d'outils (si omis, hérite de tous les outils du parent)
disallowedTools Liste noire d'outils (exclut certains outils sur la base des outils hérités)
skills Liste des ID de compétences disponibles
mcpServers Liste des noms de serveurs MCP disponibles

Configuration d'exécution

Paramètre Description Valeur par défaut
model Remplace le modèle LLM du parent Hérite du parent
maxTurns Nombre maximal de tours de boucle 50
canSpawn Peut créer des sous-agents subordonnés false
maxSpawnDepth Profondeur d'imbrication maximale (1-3) 1

Opérations de gestion

Opération Description
Ajouter Créer un nouveau sous-agent pré-enregistré
Modifier Modifier la configuration d'un sous-agent existant
Supprimer Retirer un sous-agent pré-enregistré
Trier Ajuster l'ordre des sous-agents dans la liste

Interaction avec la conversation Work

Les sous-agents pré-enregistrés interagissent avec la conversation Work des manières suivantes :

  1. Injection dans l'invite système : le name et la description du sous-agent sont listés dans l'invite système de l'Agent principal
  2. Correspondance automatique : le LLM sélectionne automatiquement le sous-agent approprié en fonction de la sémantique du message de l'utilisateur
  3. Appel manuel : l'utilisateur peut spécifier l'utilisation d'un sous-agent donné dans la conversation

Exemples de cas d'usage

Nom du sous-agent Description Outils de prédilection
Réviseur de code Chargé de la révision de code et de l'analyse de qualité Read File, Search Files, Glob
Rédacteur de documentation Chargé de rédiger et de mettre en forme la documentation Write File, Edit, Web Fetch
Assistant de recherche Chargé de la recherche d'informations et de la collecte de données Web Fetch, Search Files
Analyste de données Chargé du traitement et de l'analyse des données Bash, Read File, Write File

Guide pratique : créer un sous-agent pré-enregistré

Étapes

  1. Ouvrez APP → Paramètres → Sous-agents
  2. Cliquez sur Ajouter un sous-agent
  3. Renseignez les informations de base :
    • Nom : par exemple « Réviseur de code »
    • Description : par exemple « Chargé de réviser la qualité du code, de détecter les bugs potentiels et de proposer des optimisations » (cette description est injectée dans l'invite système de l'Agent principal pour l'aider à déterminer quand l'appeler)
    • Invite système : par exemple « Vous êtes un expert chevronné en révision de code, attentif à la qualité, aux performances, à la sécurité et à la maintenabilité du code... »
  4. (Facultatif) Configurez la liste blanche/noire d'outils
  5. (Facultatif) Remplacez le modèle ou ajustez maxTurns
  6. Enregistrez

Exemple de configuration : sous-agent « Réviseur de code »

名称: 代码审查员 描述: 负责审查代码质量、发现潜在 bug、提供优化建议。擅长多语言代码分析。 系统提示: 你是一位资深代码审查专家。你的职责是： 1. 分析代码质量和可维护性 2. 发现潜在的 bug 和安全漏洞 3. 提供具体的优化建议 请对每个问题给出严重等级（低/中/高）和修复建议。 工具白名单: Read File, Search Files, Glob Files（只需要读取能力，不需要修改） 模型: Claude Sonnet 4（推理能力强） maxTurns: 30 canSpawn: false（不需要再委派）
                      
                      名称: 代码审查员
描述: 负责审查代码质量、发现潜在 bug、提供优化建议。擅长多语言代码分析。
系统提示: 你是一位资深代码审查专家。你的职责是：
  1. 分析代码质量和可维护性
  2. 发现潜在的 bug 和安全漏洞
  3. 提供具体的优化建议
  请对每个问题给出严重等级（低/中/高）和修复建议。
工具白名单: Read File, Search Files, Glob Files（只需要读取能力，不需要修改）
模型: Claude Sonnet 4（推理能力强）
maxTurns: 30
canSpawn: false（不需要再委派）
Ce bloc de code dans la fenêtre flottante

Impact concret de maxSpawnDepth

Réglage Signification Cas d'usage Impact sur les coûts
1 (par défaut) Le sous-agent ne peut pas créer de sous-agents subordonnés Tâches spécialisées simples Faible
2 Le sous-agent peut créer un niveau de sous-agents supplémentaire Tâches moyennement complexes nécessitant une seconde décomposition Moyen
3 Profondeur d'imbrication maximale, permettant une délégation à trois niveaux Tâches multi-étapes hautement complexes Élevé (chaque niveau de sous-agent consomme des tokens de façon indépendante)

Remarque : chaque niveau de sous-agent démarre une boucle d'Agent (Agent Loop) indépendante (50 tours par défaut) et consomme des tokens LLM indépendants. Une profondeur de 3 signifie qu'au maximum 4 Agents peuvent s'exécuter simultanément (le principal + 3 niveaux de sous-agents), et le coût peut être plusieurs fois supérieur à celui d'un Agent unique.

Pré-enregistrement vs création automatique : comment choisir ?

Comparaison Pré-enregistrement (dispatch_sub_agent) Création automatique (create_local_sub_agent)
Configuration Configuré à l'avance, une fois pour toutes Créé temporairement par l'Agent selon les besoins
Cohérence Utilise la même configuration à chaque fois, résultats stables L'Agent peut attribuer une identité et des outils différents à chaque fois
Cas d'usage adapté Rôles spécialisés fréquemment réutilisés Décomposition ponctuelle de tâches temporaires
Invite système Injectée automatiquement dans l'Agent principal, qui sait qu'il peut l'utiliser L'Agent décide de manière autonome de créer ou non

Conseil : si vous avez souvent besoin d'un certain type de tâche (révision de code, rédaction de documentation, analyse de données), créez un sous-agent pré-enregistré. Pour une décomposition ponctuelle et occasionnelle de tâches, laissez l'Agent le créer automatiquement.

Documents associés