Documentação do Oracle Cloud Infrastructure

Componentes

Os estados de um fluxo de caixas de diálogo são baseados em componentes que executam ações, como aceitar entrada do usuário, verificar essa entrada ou responder com texto.

Há dois tipos de componentes que você pode usar em um fluxo de caixas de diálogo – componentes incorporados e personalizados. Quando o Mecanismo de Caixa de Diálogo entra em um estado no fluxo de caixas de diálogo, ele avalia o componente. Quando encontra um dos componentes incorporados, ele executa uma das tarefas genéricas, como exibir uma mensagem ou solicitar que o usuário digite texto. Quando o Mecanismo de Caixa de Diálogo descobre um componente personalizado, ele chama o serviço do componente, que hospeda um ou mais componentes personalizados.

Componentes Incorporados

O Digital Assistant fornece um conjunto de componentes que suportam uma faixa de ações genéricas, que você pode usar em qualquer habilidade: segurança, fazendo parsing da entrada do usuário, roteando o fluxo de caixas de diálogo com base na entrada do usuário e gerando as respostas da habilidade de várias maneiras. A menos que você precise de integração com backends ou execute uma lógica extremamente complexa, esses componentes fornecerão as ações de que seus estados precisam.

A maneira como você acessa os componentes depende se você está projetando o fluxo de caixas de diálogo com o Visual Flow Designer ou no modo YAML:

  • Se você estiver usando o Designer de Fluxo Visual, adicione o primeiro estado de um componente incorporado a um fluxo passando o mouse sobre seu mosaico Iniciar, clicando no menu o ícone do menu Adicionar Estado, selecionando Adicionar estado inicial e selecionando um modelo de componente na caixa de diálogo Adicionar Estado. Você pode adicionar estados subsequentes selecionando Adicionar estado no menu de um estado ou clicando no ícone Adicionar um estado a essa transição entre dois estados. Consulte Criando Fluxos.
  • Se você estiver projetando sua habilidade no modo YAML, adicione um estado para um componente incorporado ao fluxo de caixas de diálogo selecionando + Componentes e, em seguida, selecionando um modelo de componente no menu.

Quando você validar seu fluxo de caixas de diálogo, o Digital Assistant verificará as propriedades do componente. Por exemplo, ele reportará se você esquecer de incluir uma propriedade obrigatória.

Para obter detalhes sobre os modelos de componente disponíveis no Designer de Fluxo Visual, consulte Modelos de Componente

Para obter detalhes sobre os componentes disponíveis no modo YAML, consulte Componentes Incorporados: Propriedades, Transições e Uso.

Componentes Personalizados

A maioria das habilidades precisa se integrar aos dados de sistemas remotos ou fazer algum processamento de backend. Por exemplo, sua habilidade poderá precisar obter uma lista de produtos ou salvar as informações do pedido. Outro exemplo é que sua habilidade pode precisar executar lógica complexa que você não pode realizar usando FreeMarker ou um handler de eventos de entidade. Os componentes personalizados permitem que você faça integração com backends, bem como execute tarefas que não são abrangidas pelos componentes incorporados.

Para saber como criar um componente personalizado, consulte Implementar Componentes Personalizados. Para saber como adicionar componentes personalizados para uso na sua habilidade, consulte Adicionar Pacote de Componente a uma Habilidade. Para saber mais sobre um componente personalizado que foi adicionado à habilidade, vá para a página Componentes da habilidade Ícone Componentes, expanda o serviço do componente e selecione o componente. O nome, as propriedades e as ações suportadas do componente são exibidos. Use essas informações para construir o estado do componente em seu fluxo de caixas de diálogo.

Dica:

Como é possível que componentes de serviços distintos tenham o mesmo nome, você pode prefixar o nome do componente com o nome do serviço seguido por dois-pontos (:) para garantir que você mencione de forma exclusiva cada componente personalizado que utilizar.

Este é um exemplo do estado de um componente personalizado em um fluxo de caixas de diálogo desenvolvido no modo YAML. O componente hello.world pertence ao serviço custom. 

  start:
    component: "custom:helloWorld"
    properties:
      human: "${human.value}"
    transitions:
      next: "askAge"

Quando você usa o serviço de componente incorporado para hospedar seus componentes personalizados, é possível acessar logs de exibição e relatórios de falhas dos componentes na página Componentes Ícone Componentes. Selecione o serviço e depois clique em Diagnóstico.

Outras Propriedades Disponíveis para Componentes Personalizados no Modo YAML

Ao desenvolver fluxos de caixas de diálogo no modo YAML, você pode incluir essas propriedades no estado do componente personalizado, além das propriedades definidas do componente.

Nome Descrição 0brigatório?
autoNumberPostbackActions Quando definida como true, essa opção prefixa números aos botões e às opções de lista. Mesmo quando você não tiver definido essa opção como true, a numeração automática poderá ser aplicada em itens de cartão quando a configuração Ativar Numeração Automática em Ações de Postback do assistente digital for definida como true. O padrão é false. No
insightsEndConversation Defina como true para interromper a gravação da conversa para geração de relatórios de informações. O padrão é false. No
insightsInclude Especifica se o estado deve ser incluído no relatório de informações. O padrão é true. No
translate Use essa propriedade para substituir o valor booliano que você definiu para a variável de contexto autotranslate. Se você não tiver definido a variável autotranslate ou se defini-la como false; você poderá definir essa propriedade como true para ativar a tradução automática para esse componente apenas. Se você definir a variável autotranslation como true, poderá definir essa propriedade como false para excluir esse componente da tradução automática. Consulte Serviços de Tradução em Habilidades. O padrão é o valor da variável de contexto autotranslate. No

Essas propriedades não estão disponíveis para estados em fluxos de caixas de diálogo que você desenvolve com o Designer de Fluxo Visual.