Migrer vers watsonx Orchestrate

Ce guide explique comment migrer vos configurations watsonx Assistant (Actions, Dialogues et Intégrations) vers watsonx Orchestrate AI Assistants. Le processus de migration comprend

  • Exportation d'actions et de dialogues à partir de watsonx Assistant.

  • Importation dans watsonx Orchestrate.

  • Reconfigurer les intégrations telles que les extensions et le chat Web.

Important :

Les opérations de migration peuvent écraser les configurations existantes de votre assistant IA. Sauvegardez toujours vos paramètres actuels avant de procéder.

Avant de commencer

Migration des actions watsonx Assistant

Extraire vos actions de watsonx Assistant

  1. Naviguez jusqu'à votre watsonx Assistant instance.

  2. Sélectionnez l' assistant que vous souhaitez migrer.

  3. Cliquez sur Actions pour afficher le tableau des actions.

  4. Sélectionnez Actions Options globales.

  5. Ouvrez l'onglet Téléchargement/Upload.

  6. Téléchargez (descente) le fichier JSON.

Importation dans Orchestrate

  1. Naviguez jusqu'à votre watsonx Orchestrate instance.

  2. Sélectionnez l' assistant AI vers lequel vous souhaitez migrer.

  3. Cliquez sur Actions pour afficher le tableau des actions.

  4. Ouvrez l'onglet Téléchargement/Upload.

  5. Cliquez sur Télécharger.

  6. Sélectionnez le fichier JSON obtenu à partir de l'instance watsonx Assistant.

  7. Attendez la fin de l'importation.

Important :

L'importation d'actions remplacera les actions existantes dans votre assistant IA d' watsonx Orchestrate. Si vous devez conserver la configuration actuelle, créez un nouvel assistant AI avant d'effectuer la migration.

Dialogue sur la migration de watsonx Assistant

watsonx Assistant Le dialogue est disponible sous deux formes différentes dans le produit. Suivez la procédure correspondant à votre expérience actuelle sur watsonx Assistant :

Important :

L'importation d'une boîte de dialogue remplacera la boîte de dialogue existante dans votre assistant IA d' watsonx Orchestrate. Si vous devez conserver la configuration actuelle, créez un nouvel assistant AI avant d'effectuer la migration.

Expérience classique

Si vous utilisez watsonx Assistant avec l' expérience classique, suivez les étapes suivantes pour migrer votre dialogue :

Extraction de dialogues à partir de watsonx Assistant

  1. Naviguez jusqu'à votre watsonx Assistant instance.

  2. Ouvrez le catalogue des compétences Dialog dans le menu de gauche.

  3. Sélectionnez une carte de compétences Dialog.

  4. Cliquez sur le bouton Plus d'options (...) sur la carte.

  5. Cliquez sur Télécharger.

Importation de dialogues dans watsonx Orchestrate

  1. Naviguez jusqu'à votre watsonx Orchestrate instance.

  2. Ouvrez le menu principal et cliquez sur AI assistant builder.

  3. Passer à l' expérience classique.

  4. Créez une compétence à partir de la page Compétences.

  5. Sélectionnez Dialogue.

  6. Choisissez Upload skill, et sélectionnez le Dialog skill JSON que vous avez téléchargé.

  7. Attendez que le téléchargement soit terminé.

Nouvelle expérience

Extraction de dialogues à partir de watsonx Assistant

  1. Accédez à votre watsonx Assistant instance.

  2. Sélectionnez l' assistant que vous souhaitez migrer.

  3. Cliquez sur l' icône de l'arbre de dialogue dans le menu de gauche.

  4. Sous Options, cliquez sur Upload/Download.

  5. Choisissez l'onglet Téléchargement et cliquez sur Télécharger.

Importation de dialogues dans watsonx Orchestrate

  1. Naviguez jusqu'à votre watsonx Orchestrate instance.

  2. Sélectionnez l' assistant AI vers lequel vous souhaitez migrer.

  3. Assurez-vous que le dialogue est activé.

  4. Cliquez sur l' icône de l'arbre de dialogue dans le menu de gauche.

  5. Sous Options, cliquez sur Upload/Download.

  6. Dans l'onglet Upload, sélectionnez le fichier Dialog skill JSON téléchargé.

  7. Une fois le téléchargement terminé, la compétence Dialog sera chargée.

Intégrations

Instantiate

