Utiliser API Agent virtuel

Utilisez l’application API pour intégrer n’importe ServiceNow® Agent virtuel quelle interface de messagerie instantanée ou un bot à ServiceNow® Agent virtuel ou Messagerie instantanée d'agent. L’application est disponible à partir du ServiceNow® Store.

Vue d’ensemble de la API Agent virtuel

L’API Agent virtuel est une API REST. Cette API est basée sur le cadre d’intégration conversationnelle de la messagerie instantanée personnalisée fourni à Agent virtuel partir de la Paris version. L’API permet ServiceNow aux développeurs, aux utilisateurs avancés et aux administrateurs de l’utiliser Agent virtuel de l’une des manières suivantes :

Bot autonome

Utilisez Agent virtuel comme bot autonome que vous intégrez à Enterprise ou à toute autre interface de messagerie instantanée tierce prenant en charge les interfaces conversationnelles.

Vos utilisateurs finaux peuvent interagir avec et Agent virtuelMessagerie instantanée d'agent via plusieurs canaux à l’aide de cette intégration.

Bot secondaire

À utiliser Agent virtuel comme bot secondaire dans un environnement qui dispose de plusieurs bots spécialisés gérés par un bot primaire.

Dans ce scénario, un bot primaire gère la communication avec les bots secondaires pour le compte de l’utilisateur final. Un bot primaire peut être IBM Watson Assistant, Microsoft LUIS ou un bot primaire maison.

Vos bots secondaires, tels que le ServiceNow bot, peuvent gérer des types spécifiques de demandes d’utilisateurs finaux, telles que des tickets de service ou des réservations.

Bot Interconnect

Utilisez-le Agent virtuel Bot Interconnect en tant que bot primaire dans un environnement de messagerie instantanée diversifié. Bot Interconnect crée une expérience de messagerie instantanée unifiée et donne à vos utilisateurs finaux l’accès à plusieurs canaux et à une grande variété de tâches d’entreprise disponibles auprès de ServiceNow.

L’API Agent virtuel est utile pour créer des intégrations de serveur à serveur. Toutefois, pour les intégrations qui nécessitent la transformation de contrôles non pris en charge qui doivent être affichés dans votre interface de messagerie instantanée existante, envisagez d’utiliser le cadre de travail d’intégration de la messagerie instantanée personnalisée.

Pour plus d’informations sur les fonctionnalités telles que le format d’URL et les paramètres de demande et de réponse pris en charge dans l’API, consultez API d’intégration Agent virtuel de bot Agent virtuel.

Améliorez vos expériences avec l’API Agent virtuel (vidéo de l’Académie Agent virtuel)

Fonctionnement de l’API Agent virtuel

Le diagramme suivant montre comment l’API REST traite l’entrée de l’utilisateur à partir d’une interface de messagerie instantanée tierce ou d’un bot principal, puis génère une réponse de l’agent.

1. L’utilisateur fournit une entrée à une interface de bot primaire ou de messagerie instantanée tierce.
2. Le bot envoie un JSON de demande POST au point de terminaison REST entrant (via l’API REST scriptée).
3. L’authentifie ServiceNow AI Platform et traite la demande, qui est envoyée à Agent virtuel un agent actif.
4. L’envoie ServiceNow AI Platform un JSON de réponse POST à partir du point de terminaison REST sortant (via l’API REST) au bot.
5. L’interface de messagerie instantanée du bot principal ou du tiers affiche la réponse à l’utilisateur.

Figure 1. Points de terminaison REST entrants et sortants dans l’API Agent virtuel

Pour voir une démonstration de l’API Agent virtuel et une FAQ, consultez Introduction aux API Agent virtuel sur le site Community.

Limitations

L’API Agent virtuel ne prend pas en charge les fonctionnalités suivantes :

• Marque de messagerie instantanée via cette Agent virtuel intégration d’API

Compatibilité des versions et des versions

Tableau 1. Agent virtuel Compatibilité des versions et versions de l’API

