Documentação do Oracle Cloud Infrastructure

Mapeamento de Fluxos

Os tópicos a seguir mostram os vários tipos de eventos dos quais você pode mapear para um fluxo.

Mapear uma Intenção para um Fluxo

Você pode mapear uma intenção para um fluxo ao criar o fluxo:

  1. Na página Eventos, clique em + Adicionar Fluxo.
  2. Na caixa de diálogo Criar Fluxo, preencha os campos obrigatórios, incluindo Nome da Intenção.

Se você já definiu um fluxo e agora precisa mapear uma intenção para ele, veja como mapear a intenção:

  1. Na página Fluxos, na lista de fluxos, selecione Fluxo Principal.
  2. Clique em Esta é uma imagem do ícone Adicionar. na seção Eventos de Intenção.
    Esta é uma imagem do cabeçalho da seção Eventos de Intenção.

  3. Na caixa de diálogo Criar Handler de Eventos de Intenção, selecione o nome da intenção e o fluxo mapeado e clique em Criar
    Veja a seguir a descrição da ilustração df-create-intent-event-handler-dialog.png
    Descrição da ilustração df-create-intent-event-handler-dialog.png

    .

Mapear um Evento Incorporado para um Fluxo

  1. Selecione Fluxo Principal.
  2. Clique em Esta é uma imagem do ícone Adicionar. na seção Eventos Incorporados.
    Esta é uma imagem do cabeçalho Eventos Incorporados.

  3. Na caixa de diálogo Criar Handler de Evento Incorporado, selecione o tipo de evento no fluxo mapeado e clique em Criar.
    Descrição da ilustração df-2-0-built-events-mapping-dialog.png a seguir
    Descrição da ilustração df-2-0-built-events-mapping-dialog.png

Mapear um Evento de Transição para um Fluxo

  1. Selecione o fluxo para o qual você deseja mapear o evento.
  2. Selecione a guia Configuração.
  3. Expanda a seção Mapeamentos de Evento.
  4. No campo da transição que você deseja mapear, selecione um estado.

Chamar um Fluxo de Outro Fluxo

Se quiser chamar um fluxo de outro fluxo, faça isso usando os componentes Chamar Fluxo e Encerrar Fluxo. Veja como funciona:

  • O fluxo pai chama o fluxo filho de um estado de fluxo de chamada. Ele usa esse estado para transmitir valores e receber valores do fluxo filho.
  • O estado do fluxo final do fluxo filho passa seus parâmetros de saída de volta para o fluxo pai e também pode acionar uma ação que o fluxo pai executa após o término do fluxo filho.

    Se o fluxo filho se ramificar e tiver vários estados de fluxo final, cada um poderá passar sua própria ação de volta para o fluxo pai, e o fluxo pai poderá usar essas ações para determinar qual ramificação seguir.

    (As transições de ação permitem que você ramifique o fluxo pai com base nos resultados do fluxo filho. Por exemplo, se você tiver um fluxo filho que deve procurar uma conta, ele poderá passar uma ação para o sucesso e uma ação para o fracasso.)

  • Depois que o fluxo filho tiver terminado, o fluxo pai será retomado.

Por exemplo, um fluxo Atualizar Conta em uma habilidade financeira seria o fluxo pai que só pode concluir a solicitação de atualização do usuário chamando um fluxo filho, Obter Conta. O resultado, ou parâmetro de saída que o fluxo pai espera após a execução do fluxo filho, é a conta do usuário. Nesse caso, a conta é o parâmetro de saída enviado ao estado de fluxo de chamada pelo estado de fluxo final do fluxo filho.

Para vincular fluxos:
  1. Crie os parâmetros de entrada e saída para o fluxo filho.
  2. No fluxo pai ou de chamada, clique no ícone Adicionar Estado no ponto em que você deseja chamar o fluxo filho e selecione o componente Controle de Fluxo > Chamar Fluxo. Em seguida, clique em Inserir.
  3. Abra o inspetor de propriedades para o estado do fluxo de chamada que você acabou de adicionar.
  4. Na página Geral, digite um nome e uma descrição.
  5. Na página Componente, selecione o fluxo filho na lista drop-down Fluxo.
  6. Se o fluxo pai precisar passar parâmetros para o fluxo filho, clique em Adicionar, selecione o parâmetro de entrada pertencente ao fluxo filho e informe um valor padrão. Em seguida, clique em Salvar. Repita esta etapa para cada parâmetro de entrada.
  7. Se o fluxo pai esperar um resultado do fluxo filho, clique em Adicionar para selecionar o parâmetro de saída pertencente ao fluxo filho e, em seguida, nomeie a variável do fluxo atual (pai) que é definida como o valor do parâmetro de saída.
  8. Abra a página Transições para definir o próximo estado e, se necessário, adicionar transições de ação, como cancelamento ou erro.
  9. Se você tiver configurado transições de ação no fluxo pai, configure estados de fluxo final no fluxo filho para acionar essas ações. Você faz isso na página Componente de cada inspetor de propriedade do fluxo final.
  10. Se você precisar informar um parâmetro de volta ao fluxo pai, clique em Adicionar e informe o nome que corresponde ao nome do parâmetro no estado do fluxo de chamada do fluxo pai. Em seguida, informe um valor de saída de parâmetro e clique em Salvar.

