Estendendo Assistentes Digitais e Habilidades

Você pode estender qualquer assistente digital ou habilidade extraídos do Armazenamento de Habilidades para personalizá-los para casos específicos da sua empresa. Quando uma nova versão aparece no Armazenamento de Habilidades, você pode transferir suas personalizações para a nova versão, alterando a base.

Observação

A extensão de assistentes digitais não é suportada para versões anteriores à 20.6.

O Que é Extensão e para Que Serve?

Quando você instala bots (assistentes digitais e habilidades) do Armazenamento de Habilidades, eles podem não atender a todos os seus requisitos ou você pode querer modificá-los para alinhá-los com seus processos de negócios. Você não pode modificar um bot instalado diretamente, mas pode criar uma extensão dele e modificar essa extensão.

Quando você cria uma extensão, você está criando um novo bot que tem um relacionamento estreito com o bot original (base). Por meio desse relacionamento, você poderá aproveitar posteriormente as atualizações do bot base sem precisar reaplicar manualmente suas personalizações. Faça isso usando o recurso Alterar Base. Quando uma nova versão do bot base se torna disponível no Armazenamento de Habilidades, você pode instalar essa versão em sua instância e, em seguida, alterar a base do seu bot estendido para a versão base atualizada.

Observação

Quando você estende um bot, pode adicionar ou modificar as propriedades existentes do bot. No entanto, não é possível excluir propriedades definidas no bot base.

Clonagem e Extensão

Embora a clonagem e a extensão sejam semelhantes em um nível de superfície, elas têm diferenças e propósitos importantes:

Quando você cria um clone de um bot:
- Você cria uma cópia totalmente independente do bot.
- Você pode fazer alterações ilimitadas no clone.
- O clone perde toda a associação com o bot original (os IDs de rastreamento do bot clonado não correspondem aos do original), portanto, você não poderá fazer a alteração de base posteriormente para uma versão atualizada do bot original.
Use a clonagem quando quiser utilizar um bot existente como ponto de partida para seu desenvolvimento.
Quando você estende um bot (uma habilidade ou um assistente digital):
- Você pode fazer uma ampla variedade de adições e alterações no bot estendido, mas não pode excluir nada que foi definido no bot base.
- Você pode alterar a base posteriormente, o que significa aplicar atualizações do bot base no bot estendido.
  A alteração de base é possível para bots estendidos porque os IDs de rastreamento internos gerados para os bots estendidos correspondem aos dos bots base.
Use a extensão quando quiser personalizar um bot e, depois, poderá incorporar quaisquer melhorias ou novos recursos do bot base em sua versão personalizada. Você só pode estender habilidades e assistentes digitais extraídos do Armazenamento de Habilidades.

Observação

Uma terceira abordagem é estender um bot, fazer personalizações e, em seguida, criar um clone do bot estendido. Quando você faz isso, o clone do bot estendido também é tratado como uma extensão do bot original (os IDs de rastreamento internos gerados para o clone da extensão correspondem aos do bot original).

O Que Acontece Quando Você Estende uma Habilidade ou um Assistente Digital

Quando você estende um bot (uma habilidade ou um assistente digital), cada uma das partes do bot (como intenções, entidades e propriedades) tem um dos seguintes status:

Herdado (): artefatos definidos no bot base. Depois de criar uma extensão, todos os artefatos no bot terão esse status.
Local: artefatos criados na extensão (por exemplo, novas intenções).
Personalizado (): artefatos herdados do bot base cujos valores foram alterados na extensão.

Quando você estende uma habilidade, os filtros desses status aparecem na guia Intenções acima da lista de intenções e acima da lista de exemplos.

Quando você estende um assistente digital, os filtros desses status aparecem acima da lista de habilidades (na guia Habilidades) e acima da lista de exemplos (na guia Intenções).

Observação

Não é possível excluir artefatos (como habilidades em assistentes digitais e intenções e entidades em habilidades), mas você pode desativá-los.

Observação Importante para Desenvolvedores de Bots Base

Se você é um desenvolvedor de uma habilidade ou de um assistente digital que foi submetido a upload para o Armazenamento de Habilidades e precisa atualizar esse bot no Armazenamento de Habilidades, você deve criar a versão atualizada por meio da opção Nova Versão para que os usuários possam alterar a base de suas respectivas versões estendidas para a versão base atualizada. Se você clonar o bot existente ou simplesmente criar um novo bot com o mesmo nome, os IDs de rastreamento interno gerados para o novo bot serão diferentes daqueles do bot existente, portanto, não haverá correlação entre os bots.

