Se você já usou o Dialogflow CX, talvez queira reutilizar seus fluxos atuais enquanto cria novos agentes usando o CX Agent Studio.
É possível criar um agente baseado em fluxo que vai transferir a conversa para o fluxo até atingir END_SESSION. Nesse momento, a conversa é retornada ao agente do CX Agent Studio que iniciou o agente baseado em fluxo.
Os aplicativos de agente do CX Agent Studio enviam a entrada do usuário para fluxos usando o método da API DetectIntent.
Para entrada de texto por voz, os aplicativos de agente do CX Agent Studio processam TTS e STT para essas interações.
Usando o console, é possível definir como os dados são enviados entre o aplicativo do agente e os fluxos.
Configurar permissões
Para que o aplicativo do agente tenha permissões para chamar o fluxo do Dialogflow CX, é necessário fornecer ao agente de serviço do Pacote de engajamento do cliente o papel de cliente da API Dialogflow.
Criar um agente baseado em fluxo
Para criar um agente baseado em fluxo no criador de agentes:
- Clique no botão de adição na parte de baixo do agente que vai iniciar o agente baseado em fluxo.
- Clique em Importar agente baseado em fluxo. O painel de configuração é aberto.
- Selecione o projeto do fluxo.
- Selecione o agente do fluxo.
- Forneça um nome de exibição.
- Forneça uma descrição para o agente pai do CX Agent Studio que descreve quando transferir o controle para o fluxo.
- Forneça o recurso de início do fluxo.
- Forneça o ambiente que precisa ser usado para o fluxo. O padrão é "rascunho".
- Forneça o mapeamento de variáveis de entrada. As variáveis fornecidas aqui são enviadas para o fluxo como parâmetros de sessão.
- Mapeamento de variáveis de saída. Os parâmetros de sessão de fluxo fornecidos aqui são enviados ao aplicativo do agente como variáveis.
- Clique em Importar.
Práticas recomendadas de migração
Ao usar seus fluxos atuais, tenha em mente as seguintes práticas recomendadas.
Playbooks
Embora os agentes do CX Agent Studio ofereçam funcionalidades semelhantes aos playbooks, é importante entender que eles não são uma substituição direta. Os agentes do Dialogflow CX podem ter um acoplamento rígido entre playbooks e fluxos, o que dificulta a substituição direta.
Tipos de agentes isolados x integrados
Ao fazer a transição de agentes do Dialogflow CX com relações complexas entre fluxos e playbooks para agentes do CX Agent Studio, primeiro considere isolar os tipos de agentes.
É possível criar novos agentes do CX Agent Studio para todos os novos casos de uso e continuar mantendo os agentes do Dialogflow CX para casos de uso antigos. Para isso, use uma camada de roteamento para determinar qual tipo de agente precisa ser invocado.
Lembre-se de que os agentes de direção do CX Agent Studio não podem realizar a transferência entre agentes do Dialogflow CX até que END_SESSION seja atingido e o controle seja devolvido ao agente de direção do CX Agent Studio.
Se essa abordagem não for viável e você precisar usar seus fluxos atuais, use agentes baseados em fluxo do CX Agent Studio, conforme descrito neste guia. É importante usar agentes do CX Agent Studio como agentes de direção para gerenciar o roteamento entre agentes e fluxos do CX Agent Studio.
Lembre-se de que esse processo pode ser um esforço substancial único.
Fluxos para lógica de negócios altamente determinística
Os fluxos são ideais para gerenciar a lógica de negócios altamente determinística, principalmente quando essa lógica não pode ser processada por callbacks do CX Agent Studio.
Bons exemplos de uso de um fluxo:
- Realizar coletas e validações de dados sequenciais
- Realizar o fluxo de autenticação com base nos parâmetros da sessão
Exemplos ruins de uso de um fluxo:
- Responder ao usuário com uma resposta predefinida, já que isso pode ser facilmente feito usando um callback do agente do CX Agent Studio.
- Realizar a classificação e detecção de intents, já que você precisa usar LLMs para essas finalidades.
Fluxos como caixas pretas
Um problema com os fluxos é que eles dependem de parâmetros de sessão, que são parâmetros globais implícitos. Por padrão, todos os parâmetros coletados em um fluxo são propagados automaticamente para o escopo da sessão, tornando-se acessíveis a fluxos subsequentes. Essa metodologia introduz um problema em que as modificações na lógica de coleta de parâmetros em um fluxo upstream podem interromper inadvertidamente os fluxos downstream.
Esse comportamento precisa ser considerado com cuidado ao usar agentes baseados em fluxo do CX Agent Studio. Os agentes do CX Agent Studio precisam tratar os fluxos como caixas pretas encapsuladas, com todas as informações necessárias transmitidas por parâmetros de entrada explícitos. Após a inicialização de um fluxo, ele precisa usar esses parâmetros transmitidos como parâmetros de sessão para executar as ações designadas. Por outro lado, ao sair do fluxo, é importante que ele preencha os parâmetros de saída predefinidos dos parâmetros de sessão antes de ceder o controle ao agente do CX Agent Studio.
Exemplos
O diagrama a seguir ilustra uma configuração recomendada, em que o agente do CX Agent Studio funciona como a camada de roteamento, enquanto os fluxos executam a lógica independente antes de liberar o controle.
O diagrama a seguir ilustra uma configuração aceitável (observe a incorporação do playbook), desde que as interações de playbook <-> fluxo permaneçam encapsuladas como uma caixa preta do agente de roteamento do CX Agent Studio.
O diagrama a seguir ilustra uma configuração inaceitável devido às transições complexas e repetitivas entre CX Flow B e PS Agent A, que comprometem o encapsulamento da interface.
