Passer au contenu principal
Afficher en Markdown

Effort de raisonnement

L'effort de raisonnement contrôle la quantité de réflexion que le modèle applique à vos requêtes. Des niveaux d'effort plus bas produisent des réponses plus rapides et plus courtes et utilisent moins de crédits. Des niveaux plus élevés consacrent plus de jetons à une analyse plus approfondie, à un raisonnement en plusieurs étapes et à une génération de code approfondie.

CapacitéIDECLIWebMobile
Sélection de l'effort de raisonnement✓✓✓—

Niveaux disponibles :

NiveauComportement
lowRéponses rapides et concises. Convient pour les questions simples et les recherches rapides.
mediumRaisonnement équilibré. Convient pour la plupart des tâches de développement.
highAnalyse approfondie. Mieux adapté pour le remaniement complexe et les décisions d'architecture.
xhighRaisonnement étendu. Utile pour les modifications multi-fichiers et les problèmes nuancés.
maxProfondeur maximale. Idéal pour le débogage difficile, l'analyse de sécurité et la logique complexe.

Tous les modèles ne prennent pas en charge tous les niveaux. Le sélecteur affiche uniquement les niveaux disponibles pour votre modèle actuel. Consultez les exemples de configuration du raisonnement pour connaître les schémas de modèles courants.

Le schéma de configuration d'un modèle peut aussi déclarer un niveau interne default. Il n'est jamais proposé comme choix, et un modèle qui ne déclare que default n'affiche aucun sélecteur, puisqu'il n'y a rien à choisir.

Définir le niveau d'effort

Cliquez sur le bouton du modèle dans la barre de saisie du clavardage pour ouvrir le panneau Model. Utilisez Filter models au besoin, puis sélectionnez un modèle ou Auto.

Lorsque le modèle sélectionné prend en charge l'effort de raisonnement, un curseur Effort apparaît sous la liste des modèles. Choisissez un niveau à l'aide du curseur; la modification s'applique à cette conversation à partir de votre prochain message. Pour rétablir le niveau par défaut du modèle, choisissez l'action de réinitialisation Default: <level>. Cette action n'est pas un autre niveau d'effort.

Vous pouvez régler Effort et, lorsque le modèle sélectionné le prend en charge, Thinking avant d'envoyer votre premier message dans une session locale. Kiro conserve ce choix au démarrage de la session.

Le bouton du modèle affiche le modèle sélectionné ou Auto, sans le niveau d'effort. Survolez-le pour voir le modèle et le niveau d'effort actuels dans l'infobulle.

Dans l'IDE, les contrôles d'effort n'apparaissent que pour les sessions locales. Les brouillons de nouvelle session dans Agent Focus Mode et les sessions cloud ne les affichent pas.

Exemples de configuration du raisonnement

Chaque modèle qui prend en charge l'effort définit les valeurs qu'il accepte pour les champs liés au raisonnement dans son schéma de configuration. Les tableaux ci-dessous présentent des schémas courants et ne constituent pas une liste exhaustive des modèles pris en charge. Utilisez les sélecteurs de modèle et d'effort de votre surface pour voir les modèles et les niveaux qui vous sont actuellement accessibles.

Dans ces exemples, output_config.effort répertorie les niveaux d'effort disponibles; thinking.type et thinking.display contrôlent le comportement et la visibilité du raisonnement; et max_tokens définit la limite de longueur de sortie.

Les exemples Claude utilisent output_config.effort avec les contrôles thinking.type et thinking.display :

Modèlethinking.typethinking.displayoutput_config.effortmax_tokens
Claude Opus 5adaptive, disabledsummarized, omittedlow, medium, high, xhigh, max1024–128000
Claude Opus 4.8adaptive, disabledsummarized, omittedlow, medium, high, xhigh, max1024–128000
Claude Opus 4.7adaptive, disabledsummarized, omittedlow, medium, high, xhigh, max1024–64000
Claude Opus 4.6adaptive, disabledsummarized, omittedlow, medium, high, max1024–64000
Claude Sonnet 5.5adaptive, between_toolssummarized, omittedlow, medium, high, xhigh, max1024–64000
Claude Sonnet 5adaptive, disabledsummarized, omittedlow, medium, high, xhigh, max1024–128000
Claude Sonnet 4.6adaptive, disabledsummarized, omittedlow, medium, high, max1024–64000

Les modèles GPT-5.6 utilisent reasoning.effort :

Modèlereasoning.effort
GPT-5.6 Terranone, low, medium, high, xhigh, max
GPT-5.6 Solnone, low, medium, high, xhigh, max
GPT-5.6 Lunanone, low, medium, high, xhigh, max

Les modèles GPT-5.6 utilisent par défaut effort: "high".

Persistance de votre niveau d'effort (CLI)

