Créer un agent IA externe avec intégration manuelle

Créez un agent IA externe en intégrant manuellement un agent Studio d'agents IA tiers à utiliser dans les workflows agentiques.

Avant de commencer

Rôle requis : sn_aia.admin

Procédure

1. Accédez à la Tous > Studio d'agent IA > Créer et gérer > Agents IA.
2. Sélectionner Nouveau > Externe.
3. Sélectionnez la méthode d’intégration manuelle .
4. À l’étape Connecter un fournisseur, renseignez les champs de formulaire pour vous connecter à votre agent IA.
   1. Dans la section Saisir les détails du fournisseur, sélectionnez l’alias et le flux secondaire de votre agent IA externe.

      Votre alias doit pointer vers le fournisseur d’IA agentique et inclure un jeton d’authentification. Vous pouvez créer un alias en sélectionnant Créer un alias. Une fois l’enregistrement créé, vous pouvez actualiser ou redémarrer la configuration guidée pour voir la nouvelle option.

      Le API type est le flux secondaire. Sélectionnez un flux secondaire qui correspond au fournisseur. Vous pouvez créer le vôtre en sélectionnant Créer un nouveau flux secondaire.

   2. Dans la section Saisir les détails initiaux sur l’agent IA externe, renseignez les champs.

      Tableau 1. Saisir les détails initiaux sur les champs de formulaire de section de l’agent IA externe

      Nom	Description
      ID de l'agent	Identificateur unique de votre agent en fonction de votre fournisseur d’IA agentique.
      Métadonnées	JSON structuré qui inclut les champs requis pour le fonctionnement de votre agent IA, par exemple celui model utilisé par l’agent IA.
      Mode de communication	Synchrone (temps réel) ou asynchrone (permet un délai).
      Analyser la réponse	Vrai ou faux.

   Sélectionnez Enregistrer et passez à l’étape suivante.

   

5. Dans l’étape Différencier et définir, ajoutez des détails sur l’agent IA pour donner à l’agent d’orchestration IA le contexte sur la façon d’utiliser l’agent dans les workflows agentiques.
   1. Dans la section Décrire l’agent IA, ajoutez un nom et une description pour votre agent IA externe.

      Les champs Nom et Description sont utilisés par l’orchestrateur d’agent IA pour aider à déterminer quand utiliser votre agent IA. Plus votre description est complète, plus l’agent IA est susceptible d’être utilisé correctement dans le workflow agentique.

      Vous pouvez sélectionner Utiliser Now Assist pour faciliter la génération du contenu pour les champs Nom, Description, Rôle d’agent IA et Instructions. Vous pouvez toujours apporter des changements une fois ces champs générés.

   2. Dans la section Instruire l’agent IA, ajoutez le rôle et les instructions de l’agent IA.

      Ces champs fournissent un contexte permettant à l’agent IA d’orchestrateur de comprendre les fonctions et les étapes requises pour que l’agent IA ait atteint son objectif dans le workflow. Des informations détaillées sur le rôle et les instructions créent des agents IA plus efficaces. Pour des suggestions d’écriture de rôles et d’instructions d’agent IA, consultez Directives générales pour la création d’agents IA et de workflows agentiques

   3. Configurez les listes de contrôle d’accès (ACL) pour l’agent IA.
      Remarque :

      Les ACL déterminent qui a accès à la détection et à l’exécution de l’agent IA. Pour en savoir plus sur les ACL que vous pouvez créer et Studio d'agents IA sur la manière d’ajouter des configurations de sécurité plus avancées, reportez-vous à la section Implémenter le contrôle d’accès pour la sécurité dans les agents IA.

      Il s’agit d’une étape obligatoire. Si vous avez précédemment configuré un agent IA sans créer d’ACL, vous devez générer une ACL avant de pouvoir apporter d’autres modifications.

      Tableau 2. Définir qui peut accéder à l’agent IA

      Champ	Description
      Accès de l'utilisateur	Type d’utilisateurs dont l’accès pour l’agent IA est défini par les options suivantes : Tout utilisateur authentifié : tout utilisateur connecté peut accéder à l’agent IA. Utilisateurs avec des rôles spécifiques : les utilisateurs qui ont au moins un des rôles affectés peuvent accéder à l’agent IA. Il s'agit de l'option par défaut. Remarque : Si un utilisateur n’a pas accès à un agent IA ou si l’utilisateur n’a pas accès à au moins un des agents IA dans l’exécution du workflow agentique respectif, toute l’exécution s’interrompt avant le lancement du premier agent IA. Public : tout utilisateur peut accéder à l’agent IA même sans se connecter. Utilisez cette option uniquement lorsque vous souhaitez que les invités puissent accéder à l’agent IA.
      Rôle	Attribuez un ou plusieurs rôles spécifiques dans la liste déroulante. Remarque : La sélection du rôle n’est possible que lorsque vous avez choisi l’accès utilisateur Utilisateurs ayant des rôles spécifiques .

   

6. Dans l’étape Sélectionner un affichage , choisissez l’emplacement où vous souhaitez que l’agent IA apparaisse et le message que les utilisateurs voient lorsque l’agent IA est en cours d’exécution.
   1. Sélectionnez la disponibilité de votre agent IA.
      Activez si Status vous souhaitez que l’agent IA soit disponible pour les utilisateurs disposant du rôle approprié.
   2. Choisissez un message de traitement à afficher à l’utilisateur lorsque l’agent IA est en cours d’exécution.
      Par exemple, Initiating AI agent ou Processing record details, ou An AI agent is looking into the request.

   

7. Sélectionnez Enregistrer et tester pour enregistrer les détails de l’agent IA et accédez à la page Test de Studio d'agents IA.

Résultats

Votre agent IA externe est connecté à ServiceNow et peut être utilisé dans les workflows agentiques.

Que faire ensuite

Vous pouvez tester l’agent IA ou l’ajouter à un workflow agentique nouveau ou existant.