Habilidades

Veja o que você precisa saber sobre como estender habilidades extraídas do Armazenamento de Habilidades.

Estender uma Habilidade

Clique em para abrir o menu lateral e selecione Desenvolvimento > Habilidades.
No mosaico da habilidade que você deseja estender, clique no ícone Opções () e selecione Estender.

Essa habilidade deve ser uma habilidade obtida do Armazenamento de Habilidades.

O Que Você Pode Adicionar e Personalizar em uma Habilidade Estendida

Intenções. Você pode adicionar declarações, alterar declarações existentes e adicionar novas intenções. Você não pode excluir declarações ou intenções, mas pode desativar intenções.
Entidades. Você pode adicionar valores de entidade, adicionar sinônimos a valores de entidade e adicionar novas entidades. Além disso, você pode editar estes campos:
- Tamanho da Faixa de Enumeração
- Mensagem de Erro
- Diversos Valores
- Correspondência Difusa
No entanto, não é possível excluir entidades ou excluir ou alterar valores de entidade.
Fluxo de caixas de diálogo. É possível fazer alterações em todo o fluxo de caixas de diálogo. Não há limitações específicas. No entanto, nenhum delta é rastreado pelo sistema. Ao alterar a base da extensão da habilidade, é apresentada uma ferramenta de diferenciação para comparar seu fluxo de caixas de diálogo lado a lado com o fluxo da nova habilidade base. Cabe então a você determinar o que manter da sua habilidade e o que apresentar da nova habilidade de base.
Pacotes de recursos. Você pode:
- Adicionar novas chaves de mensagem em qualquer um dos idiomas suportados.
- Modifique qualquer mensagem existente.
Serviço de componente personalizado. Você pode:
- Substituir o arquivo do pacote.
- Adicione componentes ao serviço.
Você não pode:
- Remover componentes.
Você pode alterar a implementação de componentes personalizados em sua habilidade estendida. Entretanto, se o componente personalizado for atualizado posteriormente na habilidade de base, essas atualizações não serão mescladas com as alterações feitas no componente na habilidade estendida quando você alterar a base da habilidade. Nesse caso, você precisaria mesclar manualmente as alterações de componentes personalizados da habilidade base atualizada em sua habilidade estendida.
Definições. Você pode ajustar a maioria das definições para a habilidade, incluindo:
- Propriedades gerais, como a descrição da habilidade.
- Modelo de treinamento.
- Se insights e o log de conversas são ativados.
- Valores de parâmetros do sistema, como o limite de confiança e solicitações padrão.
- Parâmetros personalizados. (Você pode criar novos parâmetros personalizados e modificar valores de parâmetros existentes.)
- Valores de propriedades do assistente digital, como Chamada, Declarações de Exemplo, Estado Inicial, Estado de Boas-vindas e Estado de Ajuda.

Modificações Que Não São Preservadas ao Alterar a Base

Módulo de Perguntas e Respostas. Você pode modificar o conteúdo de um módulo de perguntas e respostas em uma habilidade estendida, mas essas modificações serão descartadas se posteriormente você alterar a base da habilidade.
Se você tiver modificado um módulo de perguntas e respostas em sua habilidade estendida, exporte o arquivo de origem de perguntas e respostas antes de alterar a base.

Observação

Esta limitação não se aplica às intenções de resposta.

Desativar Intenções

Quando você estende uma habilidade, não é possível remover intenções, mas pode desativá-las.

Ao desativar uma intenção, exclua-a do modelo de treinamento. Qualquer entrada do usuário que, de outra forma, coincidisse bem com os dados de treinamento de uma intenção desativada, em vez disso, será resolvida para outra intenção (provavelmente unresolvedIntent).

Se posteriormente você alterar a base da habilidade, quaisquer intenções desativadas permanecerão desativadas. Se você reativar uma intenção depois de alterar a base, selecionará todas as alterações feitas nessa intenção na habilidade base.

Para desativar uma intenção:

Na barra de navegação esquerda da habilidade estendida, clique em .
Selecione a intenção que você deseja desativar.
Alterne a posição da opção Ativado da intenção para OFF.
Clique no botão Treinar no canto superior direito da página e clique em Submeter.

Observação

