Migrando para watsonx Orchestrate

Editar online

Este guia explica como migrar suas configurações de watsonx Assistant (Actions, Dialog e Integrations) para watsonx Orchestrate AI Assistants. O processo de migração envolve:

Exportação de ações e diálogos do site watsonx Assistant.
Importando-os para watsonx Orchestrate.
Reconfiguração de integrações, como extensões e bate-papo na Web.

Importante:

As ações de migração podem sobrescrever as configurações existentes no seu Assistente de IA. Sempre faça backup de suas configurações atuais antes de prosseguir.

Antes de iniciar

Consulte a seção Planejamento para obter detalhes sobre o processo de migração e os principais pontos a serem considerados antes da migração.
Se suas ações incluírem chamadas de extensão, consulte Entendendo a correspondência de extensões durante a migração de ações para saber como o sistema faz a correspondência de extensões durante a migração e como evitar incompatibilidades.

Migração das ações do site watsonx Assistant

Extraindo suas ações de watsonx Assistant

Navegue até sua watsonx Assistant instância.
Selecione o Assistente que você deseja migrar.
Vá para Actions (Ações ) para visualizar a tabela Actions (Ações).
Selecione Ações Configurações globais.
Abra a guia Download/Upload.
Faça download do arquivo JSON.

Importação para o Orchestrate

Navegue até sua watsonx Orchestrate instância.
Selecione o AI Assistant para o qual você deseja migrar.
Vá para Actions (Ações ) para visualizar a tabela Actions (Ações).
Abra a guia Download/Upload.
Clique em Carregar.
Selecione o arquivo JSON obtido da instância watsonx Assistant.
Aguarde a conclusão da importação.

Importante:

A importação de ações substituirá as ações existentes no seu assistente de IA do watsonx Orchestrate. Se você precisar preservar a configuração atual, crie um novo AI Assistant antes de executar a migração.

Migrando a caixa de diálogo watsonx Assistant

watsonx Assistant O diálogo está disponível em duas experiências diferentes no produto. Siga o procedimento que corresponde à sua experiência atual em watsonx Assistant :

Experiência clássica
Nova experiência

Importante:

A importação de uma caixa de diálogo substituirá a caixa de diálogo existente no seu assistente de IA do watsonx Orchestrate. Se você precisar preservar a configuração atual, crie um novo AI Assistant antes de executar a migração.

Experiência clássica

Se estiver usando o site watsonx Assistant com a experiência Classic, siga estas etapas para migrar seu Dialog:

Extração de diálogos de watsonx Assistant

Navegue até sua watsonx Assistant instância.
Abra o catálogo de habilidades de diálogo no menu do lado esquerdo.
Selecione um cartão de habilidade de diálogo.
Clique em Mais opções (...) no cartão.
Clique em Download.

Importação de diálogos para watsonx Orchestrate

Navegue até sua watsonx Orchestrate instância.
Abra o menu principal e clique em AI assistant builder.
Mudar para a experiência clássica.
Crie uma habilidade na página Habilidades.
Selecione Dialog.
Escolha Upload skill (Carregar habilidade ) e selecione o JSON da habilidade de diálogo que você baixou.
Aguarde a conclusão do upload.

Nova experiência

Extração de diálogos de watsonx Assistant

Vá para sua watsonx Assistant instância.
Selecione o Assistente que você deseja migrar.
Clique no ícone da árvore de diálogo no menu do lado esquerdo.
Em Options (Opções ), clique em Upload/Download.
Escolha a guia Download e clique em Download.

Importação de diálogos para watsonx Orchestrate

Navegue até sua watsonx Orchestrate instância.
Selecione o AI Assistant para o qual você deseja migrar.
Verifique se a opção Dialog está ativada.
Clique no ícone da árvore de diálogo no menu à esquerda.
Em Options (Opções ), clique em Upload/Download.
Na guia Upload, selecione o JSON de habilidade de diálogo baixado.
Após a conclusão do upload, a habilidade Dialog será carregada.

