AIAgent / init_agent

源码版本v2026.7.20

Responsabilité

init_agent est l'« atelier d'assemblage » de l'agent : il injecte dans l'instance agent la configuration du provider, des toolsets, des seuils de compression, du extra_body personnalisé du provider, des composants de mémoire et d'apprentissage, afin qu'il dispose de toutes les dépendances nécessaires pour exécuter un tour de conversation. La classe AIAgent elle-même n'est qu'une coquille fine autour du produit qu'il crée.

Fichiers clés

• class AIAgent:400-497 — définition de classe, les champs sont la configuration
• __init__ forwarder:497-560 — from agent.agent_init import init_agent; init_agent(...)
• def init_agent:276 — entrée de la fonction principale d'assemblage
• helpers extra_body provider custom:183-275 — _normalized_custom_base_url / _custom_provider_model_matches / _merge_custom_provider_extra_body
• _resolve_compression_threshold:93-127 — résolution du seuil de compression
• zone de helpers:62-91 — _ra, notice autoraise, etc.

Flux de données

1. AIAgent.__init__ (run_agent.py:423) collecte tels quels les paramètres du constructeur.
2. Appelle init_agent:276, qui dans l'ordre :
   • résout le nom et l'URL de base du provider (agent/agent_init.py:183)
   • fusionne le extra_body du provider personnalisé (agent/agent_init.py:257)
   • résout le seuil de compression (agent/agent_init.py:93)
   • injecte les toolsets, le gestionnaire de mémoire, le graphe d'apprentissage, etc.
3. L'agent assemblé expose la méthode run_conversation (run_agent.py:6350), transférée au run_conversation au niveau module (agent/conversation_loop.py:588).
4. Le GatewayRunner de la passerelle (gateway/run.py:3029) détient l'agent assemblé et lui confie les messages entrants.

Résumé

init_agent est la couche de traduction configuration → runtime : toutes les décisions de démarrage (choix du provider, stratégie de compression, activation des toolsets) sont figées ici en une fois. Ensuite l'agent entre dans un rythme sans état « alimente un message → lance la boucle » et ne revient plus modifier la configuration.