--- sourceDocument: Interfaces conversationnelles Xanadu sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/fr-FR/xanadu/conversational-interfaces Release : - xanadu ft:locale : - fr-FR ft:publication_title : - Interfaces conversationnelles Xanadu ft:clusterId : - convint bundleId : - convint workflow : - Platform --- # Utiliser API Agent virtuel # Utiliser API Agent virtuel {#ariaid-title1} * Rversion finale: Xanadu * * Mis à jour 1 août 2024 * * ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 3 minutes de lecture Utilisez l'application API ServiceNow® Agent virtuel pour intégrer n'importe quelle interface de messagerie instantanée ou un bot avec ServiceNow® Agent virtuel ou Messagerie instantanée d'agent. L'application est disponible à partir du ServiceNow® Storefichier . ## Vue d'ensemble {#virtual-agent-api__section_cxx_ldc_qmb} L'API Agent virtuel est une API REST. Cette API est construite sur le cadre de travail d'intégration conversationnelle de la messagerie instantanée personnalisée qui est 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 en tant que bot autonome que vous intégrez à l'entreprise ou à toute autre interface de messagerie instantanée tierce prenant en charge les interfaces conversationnelles. À l'aide de cette intégration, vos utilisateurs finaux peuvent interagir avec et Agent virtuelMessagerie instantanée d'agent via plusieurs canaux. Bot secondaire : Utilisez Agent virtuel en tant que 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 LUISou un bot primaire développé en interne. Vos bots secondaires, tels que le ServiceNow bot, peuvent traiter des types spécifiques de demandes de l'utilisateur final, tels que les tickets de service ou les réservations. Bot Interconnect : Utilisez-le Agent virtuel Bot Interconnect comme bot principal 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 à partir 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 des contrôles non pris en charge qui doivent être restitués dans votre interface de messagerie instantanée existante, envisagez d'utiliser [l'infrastructure d'intégration de la messagerie instantanée personnalisée](https://servicenow-prod.fluidtopics.net/1aHVrveeOzIgF34Wiw83Rw "Le cadre de travail d’intégration conversationnelle de la messagerie instantanée personnalisée est un cadre puissant composé d’API et de configurations scriptables permettant d’intégrer le à n’importe ServiceNow Agent virtuel quelle interface conversationnelle."). Pour en savoir plus sur les fonctionnalités telles que le format de l'URL et les paramètres de demande et de réponse pris en charge dans l'API Agent virtuel , consultez API [Agent virtuel Bot Integration](https://www.servicenow.com/docs/access?context=bot-api&version=xanadu&pubname=xanadu-api-reference&ft:locale=en-US). ![Lien vidéo vers l’Académie Agent virtuel.]() [Améliorez vos expériences avec l'API Virtual Agent (vidéo de l'académie](https://www.youtube.com/watch?v=cyhmMyG4jKk) Virtual Agent) ## Fonctionnement de l'API Agent virtuel {#virtual-agent-api__section_ivs_d2r_fnb} Le diagramme suivant montre comment l'API REST traite l'entrée utilisateur provenant d'une interface de messagerie instantanée tierce ou d'un bot principal, puis génère une réponse de bot. 1. L'utilisateur fournit des entrées à un bot principal ou à une interface 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. Le Now Platform authentifie et traite la demande, qui est envoyée à Agent virtuel un agent actif. 4. Le Now Platform envoie une réponse POST JSON du point de terminaison REST sortant (via l'API REST) au bot. 5. Le bot principal ou les interfaces de messagerie instantanée tierces affichent la réponse à l'utilisateur. {#virtual-agent-api__ol_pwf_jqc_kyb} 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 [Prise en main des API Agent virtuel](https://community.servicenow.com/community?id=community_article&sys_id=080e3903dbc4e4107d3e02d5ca96198c) sur le site Communauté. ## Limitations {#virtual-agent-api__section_xqy_r1l_2qb} L'API Agent virtuel ne prend pas en charge les fonctionnalités suivantes : * Personnalisation de la messagerie instantanée via cette Agent virtuel intégration d'API {#virtual-agent-api__ul_yqy_r1l_2qb} ## Compatibilité des versions et des versions {#virtual-agent-api__section_t11_5zb_dqb} {#virtual-agent-api__table_syv_gzb_dqb__entry__2} | Version | Versions compatibles | |-|-| | 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 | [Tableau 1. Agent virtuel Compatibilité des versions et des versions de l'API] {#virtual-agent-api__table_syv_gzb_dqb} Remarque : L'API Agent virtuel nécessite une licence Pro similaire à celle de Agent virtuel. * **[Agent virtuel Fonctionnalités de l'API](https://servicenow-prod.fluidtopics.net/bR8IyvO237AiBfOVsxgviA)** Vous pouvez utiliser l'API Agent virtuel pour intégrer un grand nombre des fonctionnalités disponibles dans Agent virtuel et Messagerie instantanée d'agent dans 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 de l'API disponibles dans la version Store 2.0.x](https://servicenow-prod.fluidtopics.net/i1qznspskjlRxRtfl9WGaQ#va-api-features-v2)** Agent virtuelLa version 2.0.x de l'API permet d'accéder à un plus grand nombre des mêmes fonctionnalités que celles disponibles dans et Messagerie instantanée d'agent, y compris une prise en Agent virtuel charge approfondie du contrôle et des notifications. * **[API Agent virtuel fonctionnalités disponibles dans Store version 3.0.x](https://servicenow-prod.fluidtopics.net/aGPPxm~HYWnmeRK4_jDiWQ#va-api-features-v3)** API Agent virtuel La version 3.0.x permet d'accéder à un plus grand nombre des mêmes fonctionnalités que celles disponibles dans Agent virtuel et Messagerie instantanée d'agent, notamment la possibilité de charger des fichiers à partir d'une URL privée et des améliorations de l'établissement de liaison synchrone. * **[Installer l'API Agent virtuel](https://servicenow-prod.fluidtopics.net/OewXFMD9zazgJXXMR~fvjA)** Installez l'application API pour intégrer n'importe Agent virtuel quelle interface de messagerie instantanée ou un bot avec ServiceNow® Agent virtuel ou Messagerie instantanée d'agent. * **[Examiner le point de terminaison REST entrant et configurer l'authentification entrante](https://servicenow-prod.fluidtopics.net/9z4PcRR7vEknlWOU7HRu4A)** Une fois l'API Agent virtuel installée, accédez à la ressource d'API REST scriptée pour examiner le point de terminaison et configurer l'authentification. * **[Configurer l'authentification de message pour la communication entrante](https://servicenow-prod.fluidtopics.net/jBJPbWSuRR3iCvOnaKHHUw)** Vous pouvez configurer l'authentification de message pour l'API au lieu de l'authentification Agent virtuel de base ou OAuth. L'authentification des messages 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 la réponse de sortie, le point de terminaison REST et l'authentification sortante pour l'API Agent virtuel](https://servicenow-prod.fluidtopics.net/CoMq~aQhIvQglVjp33g6Wg)** Spécifiez l'URL du point de terminaison sortant sur laquelle les Agent virtuel réponses sont publiées. Configurez l'authentification sortante. * **[Agent virtuel Intégration bot-to-bot](https://servicenow-prod.fluidtopics.net/szI3WiT6ux0v6Myizxdkaw)** L'API Agent virtuel prend en charge les environnements qui utilisent plusieurs bots. Dans ce cas, un bot principal communique avec des bots secondaires tiers, comme un ServiceNow bot. * **[Fermeture des conversations de bot à bot inactives](https://servicenow-prod.fluidtopics.net/wOWOp6CY46YChNW0DsZIKg)** Dans les intégrations bot-to-bot (API Agent virtuel), les conversations abandonnées \<\< 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 fournisseur](https://servicenow-prod.fluidtopics.net/QQc1kwUaHNUzF~4Yp~8VXg)** Vous pouvez configurer plusieurs applications de fournisseur pour prendre en charge les cas d'utilisation où plusieurs bots principaux sont utilisés API Agent virtuel et que vous devez les distinguer. * **[Transformer la demande et la réponse de l'API d'Agent virtuel](https://servicenow-prod.fluidtopics.net/VTvIdOlGB80tkyAsnrJzSg)** Vous pouvez transformer la demande et la réponse de l'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](https://servicenow-prod.fluidtopics.net/IbrQOi5rGsx1gssB2w1tPA)** 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.