Il est possible que vous ayez une API qui peut accepter plusieurs paramètres de demande, mais qu’ils ne soient pas tous obligatoires pour que l’appel réussisse. Si un paramètre est attendu, mais n’est pas fourni, il est possible que l’intégration échoue, car l’API attend une valeur valide, qu’il s’agisse d’une chaîne vide « ”” » ou « null ». Dans ce cas, vous devrez invalider ces paramètres dans le créateur d’intégration pour que l’appel n’échoue pas.
Pour invalider les paramètres facultatifs
- Analysez le comportement des paramètres facultatifs.
Commencez pas vous assurer que votre API est capable de traiter correctement les valeurs facultatives, que ce soit comme des chaînes vides ou « null ». - Au début du chat, initialisez les paramètres facultatifs sur « null » ou sur une chaîne vide.
Cela évitera l’échec de l’appel API en cas d’omission d’un paramètre. Pour en savoir plus, consultez À propos des actions pour les agents IA.
- Dans l’intégration dans le créateur d’intégration, assurez-vous que les paramètres sont recueillis comme paramètres de demande et que la case Obligatoire n’est pas cochée.
- Placez votre curseur sur le champ de saisie Valeur test jusqu’à ce que vous voyiez le symbole de reformatage des valeurs.
Quand vous cliquez dessus, une boîte de dialogue s’affiche. Ajoutez l’expression JSONata suivante au champ de texte intitulé « Reformatage de JSONdata » :
```$a and $not($a = "null") ? $a : ""```
Cette expression JSONata vérifiera que le paramètre existe et qu’il a une valeur.- Si c’est le cas, transférez la valeur du paramètre à l’API.
- Sinon, fournissez une chaîne vide ou omettez-le totalement.
Pour en savoir plus sur le formatage des valeurs, consultez Reformatage des valeurs dans les paramètres de demande pour agents IA.
Désormais, en cas de valeur facultative pour votre appel API, le créateur d’intégration sera capable de la gérer correctement.