Définition des actions dans le groupe d’actions
Vous pouvez définir des groupes d’actions de l’une des manières suivantes (vous pouvez utiliser différentes méthodes pour différents groupes d’actions) :
-
Configurez un schéma OpenAPI avec des descriptions, une structure et des paramètres qui définissent chaque action du groupe d’actions comme une opération d’API. Cette option vous permet de définir des actions de manière plus explicite et de les associer aux opérations d’API de votre système. Vous ajoutez le schéma API au groupe d’actions de l’une des manières suivantes :
-
Chargez le schéma que vous créez dans un compartiment Amazon Simple Storage Service (Amazon S3).
-
Écrivez le schéma dans l’éditeur de schéma OpenAPI en ligne dans la AWS Management Console lorsque vous ajoutez le groupe d’actions. Cette option n’est disponible qu’une fois que l’agent auquel appartient le groupe d’actions a déjà été créé.
-
-
Configurez les détails de la fonction avec les paramètres que l’agent doit obtenir de l’utilisateur. Cette option vous permet de simplifier le processus de création du groupe d’actions et de configurer l’agent pour obtenir un ensemble de paramètres que vous définissez. Vous pouvez ensuite transmettre les paramètres à votre application et personnaliser la façon de les utiliser pour exécuter l’action dans vos propres systèmes.
En poursuivant l’exemple ci-dessus, vous pouvez définir l’action CreateBooking de l’une des manières suivantes :
-
À l’aide d’un schéma d’API,
CreateBookingpeut être une opération d’API avec un corps de demande comprenant des champs tels queHotelName,LengthOfStayetUserEmailet un corps de réponse renvoyantBookingId. -
En utilisant les détails de la fonction,
CreateBookingpeut être une fonction définie avec des paramètres tels queHotelName,LengthOfStayetUserEmail. Une fois que votre agent a obtenu les valeurs de ces paramètres auprès de l’utilisateur, vous pouvez les transmettre à vos systèmes.
Lorsque votre agent interagit avec l’utilisateur, il détermine quelle action il doit invoquer au sein d’un groupe d’actions. L’agent demandera ensuite les paramètres et autres informations nécessaires pour traiter la demande d’API ou qui sont indiqués comme obligatoires pour la fonction.
Sélectionnez une rubrique pour découvrir comment définir un groupe d’action à l’aide de différentes méthodes.