Se você quiser excluir a funcionalidade de uma intenção de uma habilidade, mas quiser permitir que o usuário saiba que a funcionalidade da intenção não está disponível, mantenha a intenção ativada, mas informe uma resposta estática no campo Resposta da intenção. Quando você faz isso, esse texto é exibido quando a entrada do usuário é resolvida para essa intenção. Consulte Intenções de Resposta para obter mais informações sobre como isso funciona.

Assistentes Digitais

Veja o que você precisa saber sobre como estender assistentes digitais extraídos do Armazenamento de Habilidades.

Estender um Assistente Digital

Clique em para abrir o menu, lateral e selecione Desenvolvimento > Assistentes Digitais.
No mosaico do assistente digital que você deseja estender, clique no ícone Opções () e selecione Estender.

Esse assistente digital deve ter sido extraído do Armazenamento de Habilidades.

O Que Você Pode Adicionar e Personalizar em um Assistente Digital Estendido

Habilidades. Você pode adicionar outras habilidades. Não é possível excluir habilidades herdadas do assistente digital base, mas você pode desativá-las.
Intenções do Sistema. Para as intenções exit, help e unresolvedIntents, você pode adicionar declarações e alterar declarações existentes.
Definições. Você pode ajustar a maioria das definições do assistente digital, incluindo:
- Propriedades gerais, como a descrição do assistente digital.
- Modelo de treinamento.
- Se os insights são ativados.
- Parâmetros de roteamento, como os vários limites de confiança e prompts padrão.
- Parâmetros personalizados. Você pode criar novos parâmetros personalizados e modificar valores de parâmetros existentes.

Desativar Habilidades

Quando você estende um assistente digital, não pode remover habilidades, mas pode desativá-las.

Ao desativar uma habilidade, exclua-a do modelo de treinamento. Qualquer entrada do usuário que, de outra forma, corresponderia bem aos dados de treinamento da habilidade será resolvida em outro lugar (provavelmente a unresolvedIntent do assistente digital).

Se posteriormente você alterar a base do assistente digital, quaisquer habilidades desativadas permanecerão desativadas. Se você reativar uma habilidade depois de alterar a base, selecionará todas as alterações feitas nessa habilidade no assistente digital de base.

Para desativar uma habilidade:

Na navegação esquerda do assistente digital, clique em .
Selecione a habilidade que você deseja desativar.
Alterne a posição da opção Ativado da habilidade para OFF.

Atualizar uma Habilidade em um Assistente Digital Estendido

Se você tiver um assistente digital estendido que contenha uma habilidade que tenha uma versão mais recente instalada em sua instância, poderá atualizar o assistente digital para usar essa versão mais recente.

Clique em para abrir o menu, lateral e selecione Desenvolvimento > Assistentes Digitais.
Clique no mosaico do assistente digital para abri-lo.
Na guia Habilidades do assistente digital, selecione a habilidade que deseja substituir por uma versão mais recente.

A habilidade deve ter a placa .
Clique em Atualizar Habilidade.
Na lista drop-down Nova Versão da Habilidade, selecione a versão da habilidade que deseja incluir e clique em Atualizar Habilidade.
Ative a opção Substituir Modelo de Interação.

Se você quiser que as alterações feitas nas propriedades Invocação e Declarações de Exemplo definidas na guia Assistente Digital da página Definições da habilidade sejam propagadas para o assistente digital, deixe essa opção na posição ON.

Esses valores são usados no cartão de ajuda da habilidade no assistente digital.
Clique em Atualizar Habilidade.

Estender uma Habilidade em um Assistente Digital Estendido

Se você tiver estendido um assistente digital para substituir uma de suas habilidades base por uma versão estendida dessa habilidade, será necessário seguir estas etapas gerais:

Estenda a habilidade e faça as personalizações desejadas a ela.
Treine a habilidade.
(Uma habilidade precisa ser treinada antes de ser publicada.)
No assistente digital, atualize a versão da habilidade que ele usa executando o seguinte procedimento:
1. Clique em para abrir o menu, lateral e selecione Desenvolvimento > Assistentes Digitais.
2. Clique no mosaico do assistente digital para abri-lo.
3. Na guia Habilidades do assistente digital, selecione a habilidade que você estendeu. Essa habilidade deve ter a placa .
4. Clique em Atualizar Habilidade.
5. Na lista drop-down Nova Versão da Habilidade, selecione a versão estendida da habilidade e clique em Atualizar Habilidade.
Depois de testar o assistente digital com a nova versão da habilidade e ficar satisfeito com seu comportamento, publice a habilidade.

