Les agents déclaratifs utilisent des plugins API pour communiquer avec des API afin de lire et modifier des données. Chaque fois qu’un utilisateur soumet une invite (1), l’agent déclaratif évalue l’invite pour vérifier s’il existe des fonctions appropriées à invoquer (2). S’il trouve une fonction correspondant à l’invite de l’utilisateur, il s’authentifie si nécessaire (3a, 3b). Ensuite, il construit la requête API nécessaire, appelle l’API (3c), traite sa réponse (3d) et construit une réponse pour l’utilisateur (6). Le diagramme suivant montre ce processus plus en détail :

Comment l’agent sait-il quelle fonction invoquer ?

Lorsque vous créez un plugin API, vous définissez son nom, sa description et une ou plusieurs fonctions. Pour chaque fonction, vous spécifiez une description. L’agent déclaratif utilise toutes ces informations pour déterminer quelle fonction il doit invoquer. Chaque fois qu’un utilisateur soumet une invite à votre agent déclaratif, celui-ci utilise son modèle de langage sous-jacent pour évaluer l’invite par rapport aux descriptions disponibles du plugin et des fonctions, afin de décider s’il existe une fonction appropriée à invoquer.

Une fois que l’agent sélectionne une fonction à invoquer, il associe cette fonction à l’opération dans la spécification de l’API. En se basant sur les informations de l’API, il construit la requête API et traite la réponse de l’API.

Unité suivante : Quand utiliser les plugins API