Découverte des outils d' OpenAPI

OpenAPI Les outils sont des intégrations prêtes à l'emploi basées sur les spécifications de l' OpenAPI, qui permettent aux agents d'interagir avec des API et des services externes. Ces outils permettent de standardiser les opérations afin d'automatiser des tâches dans divers domaines d'activité, du traitement des commandes à la gestion de la clientèle.

OpenAPI Ces outils se distinguent des autres outils prêts à l'emploi en ce qu'ils sont définis par des spécifications d' OpenAPI, qui décrivent les opérations disponibles, les exigences en matière d'authentification et les structures de données. Chaque outil d' OpenAPI peut proposer plusieurs opérations que les agents peuvent utiliser pour accomplir des tâches spécifiques.

Filtrage des outils d' OpenAPI

Lorsque vous parcourez le catalogue, vous pouvez identifier les outils d' OpenAPI s grâce à leurs indicateurs visuels distinctifs, tels que le badge « "OpenAPI" » figurant sur leur fiche, ainsi que le nombre d'opérations (outils) qu'ils proposent.

Pour afficher uniquement les outils d' OpenAPI s dans le catalogue :

  1. Dans le menu principal, sélectionnez « Découvrir ».
  2. Dans le volet de gauche, sous Type, sélectionnez Outils.
  3. Appliquez le filtre « OpenAPI » pour n'afficher que les outils d' OpenAPI-based.
  4. Vous pouvez également associer cette option à la fonction « Catégories » pour affiner les résultats par domaine, par exemple les ressources humaines, les achats ou les ventes.

Afficher les détails de l'outil « OpenAPI »

Lorsque vous sélectionnez un outil d' OpenAPI ation dans le catalogue, la page de détails fournit des informations complètes sur les fonctionnalités et la structure de cet outil.

Remarque :

Dépannage : si les opérations n'apparaissent pas lorsque vous consultez un outil d' OpenAPI, vérifiez que la spécification d' OpenAPI est valide et accessible, assurez-vous que vous disposez des autorisations nécessaires pour consulter l'outil, et vérifiez que l'outil est bien publié et disponible dans votre environnement.

Présentation des outils

L'onglet « Aperçu » affiche :

  • Description : Résumé de l'objectif de l'outil et des processus métier qu'il prend en charge. Cela vous permet de déterminer si l'outil répond à vos besoins en matière d'automatisation.
  • Opérations : un tableau répertoriant toutes les opérations disponibles issues de la spécification « OpenAPI ». Chaque opération affiche son nom et sa description.
Détails de l'outil

L'onglet « Détails » affiche :

  • URL de base : le point de terminaison API URL pour le service OpenAPI.
  • Schémas d'authentification pris en charge : les méthodes d'authentification prises en charge par l'outil.
Panneau de métadonnées

Le panneau de droite fournit des informations de référence rapide :

  • Applications utilisées : nombre total d'applications utilisées dans la spécification « OpenAPI ».
  • Publié par : L'organisme qui fournit et assure la maintenance de l'outil.
  • Catégories : Domaines d'activité pris en charge par l'outil, par exemple les achats et les ventes.
  • Version : la version actuelle de l'outil.
  • Langues : langues disponibles pour les opérations et les descriptions de l'outil.

Agents dotés d'outils d' OpenAPI s associés

Certains agents prédéfinis sont spécialement conçus pour fonctionner avec des outils d' OpenAPI. Lorsque vous consultez la liste des agents, vous pouvez identifier les outils d' OpenAPI s grâce à leurs repères visuels distinctifs, tels que le badge « "OpenAPI" » figurant sur leur fiche.

Ajouter des outils d' OpenAPI s à partir du catalogue

Ajoutez les outils d' OpenAPI s du catalogue à la boîte à outils de votre agent afin d'en améliorer les fonctionnalités. Pour plus d'informations, consultez la section « Ajout d'outils d' OpenAPI s aux agents ».