Integrações

Extensões

Pré-requisitos

Especificação da API no formato JSON que foi usada para criar as extensões.
Credenciais para a API.

Migração de extensões

Se o AI Assistant migrado contiver Ações com etapas que fazem referência a Extensões, essas etapas mostrarão um erro até que as Extensões correspondentes sejam recriadas e configuradas em watsonx Orchestrate.

Vá para sua watsonx Orchestrate instância.
Selecione o AI Assistant que você deseja migrar.
Clique em Criar uma extensão personalizada e siga as etapas.
Após a criação, abra a nova extensão e escolha o ambiente em que você deseja adicionar credenciais.
Adicione as credenciais e confirme.
Os erros de Ações com etapas agora devem ser resolvidos.

Chat na Web e configurações do chat na Web

Para migrar seus bate-papos na Web, você deve considerar os seguintes pontos:

As configurações do bate-papo na Web devem ser atualizadas manualmente no novo AI Assistant.
Você precisa acessar o aplicativo em que a instância do bate-papo na Web está incorporada.

Migrar configurações do bate-papo na Web

Vá para sua watsonx Assistant instância.
Selecione o Assistente com o Web chat que você deseja migrar.
Em uma nova guia ou janela do navegador, abra sua watsonx Orchestrate instância.
Selecione ou crie o AI Assistant com o bate-papo na Web que você deseja atualizar.
Em ambos os assistentes de IA, navegue até Integrações.
Selecione a integração do bate-papo na Web e escolha o ambiente que você deseja migrar.
Copie todas as configurações de watsonx Assistant para watsonx Orchestrate.

Migrar a integração do bate-papo na Web

Se você usou apenas o código incorporado fornecido na interface do usuário watsonx Orchestrate, siga estas etapas:

Vá para sua watsonx Orchestrate instância.
Selecione o AI Assistant com o bate-papo na Web que você deseja migrar.
Vá para Integrações.
Abra a integração do bate-papo na Web e escolha o ambiente que você está migrando.
Vá para a guia Embed e copie o código.
Em seu aplicativo, localize o código incorporado existente.
Substitua o código incorporado existente pelo novo código incorporado.

Se você quiser preservar os elementos personalizados, substitua apenas os IDs:

Acesse sua instância watsonx Orchestrate.
Selecione o AI Assistant com o bate-papo na Web que você deseja migrar.
Vá para Integrações.
Abra a integração do bate-papo na Web e escolha o ambiente que você está migrando.
Vá para a guia Incorporar.
Identifique esses campos em seu código:
- integrationID
- region
- serviceInstanceID
Copie cada um dos campos e salve-os em um local seguro.
Em seu aplicativo, localize o código incorporado e substitua os campos pelos novos valores.

Nota:

Assim que a migração estiver concluída, teste o chat na Web para confirmar se ele se conecta ao Assistente correto e funciona corretamente.

Aplicativo customizado

Atualize seu aplicativo personalizado para apontar para os seguintes IDs do AI Assistant que você migrou:

Instância de serviço URL
ID do assistente
ID do ambiente
apikey

Para encontrar esses valores, siga estas etapas:

Aberto watsonx Orchestrate.
Selecione ou crie o novo AI Assistant que seu aplicativo usará.
Vá para Configurações do Assistente.
Clique em View Details (Exibir detalhes ) na seção Assistant ID and API Details (ID do assistente e detalhes da API ).
Os seguintes campos são exibidos:
- Instância de serviço URL
- ID do assistente
- ID do ambiente
Para localizar ou criar uma chave de API, consulte a seção “Gerando uma chave de API para o IBM Cloud ”.
Modifique seu aplicativo personalizado para usar esses novos valores.

Dica:

Teste seu aplicativo personalizado em um ambiente que não seja de produção antes de colocá-lo em operação.