Chamar Outra Habilidade de um Fluxo

Se quiser chamar outra habilidade de um fluxo, faça isso usando os componentes Chamar Habilidade e Encerrar Fluxo. Veja como funciona:

  • A habilidade que você está chamando deve estar no mesmo assistente digital da habilidade da qual você está chamando.
  • A habilidade que você está chamando deve ter um fluxo designado como público.
  • O fluxo de chamada usa um estado Chamar Habilidade para especificar uma versão de uma habilidade e um fluxo de destino nessa habilidade. Ele usa esse estado para transmitir valores e receber valores da habilidade chamada.
  • O estado do fluxo final do fluxo de destino repassa seus parâmetros de saída para o fluxo de chamada e também pode acionar uma ação que o fluxo de chamada executa após o término do fluxo de destino.

    Se o fluxo de destino se ramificar e tiver vários estados de fluxo final, cada um poderá passar sua própria ação de volta para o fluxo de chamada, e o fluxo de chamada poderá usar essas ações para determinar qual ramificação seguir.

    (As transições de ação permitem que você ramifique o fluxo de chamada com base nos resultados do fluxo de destino. Por exemplo, se você tiver um fluxo de destino que deveria procurar uma conta, ele poderia passar uma ação para o sucesso e uma ação para o fracasso.)

  • Após o término do fluxo de destino, o fluxo de chamada da habilidade de chamada é retomado.

Por exemplo, um fluxo Atualizar Conta em uma habilidade financeira seria o fluxo de chamada que só pode concluir a solicitação de atualização do usuário chamando um fluxo de destino, Obter Conta. O resultado, ou parâmetro de saída que o fluxo de chamada espera após a execução do fluxo de destino, é a conta do usuário. Nesse caso, a conta é o parâmetro de saída enviado ao estado de habilidade de chamada pelo estado de fluxo final do fluxo de destino.

Para vincular fluxos:
  1. Crie os parâmetros de entrada e saída para o fluxo de destino.
  2. No fluxo de destino, selecione a guia Configuração, expanda a seção Geral e ative a chave Público.
    Esta é uma captura de tela de parte da página Configuração que mostra o campo Exigir Autorização e a chave Pública.

  3. No fluxo de chamada, clique no ícone Adicionar Estado no ponto em que você deseja chamar o fluxo de destino e selecione o componente Controle de Fluxo > Chamar Habilidade. Em seguida, clique em Inserir.
  4. Abra o inspetor de propriedades para o estado de habilidade de chamada que você acabou de adicionar.
  5. Na página Geral, digite um nome e uma descrição.
  6. Na página Componente, selecione a habilidade na lista drop-down Habilidade.
  7. Selecione uma versão na lista drop-down Versão da Habilidade.
    Observação

    Esse valor só se aplicará se a habilidade referenciada for uma habilidade independente. Se a habilidade de destino estiver no mesmo assistente digital que a habilidade de chamada, no runtime, a versão dessa habilidade que está no assistente digital será usada e o valor desse campo será ignorado.
  8. Na lista drop-down Nome do Fluxo, selecione um dos fluxos públicos que pertencem à habilidade selecionada.
  9. Se o fluxo de chamada precisar passar parâmetros para o fluxo de destino, clique em Adicionar, selecione o parâmetro de entrada pertencente ao fluxo de destino e informe um valor padrão. Em seguida, clique em Salvar. Repita esta etapa para cada parâmetro de entrada.
  10. Se o fluxo de chamada esperar um resultado do fluxo de destino, clique em Adicionar para selecionar o parâmetro de saída pertencente ao fluxo de destino e nomeie a variável do fluxo de chamada que é definida com o valor do parâmetro de saída.
    Observação

    Se o fluxo de destino ainda não estiver disponível, você poderá especificar que o fluxo use dados simulados para os parâmetros de saída para que possa continuar desenvolvendo e testando o fluxo enquanto aguarda que o fluxo de destino se torne disponível. Para fazer isso, defina a propriedade Usar Simulação como True e informe os parâmetros e valores de saída no campo Parâmetros de Saída Simulados. Informe cada parâmetro em uma linha separada no form 
    ParamName: ParamValue
  11. Abra a página Transições para definir o próximo estado e, se necessário, adicionar transições de ação, como cancelamento ou erro.
  12. Se você tiver configurado transições de ação no fluxo de chamada, configure estados de fluxo final no fluxo de destino para acionar essas ações. Você faz isso na página Componente de cada inspetor de propriedade do fluxo final.
  13. Se você precisar informar um parâmetro de volta ao fluxo de chamadas, clique em Adicionar e informe o nome que corresponde ao nome do parâmetro no estado de habilidade de chamada do fluxo de chamadas. Em seguida, informe um valor de saída de parâmetro e clique em Salvar.