Fonctions

Fonctions codées en tant qu'outils d'agent permettant à un agent d'exécuter du code Python personnalisé en tant qu'outil déterministe basé sur des processus avec des automatisations et des workflows d'API.

L’outil de fonction codée permet à un agent d’exécuter du code Python personnalisé en tant qu’outil. Une fonction encapsule une logique déterministe - transformations de données, calculs ou appels à des systèmes externes - que l'agent invoque lorsque son raisonnement l'appelle, puis raisonne sur le résultat renvoyé.

Une fonction codée se comporte comme les autres outils basés sur des processus disponibles pour un agent, tels que les workflows d'API, les automatisations ou les outils d'agent. L'agent transmet les arguments d'entrée à la fonction, la fonction exécute son code Python et l'agent reçoit la sortie structurée.

Les fonctions sont créées dans Studio Web. Pour plus de détails sur les fonctions d’écriture, de packaging et de publication, consultez le guide de l’utilisateur des fonctions.

Utilisation des fonctions par les Agents

Une fois qu'une fonction est disponible dans votre solution, elle apparaît comme un outil sélectionnable dans la section Outils d'une définition d'agent dans Studio Web. Chaque outil est accompagné d'une description qui aide l'agent à comprendre son objectif et quand l'utiliser.

Lors du runtime, l'agent transmet les paramètres d'entrée à la fonction, la fonction exécute sa logique Python et le résultat renvoie à l'agent sous forme de sortie structurée pour l'étape suivante de son plan. La logique étant un code déterministe, une fonction renvoie la même sortie pour la même entrée, ce qui la rend adaptée à des opérations précises que le modèle de langage ne doit pas effectuer via un raisonnement seul.

Comme les autres types d’outils, les fonctions codées prennent en charge les contrôles de gouvernance de la plate-forme. Vous pouvez configurer des garde-fous pour contrôler quand et comment une fonction est invoquée, et des simulations d'outils pour tester le raisonnement de l'agent sans exécuter le code réel.

Ajouter une fonction en tant qu'outil

Vous pouvez ajouter une fonction existante à partir de vos ressources disponibles ou en créer une nouvelle sans quitter l’agent.

1. Dans le panneau Definition (Définition), sous la section Tools (Outils), sélectionnez Add tool (Ajouter un outil).
2. Sélectionnez Fonction.
3. Ajoutez la fonction:
   • Pour utiliser une fonction existante, recherchez-la ou sélectionnez-la dans les ressources disponibles.
   • Pour créer une nouvelle fonction, sélectionnez Créer nouveau. L'assistant de création de fonctions s'ouvre dans la solution.
4. Utilisez l'invite système pour décrire l'objectif de la fonction et quand l'agent doit l'utiliser. Fournissez la description de chaque argument afin d'aider l'agent à l'utiliser efficacement.

Surveillance de l'exécution de la fonction

Lorsqu’un agent exécute un outil de fonction codé, vous pouvez inspecter l’exécution à deux endroits:

• Traçage de l'agent - Après une exécution de débogage, la piste d'exécution inclut un appel d'outil pour la fonction, affichant les arguments d'entrée qui lui sont transmis et la sortie qu'elle renvoie.
• Orchestrator — La fonction s'exécute sous forme de processus. Sous Surveillance > Tâches dans Orchestrator, la fonction apparaît sous la forme d'une tâche, avec les autres exécutions de tâches de l'agent.