Fazer, Revisar e Reverter Personalizações

Você pode adicionar ou personalizar um bot estendido (habilidade ou assistente digital) usando qualquer um de seus controles ativados e campos editáveis.

Você pode revisar personalizações feitas em um bot clicando no ícone que aparece ao lado do campo que foi personalizado. (Para obter declarações de exemplo de uma intenção, passe o mouse sobre o ícone ao lado da expressão para exibir o ícone .

Quando você clica neste ícone, a caixa de diálogo Revisar Personalização é exibida, o que permite comparar o valor atual do campo com o valor base. Se quiser reverter para o valor no bot base, clique em Reverter para Original.

Testando Personalizações

Você pode usar o recurso Casos de Teste para garantir que quaisquer modificações feitas em suas extensões não tenham desfeito nenhuma das funções básicas do bot.

Você pode criar os testes gravando conversas no testador. Além disso, algumas habilidades e assistentes digitais no Armazenamento de Habilidades vêm com casos de teste, que você pode executar em suas extensões para se certificar de que não desfez nenhuma das funcionalidades.

Consulte Suítes de Teste e Casos de Teste para ver detalhes sobre como criar e usar casos de teste.

Alterando a Base

Se uma nova versão base de um bot estendido for disponibilizada, você poderá alterar a base do bot estendido para que ele selecione as alterações no bit base e mantenha as personalizações feitas no bot estendido. A alteração de base está disponível para habilidades e assistentes digitais.

Você também pode alterar a base de qualquer versão do bot que descenda do bot original, seja uma versão do bot original ou uma versão estendida do bot. (Isso não se aplica a clones ou bots criados separadamente, mas com o mesmo nome.)

Como Funciona a Alteração de Base

Quando você altera a base, acontece o seguinte no bot estendido:

Uma nova versão da extensão é criada.
Quaisquer novos artefatos (como novas intenções) na nova versão do bot base (ou seja, aqueles que foram adicionados após a criação da extensão ou a última alteração de base) são adicionados à extensão.
Todos os artefatos locais (aqueles que foram criados na extensão) são mantidos na extensão.
Quaisquer personalizações de artefatos (como alterações de valores de propriedade) são mantidas.
Observação

Os valores de propriedade personalizados sempre têm precedência sobre as alterações no bot base. Se quiser usar os valores da nova base, você poderá reverter as alterações depois que o processo de alteração de base for concluído.
Todos os artefatos herdados incluídos na versão atual do bot base que não forem personalizados e e que forem removidos da nova versão do bot base serão excluídos.
Os artefatos personalizados que não existirem mais no novo bot base serão incluídos na extensão com alteração de base. Na extensão, eles são tratados como artefatos locais, para que você possa excluí-los se eles não forem mais necessários.

Cuidado:

Se a nova versão do bot base e a extensão tiverem um novo artefato com a mesma chave (geralmente o nome), a alteração de base não poderá resolver os dois e, portanto, falhará. Nesse caso, você precisará excluir a versão local do artefato antes de fazer a alteração de base com sucesso.

Alterar Base de uma Extensão de Habilidade

Se você ainda não tiver feito isso, instale a habilidade atualizada:
1. Clique em para abrir o menu lateral e selecione Desenvolvimento > Armazenamento.
2. No mosaico da habilidade base atualizada, clique em e selecione Obter.
Clique em para abrir o menu lateral, selecione Desenvolvimento > Habilidades e clique no mosaico da versão estendida da habilidade para abri-lo.
Na navegação esquerda da habilidade, clique em
Clique no botão Alterar Base.
Na lista drop-down Habilidade Base, selecione a versão da habilidade para a qual você está alterando a base e clique em Próximo.
Conclua o assistente.

Se a alteração de base for bem-sucedida, a nova versão com alteração de base da habilidade será criada e aberta no modo Rascunho.

Se a alteração de base não for bem-sucedida, uma mensagem de erro aparecerá indicando o bloqueio da alteração de base bem-sucedida e uma nova versão da habilidade estendida não será criada.

Alterar a Base de uma Extensão do Assistente Digital

Se você ainda não tiver feito isso, instale o assistente digital atualizado:
1. Clique em para abrir o menu lateral e selecione Desenvolvimento > Armazenamento.
2. No mosaico do assistente digital base atualizado, clique em e selecione Obter.
Clique em para abrir o menu lateral, selecione Desenvolvimento > Assistentes Digitais e clique no mosaico da versão estendida do assistente digital para abri-lo.
Na navegação esquerda do assistente digital, clique em .
Clique no botão Alterar Base.
Na lista drop-down Assistente Digital Base, selecione a versão da habilidade para a qual você está alterando a base e clique em Próximo.
Conclua o assistente.

Se a alteração de base for bem-sucedida, a nova versão com alteração de base do assistente digital será criada e aberta no modo Rascunho.

Se a alteração de base não for bem-sucedida, uma mensagem de erro aparecerá indicando o bloqueio da alteração de base bem-sucedida e uma nova versão do assistente digital estendido não será criada.

Como Responder a uma Alteração de Base com Falha?

Se a alteração de base de uma habilidade ou de um assistente digital falhar, aqui estão as etapas para tentar alterar a base novamente:

Crie uma nova versão da extensão do bot.
Faça alterações na extensão para resolver erros na tentativa de alteração de base. Isso pode simplesmente significar a reversão de quaisquer personalizações que tenham entrado em conflito com as alterações no bot base.
Tente fazer a alteração de base da versão da extensão.

Ramificando uma Extensão

Também é possível criar um clone de uma extensão para que você possa trabalhar em diversas ramificações em paralelo. Por exemplo, você pode fazer isso quando tiver um bot estendido em produção, mas quiser ter uma extensão com outro nome na qual esteja trabalhando em alterações significativas.

Ao clonar uma extensão, o bot estendido também é tratado como uma extensão do bot original, o que significa que:

No design-time, os vários artefatos são marcados como herdados, locais e personalizados, assim como em outros bots estendidos.
Você pode alterar a base de novas versões do bot original.
Os IDs de rastreamento internos que são gerados para o clone da extensão correspondem aos do bot original.

Observação

A clonagem funciona com extensão de bot somente se você primeiro criar um bot estendido.

Ciclo de Vida Pós-Implantação de uma Habilidade Estendida

Depois de implantar uma versão estendida de uma habilidade, é importante estabelecer uma rotina para incorporar melhorias e, em seguida, reimplantar.

Aqui está um exemplo de como essa rotina pode se parecer, com base nas seguintes suposições:

Você está usando Insights continuamente para melhorar a resolução da intenção na habilidade.
Você adiciona periodicamente novos recursos à habilidade.
Você tem duas instâncias do Digital Assistant (uma para produção e outra para teste e preparação).

Na sua instância de produção, crie uma nova versão da habilidade implantada.
Você cria uma nova versão da habilidade em sua instância de produção para que possa capturar dados de Insights do uso real do cliente e, em seguida, usar o Retrainer para complementar seu modelo de treinamento com declarações que a habilidade não entendeu corretamente antes.

Para facilitar a leitura desse procedimento, vamos supor que a habilidade publicada seja a versão v1 e a nova versão de rascunho seja v1.1.
Avalie os relatórios de Insights sobre a habilidade e complete os dados de treinamento de suas intenções com declarações adicionais para tratar frases válidas do usuário que não foram levadas em consideração em seus dados de treinamento anteriores.
Como parte desse processo, você pode usar o Retrainer de Insights para adicionar declarações não resolvidas às intenções apropriadas.
Exporte a habilidade (v1.1 no exemplo acima).
Em sua instância de teste ou preparação, importe a habilidade que você acabou de exportar da instância de produção (v1.1).
Na instância de teste ou preparação, crie uma nova versão da habilidade importada. Esta nova versão será para incorporar quaisquer novos recursos que você esteja adicionando à habilidade. (Vamos nos referir a essa versão como v2.)
Em v2, incorpore quaisquer adições ou alterações de recursos que você deseja incluir.
Se você estiver desenvolvendo essas alterações em outro lugar, mescle-as manualmente em v2.
Treine e teste v2 até estar satisfeito com os resultados.
Exporte a habilidade (v2) da sua instância de teste.
Em sua instância de produção, importe a habilidade que você acabou de treinar e testar (v2).
Treine a habilidade.
Publique a habilidade.
Se você estiver implantando a habilidade como parte de um assistente digital, crie uma nova versão do assistente digital.
Atualize a nova versão do assistente digital para usar a nova versão da habilidade (v2).
Atualize o canal para usar a nova versão do assistente digital.
Publique a nova versão do assistente digital.

Documentação do Oracle Cloud Infrastructure