Votre choix d'effort dans /model persiste automatiquement. /effort <level> modifie uniquement la session en cours; exécutez /effort set-current-as-default pour enregistrer ce niveau pour le modèle actuel. Dans V3, --effort et --model s'appliquent uniquement à la session démarrée par Kiro et ne sont pas enregistrés comme valeurs par défaut. Les préférences sont stockées dans ~/.kiro/settings/cli.json. Consultez Paramètres en session pour en savoir plus sur la persistance des préférences.

Valeurs par défaut persistantes (CLI)

Pour définir des paramètres de modèle par défaut par modèle - afin de ne pas avoir à exécuter /effort au début de chaque session - ajoutez chat.modelDefaults à votre fichier de paramètres :

Modèles Claude (utilisent output_config.effort) :

json
{ "chat.modelDefaults": { "claude-sonnet-4.6": { "output_config": { "effort": "high" } }, "claude-opus-4.7": { "output_config": { "effort": "max" } } } }

Modèles GPT-5.6 (utilisent reasoning.effort) :

json
{ "chat.modelDefaults": { "gpt-5.6-sol": { "reasoning": { "effort": "max" } }, "gpt-5.6-terra": { "reasoning": { "effort": "low" } } } }

Configuration du comportement de réflexion

Contrôlez si le modèle utilise le raisonnement étendu et comment il affiche son raisonnement :

json
{ "chat.modelDefaults": { "claude-opus-4.8": { "thinking": { "type": "adaptive", "display": "summarized" } }, "claude-sonnet-4.6": { "thinking": { "type": "disabled" } } } }
  • thinking.type - adaptive active le raisonnement étendu lorsque le modèle détermine que c'est nécessaire; disabled le désactive entièrement sur les modèles qui prennent en charge cette valeur. Claude Sonnet 5.5 utilise between_tools au lieu de disabled; ce paramètre applique le réglage de réflexion le plus faible entre les appels d'outils et prend en charge les efforts low, medium et high.
  • thinking.display - summarized affiche une version condensée du raisonnement; omitted le masque de la sortie. S'applique seulement lorsque type est adaptive.

Configuration du nombre maximal de jetons de sortie

Définissez le nombre maximal de jetons que le modèle peut générer par réponse :

json
{ "chat.modelDefaults": { "claude-opus-4.8": { "max_tokens": 128000 }, "claude-sonnet-4.6": { "max_tokens": 32000 } } }

Exemples de limites de max_tokens :

ModèleMinimumMaximum
Claude Opus 4.81024128000
Claude Opus 4.7102464000
Claude Opus 4.6102464000
Claude Sonnet 5.5102464000
Claude Sonnet 51024128000
Claude Sonnet 4.6102464000
GPT-5.6 Terra1024128000
GPT-5.6 Sol1024128000
GPT-5.6 Luna1024128000

Combinaison de toutes les options

Vous pouvez combiner output_config, thinking et max_tokens dans une seule entrée de modèle :

Exemple Claude :

json
{ "chat.modelDefaults": { "claude-opus-4.8": { "output_config": { "effort": "max" }, "thinking": { "type": "adaptive", "display": "summarized" }, "max_tokens": 128000 } } }

Exemple GPT-5.6 :

json
{ "chat.modelDefaults": { "gpt-5.6-sol": { "reasoning": { "effort": "max" }, "max_tokens": 128000 } } }

Pour ouvrir votre fichier de paramètres dans votre éditeur :

bash
kiro-cli settings open

Ou placez un fichier .kiro/settings/cli.json dans la racine de votre projet pour définir des valeurs par défaut au niveau de l'espace de travail qui s'appliquent à tous ceux qui travaillent dans ce dépôt.

Priorité

Lors de la détermination du niveau d'effort pour une session, Kiro applique cet ordre de priorité :

  1. Substitution de session - valeur définie au moyen du paramètre Effort dans /model, de /effort <level> ou de --effort durant la session actuelle. Dans V3, /clear conserve cette valeur; /chat new repart des valeurs par défaut enregistrées ci-dessous
  2. Valeurs par défaut de l'espace de travail - chat.modelDefaults dans .kiro/settings/cli.json
  3. Valeurs par défaut de l'utilisateur - chat.modelDefaults dans ~/.kiro/settings/cli.json
  4. Valeurs par défaut intégrées - le niveau d'effort standard du modèle

Quand ajuster l'effort

  • Augmentez lorsque l'agent donne des réponses superficielles, manque des cas limites ou produit des implémentations incomplètes
  • Diminuez lorsque vous avez besoin de réponses rapides et ne voulez pas attendre un raisonnement étendu
  • Utilisez max pour les révisions de sécurité, les sessions de débogage complexes, ou lorsque vous avez besoin que l'agent prenne en compte de nombreuses contraintes interdépendantes

Voir aussi

Page mise à jour : 11 novembre 2026