Você pode criar uma habilidade clonando uma versão de outra habilidade ou importando uma; ou pode criar uma do zero, conforme descrito aqui.

1. Clique em para abrir o menu lateral, selecione Desenvolvimento > Habilidades e clique em Nova Habilidade.

2. Na caixa de diálogo Criar Habilidade, preencha os campos obrigatórios.

3. No campo Versão da Plataforma, como opção, selecione outra versão da plataforma.

   Essa definição afeta o comportamento de suas habilidades, como a forma como o mecanismo NLU (Natural Language Understanding) resolve intenções. Por padrão, o valor é definido como a versão mais recente da plataforma.

   Se você precisar especificamente do clone para se comportar como habilidades com base em uma versão de plataforma distinta, selecione a versão da plataforma usada por essas habilidades.

   Consulte Versão da Plataforma.

4. Se você tiver selecionado a versão 20.12 ou mais recente da plataforma, no campo Idioma Principal, selecione o idioma padrão da sua habilidade.

   Se você planeja projetar a habilidade para vários idiomas, considere sua escolha com muito cuidado. Particularmente, se você quiser dar suporte a qualquer idioma que não seja um dos idiomas suportados nativamente, role para baixo até a seção Serviço de Tradução do menu drop-down e selecione Inglês.

   Consulte Idiomas e Habilidades para obter informações detalhadas sobre como criar suas habilidades para os idiomas de destino desejados.

   Observação
   
   Nas versões 20.09 e anteriores da plataforma, você não especifica um idioma principal. Em vez disso, um idioma predominante é detectado automaticamente para a habilidade quando você a configura com um serviço de tradução.

5. Clique em Criar.

Após a criação da habilidade, ela aparece no Catálogo de Habilidades no modo de rascunho.

Se quiser criar uma habilidade semelhante a uma existente ou reutilizar os artefatos de uma habilidade existente, você poderá criar a habilidade clonando.

Para clonar uma versão de uma habilidade:

1. No Catálogo de Habilidades, localize a versão da qual clonar.

2. Clique no ícone Opções e selecione Clonar.

3. Preencha a caixa de diálogo, prestando atenção especial a estes campos:
   • Versão da Plataforma: A versão da plataforma afeta o comportamento de suas habilidades; por exemplo, o modo como o mecanismo NLU (Natural Language Understanding) resolve intenções e quais idiomas são suportados de forma nativa.

     Se você precisar especificamente do clone para se comportar como a habilidade base, selecione a versão da plataforma usada pela habilidade base.

     Consulte Versão da Plataforma.

   • Idioma Principal: (Só será exibido se a versão da plataforma selecionada for 20.12 ou mais recente.) Isso determina o idioma padrão da habilidade e se a habilidade usará suporte nativo para esse idioma ou dependerá de um serviço de tradução.

     Se você planeja criar a habilidade para vários idiomas, considere sua escolha aqui com muito cuidado. Particularmente, se você quiser dar suporte a qualquer idioma que não seja um dos idiomas suportados nativamente, deverá rolar para baixo até a seção Serviço de Tradução do menu drop-down e selecionar Inglês.

     Consulte Idiomas e Habilidades para obter informações detalhadas sobre como criar suas habilidades para os idiomas de destino desejados.

     Observação
     
     Nas versões 20.09 e anteriores da plataforma, você não especifica um idioma principal. Em vez disso, um idioma predominante será detectado automaticamente se você tiver configurado a habilidade com um serviço de tradução.

Você pode criar uma habilidade importando uma versão de uma habilidade que foi exportada de outra instância. A habilidade importada estará no modo de rascunho, mesmo que tenha sido publicada na instância de origem.

Para importar uma versão de uma habilidade:

1. No Catálogo de Habilidades, clique em Importar Habilidade.

2. Faça upload do arquivo ZIP que contém a habilidade exportada.

3. Por padrão, o Insights é desativado para habilidades importadas. Para ativar o relatório do Insights para a habilidade importada, primeiramente clique em e depois escolha Ativar Insights.

