Migrazione a watsonx Orchestrate

Modifica online

Questa guida spiega come migrare le configurazioni di watsonx Assistant (azioni, finestre di dialogo e integrazioni) a watsonx Orchestrate AI Assistant. Il processo di migrazione prevede:

  • Esportazione di azioni e finestre di dialogo da watsonx Assistant.

  • Importazione in watsonx Orchestrate.

  • Riconfigurazione di integrazioni quali estensioni e chat web.

Importante:

Le operazioni di migrazione possono sovrascrivere le configurazioni esistenti nel tuo Assistente AI. Eseguire sempre un backup delle impostazioni correnti prima di procedere.

Prima di iniziare

Migrazione delle azioni di watsonx Assistant

Estrazione delle azioni da watsonx Assistant

  1. Passare alla propria watsonx Assistant istanza.

  2. Selezionare l' Assistente che si desidera migrare.

  3. Andare su Azioni per visualizzare la tabella Azioni.

  4. Scegliere Azioni Impostazioni globali.

  5. Aprire la scheda Download/Upload.

  6. Scaricare il file JSON.

Importazione in Orchestrate

  1. Passare alla propria watsonx Orchestrate istanza.

  2. Selezionare l' Assistente AI da migrare.

  3. Andare su Azioni per visualizzare la tabella Azioni.

  4. Aprire la scheda Download/Upload.

  5. Fare clic su Carica.

  6. Selezionare il file JSON ottenuto dall'istanza watsonx Assistant.

  7. Attendere il completamento dell'importazione.

Importante:

L'importazione delle azioni sostituirà quelle esistenti nell'assistente AI di watsonx Orchestrate. Se è necessario conservare la configurazione corrente, creare un nuovo Assistente AI prima di eseguire la migrazione.

Finestra di dialogo Migrazione watsonx Assistant

watsonx Assistant Il dialogo è disponibile in due diverse esperienze nel prodotto. Seguite la procedura che corrisponde alla vostra attuale esperienza in watsonx Assistant :

Importante:

L'importazione di una finestra di dialogo sostituirà quella esistente nel tuo assistente AI " watsonx Orchestrate ". Se è necessario conservare la configurazione corrente, creare un nuovo Assistente AI prima di eseguire la migrazione.

Esperienza classica

Se si utilizza watsonx Assistant con l' esperienza Classic, seguire questi passaggi per migrare la finestra di dialogo:

Estrarre le finestre di dialogo da watsonx Assistant

  1. Passare alla propria watsonx Assistant istanza.

  2. Aprire il catalogo delle abilità di dialogo dal menu di sinistra.

  3. Selezionare una scheda di abilità di dialogo.

  4. Fare clic su Altre opzioni (...) sulla scheda.

  5. Fare clic su Download.

Importare le finestre di dialogo in watsonx Orchestrate

  1. Passare alla propria watsonx Orchestrate istanza.

  2. Aprire il menu principale e fare clic su AI assistant builder.

  3. Passare all' esperienza classica.

  4. Creare un'abilità dalla pagina Abilità.

  5. Scegliere Dialogo.

  6. Scegliere Carica abilità e selezionare il JSON dell'abilità di dialogo scaricato.

  7. Attendere il completamento del caricamento.

Nuova esperienza

Estrarre le finestre di dialogo da watsonx Assistant

  1. Andare alla propria watsonx Assistant istanza.

  2. Selezionare l' Assistente che si desidera migrare.

  3. Fare clic sull'icona dell'albero di dialogo nel menu a sinistra.

  4. In Opzioni, fare clic su Carica/Download.

  5. Scegliere la scheda Download e fare clic su Download.

Importare le finestre di dialogo in watsonx Orchestrate

  1. Passare alla propria watsonx Orchestrate istanza.

  2. Selezionare l' Assistente AI da migrare.

  3. Assicurarsi che la finestra di dialogo sia abilitata.

  4. Fare clic sull'icona dell'albero di dialogo nel menu a sinistra.

  5. In Opzioni, fare clic su Carica/Download.

  6. Nella scheda Carica, selezionare l'abilità di dialogo JSON scaricata.

  7. Al termine del caricamento, verrà caricata l'abilità di dialogo.

