Utiliser un Agent dans un processus
Le node Agent task sélectionne directement un Agent, une révision exacte et une activité. Il mappe ensuite les inputs de cette activité et peut, indépendamment, utiliser ou non une Mémoire Agent.
Agent, révision et activité sont sélectionnés sur le node
Agent task porte la dépendance exécutable complète. La Mémoire Agent est un canal d’invocation optionnel, séparé du choix de l’Agent.
Dans le Process Builder, la configuration suit l’ordre Agent → révision → activité. Une fois l’activité choisie, l’inspecteur affiche uniquement ses inputs à mapper. Cette séquence est comparable à un sous-processus : la dépendance est choisie avant d’exposer son contrat d’entrée.
Chaque Agent Task pinne une révision précise
La révision sélectionnée fige l’objectif général, les instructions, le provider de modèle et le modèle, ainsi que le contrat complet des activités. Le node conserve cette dépendance exacte : publier une nouvelle révision de l’Agent ne change jamais silencieusement un processus déjà publié.
Inputs, outputs et routes suivent l’activité
Les paramètres configurables du node sont les inputs déclarés par l’activité sélectionnée. Le processus les alimente avec les bindings ou expressions usuels ; les Tools, consignes et guardrails restent dans la révision Agent et ne sont pas recopiés dans le Process Builder.
Les outputs ne sont pas une configuration de l’inspecteur : ils deviennent des sources typées pour les nodes aval. Si l’activité désigne un output de routage, les valeurs de ce choix deviennent les branches du node sur le canvas.
Cette frontière évite un contexte implicite : les nouvelles informations métier passent par les inputs, tandis qu’une éventuelle continuité de travail passe par la Mémoire Agent.
La Mémoire Agent est une option d’invocation séparée
Chaque Agent Task choisit indépendamment sa source de mémoire. Le choix par défaut est de n’en utiliser aucune.
| Source | Comportement |
|---|---|
| None | Le Run s’exécute sans continuité mémoire. Il reste durable et observable. |
| Memory object | Un binding ou une expression fournit une valeur typée platform.agent_memory. La mémoire doit appartenir au même Agent que le node. |
| Agent role | Le rôle sert uniquement de namespace de continuité. La première utilisation résout ou crée la Mémoire Agent correspondant à l’instance, au rôle et à l’Agent sélectionné sur ce node. |
Deux Agents différents utilisant le même rôle ne partagent donc pas implicitement leur mémoire. À l’inverse, deux révisions du même Agent peuvent retrouver la même Mémoire Agent lorsqu’elles utilisent la même continuité.
Certaines activités déclarent des required_activities. Dans ce cas, une source de mémoire est obligatoire et la mémoire admise doit déjà contenir les contributions réussies demandées. Voir Mémoire Agent.