Invocation en tant que sous-agents

Les sous-agents vous permettent de déléguer des tâches ciblées à des agents qui s'exécutent dans leur propre contexte isolé. L'agent principal génère des sous-agents lorsqu'une tâche profite du parallélisme, d'outils spécialisés ou de l'isolation du contexte, puis regroupe les résultats une fois ceux-ci terminés.

Sur Web et Mobile, l'agent délègue uniquement aux sous-agents intégrés de Kiro; les agents personnalisés définis dans .kiro/agents/ peuvent être invoqués comme sous-agents depuis l'IDE et la CLI.

1. Attribution de la tâche - Vous décrivez une tâche (ou l'agent principal en repère une qui profite de la délégation)
2. Sélection de l'agent - Kiro sélectionne la configuration d'agent appropriée en fonction de la tâche et des agents disponibles
3. Exécution isolée - Le sous-agent s'exécute avec sa propre fenêtre de contexte, ses propres outils et permissions
4. Retour des résultats - Une fois terminé, le sous-agent retourne ses constatations à l'agent principal

Tout agent personnalisé peut être invoqué comme sous-agent. L'agent principal sélectionne automatiquement les agents en fonction de leur champ description, ou vous pouvez en demander un explicitement :

Use the code-reviewer agent to analyze src/auth/ for security issues

Les sous-agents partagent l'environnement de l'espace de travail, mais s'exécutent avec un contexte de conversation isolé :

Kiro comprend deux sous-agents internes utilisés automatiquement lorsque cela convient :

• Collecte de contexte - Explore la structure de votre projet et rassemble les fichiers et le contexte pertinents
• Usage général - Traite des tâches parallélisées de tout type en utilisant la configuration d'agent par défaut

Vous n'avez pas besoin de configurer ces éléments - l'agent principal les utilise selon les besoins.

Les sous-agents s'exécutent en parallèle, chacun travaillant de façon indépendante. Cela est utile pour :

• Refactoriser plusieurs fichiers simultanément
• Faire des recherches sur plusieurs sujets en parallèle
• Exécuter des pistes d'analyse indépendantes

Refactor these three services to use the new auth middleware - do them in parallel

Les sous-agents prennent en charge les graphes orientés acycliques (DAG) où les tâches dépendent les unes des autres. L'agent principal planifie l'ensemble du graphe de tâches à l'avance, puis exécute dans le bon ordre - en exécutant les tâches indépendantes en parallèle et en attendant les dépendances avant de démarrer les tâches dépendantes.

  ┌─────────────┐
  │  1. Analyze  │
  │ dependencies │
  └──────┬───────┘
         │
  ┌──────▼───────┐
  │ 2. Refactor  │
  │   modules    │
  └──────┬───────┘
         │
  ┌──────▼───────┐
  │  3. Run and  │
  │  fix tests   │
  └──────────────┘

Une étape peut revenir à une étape antérieure lorsque son résultat indique que du travail supplémentaire est nécessaire - par exemple, un réviseur renvoie le travail à un exécutant pour des révisions.

Implement the feature, then have a reviewer check it and send it back for fixes until it passes

L'agent construit un pipeline en boucle avec :

• target - l'étape à réexécuter lorsque la boucle se déclenche
• trigger - le texte dans le résultat de l'étape qui déclenche la boucle (p. ex., NEEDS_CHANGES)
• max_iterations - plafond de sécurité (entre 1 et 10)

Contraintes :

• Une étape ne peut pas revenir à elle-même
• Les boucles mutuelles (A → B → A) sont rejetées
• Le déclencheur doit comporter au moins quatre caractères

Le sous-agent par défaut dispose des mêmes outils intégrés que l'agent principal - read, write, shell, web_search, web_fetch, et tout outil MCP configuré.

Lorsque vous déléguez à un agent personnalisé, le sous-agent utilise la configuration tools et permissions de cet agent. Les outils non répertoriés dans la configuration de l'agent personnalisé ne seront pas disponibles pour le sous-agent.

Contrôlez quels agents peuvent être générés et lesquels s'exécutent sans invites d'approbation en utilisant toolsSettings.subagent dans votre configuration d'agent :

{
  "toolsSettings": {
    "subagent": {
      "availableAgents": ["reviewer", "tester", "docs-*"],
      "trustedAgents": ["reviewer", "tester"]
    }
  }
}

Pour restreindre les outils qu'un sous-agent peut utiliser, configurez tools dans le fichier de configuration du sous-agent lui-même plutôt que dans le parent.

1. Utiliser pour les tâches complexes - Le plus utile pour les opérations à plusieurs étapes qui profitent de l'isolation ou du parallélisme
2. Fournir des instructions claires - Des descriptions de tâches précises entraînent une meilleure sélection d'agent et de meilleurs résultats
3. Surveiller la progression - Dans la CLI, utilisez Ctrl+G pour vérifier l'état des sous-agents de longue durée
4. Configurer l'accès - Utilisez availableAgents et trustedAgents pour les agents orchestrateurs qui génèrent de nombreux sous-agents