Em algum ponto, talvez você queira criar outra versão de uma habilidade, como adicionar novos recursos.

Para criar outra versão:

1. No Catálogo de Habilidades, localize a versão da qual criar outra versão.

2. Clique no ícone Opções e selecione Nova Versão.

3. Preencha a caixa de diálogo, prestando atenção especial a estes campos:
   • Versão da Plataforma: A versão da plataforma afeta o comportamento de suas habilidades; por exemplo, o modo como o mecanismo NLU (Natural Language Understanding) resolve intenções e quais idiomas são suportados de forma nativa.

     Se você precisar especificamente que essa versão da habilidade se comporte exatamente como a versão anterior, selecione a versão da plataforma usada pela habilidade base.

     Consulte Versão da Plataforma.

   • Idioma Principal: (Só será exibido se a versão da plataforma selecionada for 20.12 ou mais recente.) Isso determina o idioma padrão da habilidade e se a habilidade usará suporte nativo para esse idioma ou dependerá de um serviço de tradução.

     Se você planeja criar a habilidade para vários idiomas, considere sua escolha aqui com muito cuidado. Particularmente, se você quiser dar suporte a qualquer idioma que não seja um dos idiomas suportados nativamente, deverá rolar para baixo até a seção Serviço de Tradução do menu drop-down e selecionar Inglês.

     Consulte Idiomas e Habilidades para obter informações detalhadas sobre como criar suas habilidades para os idiomas de destino desejados.

     Observação
     
     Nas versões 20.09 e anteriores da plataforma, você não especifica um idioma principal. Em vez disso, um idioma predominante será detectado automaticamente se você tiver configurado a habilidade com um serviço de tradução.

Ao criar uma habilidade, você tem duas opções de como projetar o fluxo de caixas de diálogo:

• Visual. Você usa o Designer de Fluxo Visual para projetar fluxos de caixas de diálogo em uma tela com blocos para cada estado e com as conexões entre estados também representadas visualmente. Variáveis, parâmetros e propriedades de componentes são definidos em editores e caixas de diálogo especializados. Além disso, o editor visual permite que você crie fluxos modulares. Este é o modo padrão para novas habilidades.
• AML. Você define o framework do intercâmbio de habilidades do usuário em uma linguagem de marcação simples que permite descrever uma caixa de diálogo, tanto em termos do que a sua habilidade diz quanto do que ela faz. Toda a definição do fluxo de caixas de diálogo é definida em um único arquivo.

Para preparar uma versão de uma habilidade a ser usada em um assistente digital, configure as seguintes definições:

• Nome da Chamada: Nome com o qual o usuário pode chamar explicitamente a habilidade no assistente digital.

  Consulte Diretrizes de Nome da Chamada.

• Exemplo de Declarações: Ajudam o Mecanismo de Intenções a identificar quando o usuário deseja chamar essa habilidade. Nas declarações de exemplo, é melhor também incluir o nome da chamada para melhorar as declarações de correspondência do usuário com a habilidade.

  As primeiras declarações também aparecem no cartão da habilidade que o assistente digital fornece por padrão para os estados de boas-vindas e ajuda.

Para habilidades desenvolvidas no modo YAML, você pode especificar opcionalmente as definições Estado Inicial, Estado de Boas-vindas e Estado de Ajuda. Consulte Estados de Início, Boas-vindas e Ajuda. (Para habilidades desenvolvidas no modo Visual, essas configurações não estão disponíveis. Em vez disso, você especifica esses estados usando eventos. Consulte Eventos Incorporados para o Fluxo Principal.)

Além disso, você pode usar o campo Grupo para agrupar a habilidade com outras habilidades relacionadas. Isso pode melhorar o comportamento de roteamento no seu assistente digital. A designação do grupo de habilidades pode ser alterada no nível do assistente digital. Consulte Grupos de Habilidades.

Para acessar essas definições:

1. Clique em para abrir o menu lateral, selecione Desenvolvimento > Habilidades e abra sua habilidade.