Integrazioni

Estensioni

Prerequisiti

Migrazione delle estensioni

Se l'Assistente AI migrato conteneva azioni con passi che facevano riferimento a estensioni, tali passi mostreranno un errore finché le estensioni corrispondenti non saranno ricreate e configurate in watsonx Orchestrate.

  1. Andare alla propria watsonx Orchestrate istanza.

  2. Selezionare l' Assistente AI che si desidera migrare.

  3. Fare clic su Crea un'estensione personalizzata e seguire la procedura.

  4. Dopo la creazione, aprire la nuova estensione e scegliere l'ambiente in cui aggiungere le credenziali.

  5. Aggiungere le credenziali e confermare.

  6. Gli errori di Azioni con passaggi dovrebbero ora essere risolti.

Chat web e impostazioni della chat web

Per migrare le chat Web, è necessario considerare i seguenti punti:

  • Le impostazioni della chat web devono essere aggiornate manualmente nel nuovo Assistente AI.

  • È necessario accedere all'applicazione in cui è incorporata l'istanza di chat Web.

Migrazione delle impostazioni della chat Web

  1. Andare alla propria watsonx Assistant istanza.

  2. Selezionare l' Assistente con la chat Web che si desidera migrare.

  3. In una nuova scheda o finestra del browser, aprire la propria istanza watsonx Orchestrate istanza.

  4. Selezionare o creare l'Assistente AI con la chat Web che si desidera aggiornare.

  5. In entrambi gli assistenti AI, spostarsi su Integrazioni.

  6. Selezionare l' integrazione Web chat e scegliere l'ambiente da migrare.

  7. Copiare tutte le impostazioni da watsonx Assistant a watsonx Orchestrate.

Migrare l'integrazione della chat web

Se si è utilizzato solo il codice di incorporamento fornito nell'interfaccia utente di watsonx Orchestrate, seguire questi passaggi:

  1. Andare alla propria watsonx Orchestrate istanza.

  2. Selezionare l' Assistente AI con la chat Web che si desidera migrare.

  3. Andare su Integrazioni.

  4. Aprire l'integrazione Web chat e scegliere l'ambiente da migrare.

  5. Andare alla scheda Embed e copiare il codice.

  6. Nella vostra applicazione, individuate il codice embed esistente.

  7. Sostituire il codice embed esistente con il nuovo codice embed.

Se si desidera conservare gli elementi personalizzati, sostituire solo gli ID:

  1. Andate alla vostra istanza watsonx Orchestrate.

  2. Selezionare l'Assistente AI con la chat Web che si desidera migrare.

  3. Andare su Integrazioni.

  4. Aprire l'integrazione Web chat e scegliere l'ambiente da migrare.

  5. Andare alla scheda Incorpora.

  6. Identificare questi campi nel codice:

    • integrationID

    • region

    • serviceInstanceID

  7. Copiare tutti i campi e salvarli in un luogo sicuro.

  8. Nell'applicazione, individuare il codice incorporato e sostituire i campi con i nuovi valori.

Nota:

Una volta completata la migrazione, prova la chat web per verificare che si colleghi all'Assistente corretto e che funzioni correttamente.

Applicazione personalizzata

Aggiornare l'applicazione personalizzata per puntare ai seguenti ID per l'assistente AI migrato:

  • Istanza di servizio URL

  • ID assistente

  • ID ambiente

  • apikey

Per trovare questi valori, procedere come segue:

  1. Aprire watsonx Orchestrate.

  2. Selezionare o creare il nuovo assistente AI che verrà utilizzato dall'applicazione.

  3. Andare alle Impostazioni dell'assistente.

  4. Fare clic su Visualizza dettagli nella sezione ID assistente e dettagli API.

  5. Vengono visualizzati i seguenti campi:

    • Istanza di servizio URL

    • ID assistente

    • ID ambiente

  6. Per trovare o creare una chiave API, consulta la guida "Generazione di una chiave API per IBM Cloud ".

  7. Modificare l'applicazione personalizzata per utilizzare questi nuovi valori.

Suggerimento:

Prova la tua applicazione personalizzata in un ambiente non di produzione prima di metterla in produzione.