Prérequis

Migration des extensions

Si l'assistant AI migré contenait des actions avec des étapes faisant référence à des extensions, ces étapes afficheront une erreur jusqu'à ce que les extensions correspondantes soient recréées et configurées dans watsonx Orchestrate.

  1. Accédez à votre watsonx Orchestrate instance.

  2. Sélectionnez l' assistant AI que vous souhaitez migrer.

  3. Cliquez sur Créer une extension personnalisée et suivez les étapes.

  4. Après la création, ouvrez la nouvelle extension et choisissez l'environnement dans lequel vous souhaitez ajouter des informations d'identification.

  5. Ajoutez les informations d'identification et confirmez.

  6. Les erreurs relatives aux actions avec étapes devraient maintenant être résolues.

Chat en ligne et paramètres du chat en ligne

Pour migrer vos chats Web, vous devez tenir compte des points suivants :

  • Les paramètres du chat en ligne doivent être mis à jour manuellement dans le nouvel assistant AI.

  • Vous devez avoir accès à l'application dans laquelle votre instance de chat Web est intégrée.

Migration des paramètres du chat Web

  1. Accédez à votre watsonx Assistant instance.

  2. Sélectionnez l' assistant avec le chat Web que vous voulez migrer.

  3. Dans un nouvel onglet ou une nouvelle fenêtre du navigateur, ouvrez votre watsonx Orchestrate exemple.

  4. Sélectionnez ou créez l'assistant AI avec le chat Web que vous souhaitez mettre à jour.

  5. Dans les deux assistants d'intelligence artificielle, accédez à la rubrique Intégrations.

  6. Sélectionnez l' intégration du chat Web et choisissez l'environnement que vous souhaitez migrer.

  7. Copiez tous les paramètres de watsonx Assistant vers watsonx Orchestrate.

Migration de l'intégration du chat en ligne

Si vous n'avez utilisé que le code d'intégration fourni dans l'interface utilisateur watsonx Orchestrate, procédez comme suit :

  1. Accédez à votre watsonx Orchestrate instance.

  2. Sélectionnez l' assistant AI avec le chat Web que vous souhaitez migrer.

  3. Allez dans Intégrations.

  4. Ouvrez l'intégration du chat Web et choisissez l'environnement que vous migrez.

  5. Allez dans l'onglet Embed et copiez le code.

  6. Dans votre application, localisez le code d'intégration existant.

  7. Remplacer le code d'intégration existant par le nouveau code d'intégration.

Si vous souhaitez conserver les éléments personnalisés, ne remplacez que les identifiants :

  1. Allez sur votre instance watsonx Orchestrate.

  2. Sélectionnez l'assistant AI avec le chat Web que vous souhaitez migrer.

  3. Allez dans Intégrations.

  4. Ouvrez l'intégration du chat Web et choisissez l'environnement que vous migrez.

  5. Allez dans l'onglet Embed.

  6. Identifiez ces champs dans votre code :

    • integrationID

    • region

    • serviceInstanceID

  7. Copiez chacun des champs et sauvegardez-les dans un endroit sûr.

  8. Dans votre application, localisez le code d'intégration et remplacez les champs par les nouvelles valeurs.

Remarque :

Une fois la migration terminée, testez le chat en ligne pour vérifier qu'il se connecte bien à l'Assistant approprié et qu'il fonctionne correctement.

Application personnalisée

Mettez à jour votre application personnalisée pour qu'elle pointe vers les ID suivants pour l'assistant AI que vous avez migré :

  • Instance de service URL

  • ID d'assistant

  • ID d'environnement

  • apikey

Pour trouver ces valeurs, suivez les étapes suivantes :

  1. Ouvrir watsonx Orchestrate.

  2. Sélectionnez ou créez le nouvel assistant d'intelligence artificielle que votre application utilisera.

  3. Allez dans les paramètres de l'assistant.

  4. Cliquez sur Afficher les détails dans la section ID de l'assistant et détails de l'API.

  5. Les champs suivants sont affichés :

    • Instance de service URL

    • ID d'assistant

    • ID d'environnement

  6. Pour trouver ou créer une clé API, consultez la section « Génération d'une clé API pour IBM Cloud ».

  7. Modifiez votre application personnalisée pour utiliser ces nouvelles valeurs.

Astuce :

Testez votre application personnalisée dans un environnement hors production avant sa mise en service.