2. Na navegação esquerda da habilidade, clique em e selecione a guia Assistente Digital.

Para excluir uma versão de uma habilidade, clique no ícone Opções e selecione Excluir.

Ao concluir a criação de uma versão, você pode bloqueá-la publicando-a. A única modificação que você pode fazer em uma habilidade publicada é alterar os valores de parâmetros personalizados na guia Configuração. Para fazer mais modificações, crie outra versão e trabalhe nela.

Para publicar uma versão:

1. Se a habilidade tiver intenções ou módulo de perguntas e respostas, certifique-se de que ela tenha sido treinada. Treine-a para poder publicá-la.

2. No Catálogo de Habilidades, localize a versão que você deseja publicar.

3. Clique no ícone Opções e selecione Publicar.

   A versão da habilidade no Catálogo de Habilidades agora tem um ícone de bloqueio para mostrar que ela foi publicada.

Se você tiver várias instâncias do Digital Assistant e quiser copiar uma habilidade de uma instância para outra, use os comandos Exportar e Importar:

1. Faça log-in na instância da qual deseja exportar a habilidade.

2. Clique em para abrir o menu lateral e selecione Desenvolvimento > Habilidades.

3. No mosaico da habilidade que você deseja exportar, clique em e selecione Exportar.

   Um arquivo zip com a habilidade será submetido a download para o seu sistema.

4. Faça log-in na instância para a qual deseja exportar a habilidade.

5. Clique em para abrir o menu lateral e selecione Desenvolvimento > Habilidades.

6. Clique em Importar Habilidade.

7. Faça upload do arquivo ZIP que contém a habilidade exportada.

8. Por padrão, o Insights é desativado para habilidades importadas. Para ativar o relatório do Insights para a habilidade importada, primeiramente clique em e depois escolha Ativar Insights.

Assim que tiver criado e nomeado a habilidade, você poderá iniciar o desenvolvimento. Veja a seguir uma visualização de alto nível do processo de desenvolvimento.

Descrição da ilustração bots-overall-process.png

1. Criar Intenções — Comece criando as intenções. As intenções ilustram seu caso de uso, descrevendo as diversas ações que sua habilidade ajuda seus usuários a executar. Se sua habilidade permitir que os usuários executem várias transações bancárias, por exemplo, você poderá criar intenções como CheckBalance ou TransferMoney. As intenções não só descrevem o que sua habilidade pode fazer, como também são a chave para a inteligência da sua habilidade: elas permitem que ela reconheça a entrada do usuário, porque cada intenção tem um conjunto de instruções típicas do usuário conhecidas como declarações associadas a ela. Embora essas frases compartilhem o mesmo significado, elas tornam sua habilidade resiliente porque também variam (por exemplo, Qual é o saldo da minha conta poupança? e Quanto tem em minha conta corrente?). Consulte Intenções.

2. Treinar a Habilidade — Para permitir que sua habilidade mencione intenções quando ela fizer parsing da entrada do usuário, você precisará treiná-la. Especificamente, treine-a com as intenções e suas declarações (coletivamente, os dados de treinamento) para que ela possa resolver a entrada do usuário com uma das intenções. Ao treinar sua habilidade, você aproveita a estrutura de inteligência de idioma. Seus algoritmos permitem que a habilidade não só reconheça as frases de amostra que pertencem a cada intenção, como também frases semelhantes. Consulte Treinamento e Teste de Intenções.

3. Criar Entidades — Em alguns casos, pode ser necessário fornecer um contexto para permitir que a habilidade conclua a solicitação de um usuário. Embora algumas solicitações do usuário possam ser resolvidas com a mesma intenção (Qual é o saldo da minha conta poupança? e Quanto tenho em minha conta corrente? seriam resolvidas com a intenção CheckBalance, por exemplo), elas ainda assim estão solicitando coisas distintas. Para esclarecer a solicitação, você adicionaria uma entidade. Usando o exemplo de habilidade bancária, uma entidade chamada AccountType, que define os valores corrente e poupança, permitiria que a habilidade fizesse parsing da solicitação e respondesse o usuário adequadamente. Consulte Entidades.

