Créer un connecteur d’API avec une compétence d’IA générative

  • Rversion finale: Australia
  • Mis à jour 31 mars 2026
  • 4 minutes de lecture

    • Utilisez la compétence Connecteur de configuration SPC pour vous aider à terminer automatiquement les étapes de configuration 3 à 5 dans le générateur de connecteurs dans l’espace de Contrôle de la posture de sécurité travail.

    Avant de commencer

    Remarque :
    Selon votre licence, vous aurez accès à certaines fonctionnalités d’application, compétences d’IA générative, workflows agentiques et agents IA. Pour plus d'informations, consultez ServiceNow product tiers.

    La compétence Connecteur de configuration SPC est incluse Now Assist pour Réponses aux vulnérabilités dans la compétence et la compétence est activée par défaut. Pour en savoir plus sur la configuration de cette compétence, reportez-vous à la section Configurer une compétence pour Now Assist pour Réponses aux vulnérabilités.

    Important :
    Cette Now Assist compétence est activée par défaut. La compétence sera automatiquement disponible pour les utilisateurs de rôle appropriés pour l’application. Pour plus d'informations, consultez Now Assist skills, agents, and agentic workflows on by default.

    Vous devez effectuer les étapes un et deux dans l’espace de travail avant de pouvoir invoquer la compétence du connecteur de Now Assist configuration SCP. Voir Entrer les métadonnées et Créer un alias de connecteur et des informations d’identification de connexion pour plus d’informations.

    Rôle requis : admin

    Procédure

    1. Accédez à la Tous > Contrôle de la posture de sécurité > Générateur de connecteurs et effectuez les étapes 1 et 2, si elles ne sont pas déjà terminées.
    2. À l’étape 3, sélectionnez Utiliser Now Assist.
    3. Renseignez les champs.
      Remarque :
      Une erreur s’affiche si l’URL du document d’API n’est pas prise en charge ou si elle n’est pas liée aux données de liste des actifs.
      Champ Description
      Lien vers le document d’API

      Entrez l’URL du fournisseur qui dispose des informations d’API que vous souhaitez utiliser, par exemple, https://developer.yourvendor.com/documentation/api/assets.
      Point de terminaison d’API (facultatif)

      Vous préférerez peut-être utiliser ce champ si la page d’API contient trop de détails, s’il s’agit d’un PDF ou s’il est au format JASON et non HTML. Vous pouvez ajouter un point de terminaison à une URL de base.

      Par exemple, vous avez https://developer.yourvendor.com. Recherchez le point de terminaison souhaité dans la documentation de l’API (documentation/api/assets) et entrez-le dans ce champ.
    4. Sélectionnez Configurer pour moi.

      La Now Assist compétence sélectionne automatiquement un modèle, fournit des paramètres d’entrée, teste la connexion API et mappe les paramètres.

      Le processus prend quelques instants et la progression est affichée dans le modal.

      Now Assist génère un exemple de réponse et un schéma basés sur la documentation d’API que vous avez chargée à l’étape précédente. Vous devez vérifier l’exactitude de l’exemple de réponse et du schéma ainsi que l’exactitude du mappage avant de valider votre connecteur et de le publier.

      Remarque :

      Un message d’avertissement s’affiche et vous invite à examiner et à vérifier que toutes les informations générées par la Now Assist compétence sont correctes.

      Un message d’erreur s’affiche si la compétence ne peut pas fournir d’entrée Now Assist , par exemple, si elle ne peut pas sélectionner un modèle en fonction des informations que vous avez fournies. Si un message d’erreur s’affiche, vous ne pouvez pas sélectionner Appliquer la configuration et passer à l’étape suivante.

    5. Sélectionnez Appliquer la configuration.
      L’étape Sélectionner un modèle dans le générateur de connecteur s’affiche et un modèle a été sélectionné automatiquement.
    6. Sélectionnez Enregistrer et continuer.
      L’étape Fournir des entrées s’affiche. Les informations suivantes sont automatiquement renseignées dans le formulaire en fonction de la documentation fournisseur que vous avez fournie.
      Remarque :
      Vous n’avez pas besoin de sélectionner Obtenir un exemple de réponse.
      • Exemple de réponse de l'API
      • Chemin d’accès du point de terminaison d’API
      • Paramètres de requête
      • Paramètres d’en-tête
      • Paramètres de pagination
    7. Examinez les informations et modifiez les champs si nécessaire.
    8. Sélectionnez Enregistrer et continuer après avoir examiné les valeurs.

      Si vous ne voyez pas d’exemple d’API ou si une erreur s’affiche, suivez les invites du message pour saisir les valeurs manquantes.

      L’étape Carte de réponse s’affiche après une importation réussie. Les paramètres d’entrée ont été mappés automatiquement aux attributs et politiques Contrôle de la posture de sécurité (SPC) à partir des exemples de données générées par votre connecteur.

      Vérifiez les valeurs en examinant l’exemple de réponse API pour les attributs SPC et l’exemple de schéma de réponse API pour les attributs API dans la fenêtre de référence.

      Ces exemples de données sont agrégés et le mappage est modifiable. En outre, vous pouvez créer des attributs personnalisés pour vos SPC politiques selon vos besoins.

      Pour plus d’informations sur le mappage qui inclut la combinaison de valeurs pour remplir un seul champ, consultez Mapper la réponse dans la documentation du Contrôle de la posture de sécurité produit.

    9. Consultez Valider votre connecteur dans la documentation du Contrôle de la posture de sécurité produit pour plus d’informations sur l’étape de validation, la publication de votre connecteur et l’achèvement du processus.