Version	Versions compatibles
3.14.3	Yokohama
3.14.2	Xanadu
3.14.1	Xanadu
3.10.0	Washington DC
3.9.x	Vancouver
3.8.x	Vancouver
3.7.x	Utah
3.5.x	Tokyo
3.0.x	San Diego
2.0.x	Rome Un sous-ensemble de fonctionnalités est compatible avec Quebec.
1.3.0	Quebec
1.0.12	Quebec
1.0.9	Paris

Remarque :

L’API Agent virtuel nécessite une licence Pro similaire à celle de Agent virtuel.

• Agent virtuel Fonctionnalités de l’API
  Vous pouvez utiliser l’API Agent virtuel pour intégrer la plupart des fonctionnalités disponibles dans Agent virtuelMessagerie instantanée d'agent votre environnement de messagerie instantanée. La prise en charge des fonctionnalités varie en fonction de votre ServiceNow version et du numéro de version de l’application Store de l’API.
• Agent virtuel Fonctionnalités d’API disponibles dans la version Store 2.0.x
  Agent virtuel La version 2.0.x de l’API permet d’accéder à d’autres fonctionnalités identiques à celles disponibles dans Agent virtuel et Messagerie instantanée d'agent, y compris la prise en charge des contrôles enrichis et les notifications.
• API Agent virtuel fonctionnalités disponibles dans la version 3.0.x du Store
  API Agent virtuel la version 3.0.x donne accès à d’autres fonctionnalités identiques à celles disponibles dans Agent virtuel et Messagerie instantanée d'agent, y compris la possibilité de télécharger des fichiers à partir d’une URL privée et des améliorations de la négociation synchrone.
• API Agent virtuel fonctionnalités disponibles dans la version Store 4.0.x
  API Agent virtuel La version 4.0.x permet d’accéder à d’autres fonctionnalités identiques à celles disponibles dans Agent virtuel et Messagerie instantanée d'agent, notamment la possibilité de fournir une expérience enrichie de chat d’agent entre ServiceNow AI Platform® les applications de messagerie instantanée tierces prises en charge et les applications de messagerie instantanée prises en charge.
• Installer l’API Agent virtuel
  Installez l’application Agent virtuel API pour intégrer une interface de messagerie instantanée ou un bot à ServiceNow® Agent virtuel ou Messagerie instantanée d'agent.
• Examiner le point de terminaison REST entrant et configurer l’authentification entrante
  Après avoir installé l’API Agent virtuel , accédez à la ressource API REST scriptée pour examiner le point de terminaison et configurer l’authentification.
• Configurer l’authentification de message pour la communication entrante
  Vous pouvez configurer l’authentification de message pour l’API Agent virtuel au lieu de l’authentification de base ou OAuth. L’authentification de message implique la configuration de jetons statiques ou de hachage, la configuration de l’authentification du fournisseur et la définition de l’identité du canal.
• Configurer le point de terminaison REST de réponse de sortie et l’authentification sortante pour l’API Agent virtuel
  Spécifiez l’URL du point de terminaison sortant sur lequel les Agent virtuel réponses sont publiées. Configurez l’authentification sortante.
• Agent virtuel Intégration bot-to-bot
  L’API Agent virtuel prend en charge les environnements qui utilisent plusieurs bots. Dans cette situation, un bot primaire communique avec des bots secondaires tiers, tels qu’un ServiceNow bot.
• Fermeture des conversations bot-to-bot inactives
  Dans les intégrations bot-to-bot (API Agent virtuel), les conversations abandonnées qui sont « inactives » pendant plus d’une heure sont automatiquement fermées par la tâche planifiée. Time Out Abandoned B2B Conversations Cette tâche s’exécute toutes les heures chaque jour.
• Configurer plusieurs applications de fournisseurs
  Vous pouvez configurer plusieurs applications de fournisseurs pour prendre en charge les agents IA lorsque plusieurs bots primaires les utilisent API Agent virtuel et que vous devez les distinguer.
• Transformer la demande et la réponse d’API d’Agent virtuel
  Vous pouvez transformer la demande et la réponse d’API d’Agent virtuel dans des formats pris en charge via les points d’extension scriptés fournis dans l’API d’Agent virtuel.
• Activer l’expérience Now Assist dans API Agent virtuel
  Activez Now Assist l’expérience dans API Agent virtuel pour prendre en charge les compétences d’IA générative sur plusieurs canaux de fournisseurs.