4. Criar o Fluxo de Caixas de Diálogo — Em seguida, você precisa conceder à habilidade a capacidade de expressar sua inteligência a seus usuários criando o fluxo de caixas de diálogo. O fluxo de caixas de diálogo descreve como a habilidade reage à medida que diferentes intenções são resolvidas. Ele define o que a habilidade diz aos usuários, como solicita entrada a eles e como retorna dados. Consulte Designer de Fluxo Visual.

5. Integrar Componentes Personalizados — Nesse ponto, sua habilidade pode reconhecer entrada, mas não pode responder a ela. Para colocar a inteligência de sua habilidade para funcionar, adicione componentes. Os componentes permitem que a habilidade faça seu trabalho. Há dois tipos de componentes: os que fornecemos que executam funções que variam desde manter a intenção que é resolvida pela mensagem do usuário até gerar texto e aqueles que você cria para executar tarefas específicas de uma habilidade específica, como verificar o saldo de uma conta. Consulte Adicionar Pacote de Componentes a uma Habilidade.

6. Testar a Habilidade — Depois que tiver iniciado seu fluxo de caixas de diálogo, você poderá bater papo com sua habilidade para testá-la.

7. (Opcionalmente) Rotear para Canais de Mensagens do Usuário e Outros Recursos — Se sua habilidade não for adicionada a um assistente digital, você precisará adicioná-la a um ou mais canais. Os usuários batem papo com sua habilidade por meio de várias plataformas de mensagens, aplicativos de mensagens proprietários e páginas Web. Você pode rotear um ou mais desses canais de mensagens do usuário para sua habilidade. Ela é executada igualmente bem em qualquer um deles, quer sejam cartões de rolagem somente texto ou de suporte, elementos da IU e imagens. Além desses canais voltados para o usuário, há outros canais: um que vincula sua habilidade a um sistema de suporte ao cliente e outro que roteia notificações de um aplicativo externo que solicita à habilidade o início de uma conversa.

8. Revisar Relatórios de Insights — Depois de publicar sua habilidade, você poderá examinar os relatórios de Insights para descobrir se seus clientes a estão utilizando como desejado. De métricas de uso de alto nível e tendências de conversas a exibições individuais de intenções, seus caminhos de execução e transcrições de conversas, esses relatórios fornecem perspectivas distintas sobre o suporte que sua habilidade oferece a seus clientes e onde ela os impede de concluir uma tarefa. Esses relatórios não só permitem que você destaque áreas de problemas rapidamente, mas também sugerem entrada do usuário que possa melhorar a resolução de intenções de sua habilidade. Consulte Insights.

Ao repetir suas definições de fluxo de caixas de diálogo, intenções, entidades e assistentes digitais, você pode verificar seu trabalho e aplicar as melhores práticas clicando em Validar no banner.

Descrição da ilustração analyzezer-dialog-flow-line.png
Para habilidades, a caixa de diálogo Resultados de Validação resultante lista erros críticos que você deve corrigir, avisos e dicas que apontam onde você pode precisar fazer melhorias.

Skill confidence threshold is set to 0.4. We recommend to set the threshold to at least 0.7 to improve accuracy of intent matching.

Embora as mensagens de validação no nível da habilidade incluam mensagens de erro, advertência e dica, a validação no nível do assistente digital consiste em mensagens de advertência para declarações compartilhadas pelas habilidades registradas no assistente digital.

Descrição da ilustração analyzezer-da-validate-message.png

Por exemplo:

The utterance 'Cancel my order' is used in 2 intents: wineSkill, pizzaSkill. Duplicate utterances may cause ambiguity in the model.

Descrição da ilustração analyzezer-da-validation.png

Você pode filtrar essas mensagens por advertências ou dicas. Você pode ocultar ou reabrir o diálogo Resultados da Validação clicando em Descobertas.

Os seguintes nomes não podem ser usados para habilidades:

• type
• version