AiHummer
Français
ConnexionCompte
v1.0.x
{ }Swagger

Orchestration et sous-agents

v1.0.x · mis à jour 2026-06-26

Le chef d’orchestre est ce qui transforme un message entrant en réponse. Il assemble une invite système en couches et pilote un boucle d’appel de fonction: le modèle réfléchit, utilise des outils, lit les résultats et répète jusqu’à produire une réponse finale. Par-dessus cette boucle, un agent peut se lancer sous-agents et appliquer facultatif stratégies de raisonnement — tous peuvent être configurés par l’administrateur.

La boucle de virage

Un tour est une boucle d’appel de fonction limitée. Le modèle reçoit l’invite du système, la conversation et les outils disponibles ; il peut appeler un ou plusieurs outils, l’orchestrateur les exécute et renvoie les résultats, et la boucle continue jusqu’à ce que le modèle retourne un message final. Les outils, la mémoire et les connaissances arrivent toujours sous forme de résultats de l’outil, jamais sous forme d’instructions injectées — c’est ce qui rend la boucle résistante à l’injection de prompt.

prompt + tools ─▶ model ─▶ tool calls ─▶ results ─▶ model ─▶ ... ─▶ final reply

Sous-agents

Un agent peut générer des sous-agents gérer une sous-tâche et renvoyer un résultat à l’appelant. Cela permet à un agent coordinateur de déléguer un travail ciblé — recherche, rédaction, une recherche spécialisée — sans surcharger un seul contexte.

La récursion est limitée : la profondeur maximale d’imbrication est contrôlée par AIHUMMER_SUBAGENT_MAX_DEPTH. Cela empêche la prolifération incontrôlée et maintient le coût et la latence d’un tour prévisibles.

[!WARNING] Les sous-agents multiplient le travail. Garder AIHUMMER_SUBAGENT_MAX_DEPTH conservateur sur hôtes partagés — chaque niveau de profondeur supplémentaire peut multiplier les appels d’outils et le modèle utilisation.

Stratégies de raisonnement

Au-delà de la boucle simple, l’orchestrateur offre des options stratégies de raisonnement. Ils sont désactivés sauf si activés, et chacun est configurable depuis l’interface d’administration sous le Agent · Raisonnement groupe de paramètres.

Stratégie Ce que cela fait
Étapes du plan L’agent rédige un plan avant d’agir, puis suit les étapes.
Réfléchir L’agent critique et révise son propre brouillon avant de répondre.
Débat N les agents discutent sur un certain nombre de tours, puis un juge choisit le gagnant.
Meilleur-de-N Générez plusieurs réponses possibles et choisissez la meilleure.
S’auto-guérir En cas d’échec, l’agent diagnostique et réessaie au lieu d’abandonner.

[!TIP] Les stratégies de raisonnement échangent la latence et le coût en jetons contre la qualité. Activez-les sélectivement pour les agents et les tâches qui en ont besoin plutôt que globalement.

Graphiques d’agent

Pour les flux de travail multi-agents qui sont plus structurés que les appels de sous-agents ad hoc, AiHummer prend en charge graphes d’agents — câblage explicite des agents dans un flux de travail. Les graphiques sont gérés depuis l’interface d’administration et l’API d’administration sous /v1/admin/graphs/*.

L’interface d’administration Graphiques la page est un visuel éditeur de organigramme: les nœuds du graphe sont déplacés sur une toile, les arêtes entre eux sont dessinées sous forme de flèches, une palette ajoute de nouveaux nœuds, et un panneau latéral permet de modifier les paramètres du nœud sélectionné. La définition du graphe (nœud de départ, limite d’étapes, nœuds et transitions) est stockée sous forme de JSON — le basculeur “Exporter/Importer JSON” l’ouvre pour inspection, transfert entre instances et édition manuelle.

Résumé de la configuration

Bouton
Profondeur maximale du sous-agent AIHUMMER_SUBAGENT_MAX_DEPTH (env ; rechargement à chaud)
Stratégies de raisonnement Groupe de paramètres Agent · Raisonnement
Graphiques d’agent /v1/admin/graphs/*

[!NOTE] La profondeur du sous-agent et l’activation des outils font partie des paramètres qui s’appliquent chaud (pas de redémarrage). D’autres paramètres peuvent nécessiter un redémarrage — voir la configuration modèle dans le guide de démarrage.

Où aller ensuite

  • Voyez ce que la boucle peut appeler Outils.
  • Apprenez comment un message choisit son agent de départ dans Routage.
  • Configurez les agents eux-mêmes dans Agents et personas.