Agentes

Um agente do Dialogflow CX é um agente virtual que processa as conversas simultâneas com seus usuários finais. Ele é um módulo de processamento de linguagem natural que entende as nuances da fala humana. O Dialogflow converte textos ou áudios de uma conversa com o usuário final em dados estruturados que seus aplicativos e serviços podem entender. Você projeta e cria um agente do Dialogflow para atender aos tipos de conversa solicitadas pelo seu sistema.

Um agente Dialogflow é semelhante a um agente humano de call center. O agente pode ser treinado para lidar com os cenários comuns de conversas, e o treinamento não precisa ser muito detalhado.

Criar um agente

Observação :é possível criar vários agentes CX para um projeto do Google Cloud.

Para criar um agente, siga estas etapas:

Console

1. Abra o Console do Dialogflow CX.
2. Crie ou escolha um projeto do Google Cloud.
3. Clique em Criar agente.
4. Selecione Gerar automaticamente para criar um agente de repositório de dados ou Criar seu próprio para criar outros tipos de agentes.
5. Preencha o formulário para as configurações básicas do agente.
   1. Você pode escolher qualquer nome de exibição.
   2. Selecione um local. Clique no botão Editar se quiser alterar as configurações avançadas de local.
   3. Selecione o fuso horário.
   4. Selecione o idioma padrão do agente. Não é possível alterar o idioma padrão de um agente depois que ele é criado.
6. Clique em Salvar.

API

Se você ainda não definiu as configurações de localização do seu projeto, faça isso com o console antes de criar agentes com a API. No momento, não é possível definir as configurações de localização com a API.

Para criar um agente, consulte o método create para o tipo Agent. Acessar a referência da API Agent

Selecione um protocolo e uma versão para a referência do agente:

Protocolo	V3	V3beta1
REST	Recurso de agente	Recurso de agente
RPC (remote procedure call)	Interface do agente	Interface do agente
C++	AgentsClient	Indisponível
C#	AgentsClient	Indisponível
Go	AgentsClient	Indisponível
Java	AgentsClient	AgentsClient
Node.js	AgentsClient	AgentsClient
PHP	Indisponível	Indisponível
Python	AgentsClient	AgentsClient
Ruby	Indisponível	Indisponível

Fechar

Dados do agente

Os agentes do Dialogflow servem como contêineres de nível superior para configurações e dados para agentes virtuais.

Para acessar os dados de um agente:

Console

1. Abra o Console do Dialogflow CX.
2. Escolha o projeto do Google Cloud para o agente.
3. Encontre o agente na lista.
4. Clique no nome de exibição do agente.
5. Atualize fluxos, páginas etc. conforme descrito em outros guias.

API

Consulte os guias dos dados que você quer atualizar.

Os seguintes dados estão associados a agentes:

• Intents
• Tipos de entidade
• Webhooks
• Fluxos
• Pages
• Grupos de rotas

Para mais informações sobre como os dados são aplicados em níveis variados, consulte os níveis de aplicativo de dados.

Configurações do agente

Para acessar as configurações do agente:

Console

1. Abra o Console do Dialogflow CX.
2. Escolha seu projeto do Google Cloud.
3. Selecione seu agente.
4. Clique em Configurações do agente.
5. Atualize as configurações conforme desejado.
6. Clique em Salvar.

API

Veja os métodos get e patch/update para o tipo Agent. Acessar a referência da API Agent

Selecione um protocolo e uma versão para a referência do agente:

Protocolo	V3	V3beta1
REST	Recurso de agente	Recurso de agente
RPC (remote procedure call)	Interface do agente	Interface do agente
C++	AgentsClient	Indisponível
C#	AgentsClient	Indisponível
Go	AgentsClient	Indisponível
Java	AgentsClient	AgentsClient
Node.js	AgentsClient	AgentsClient
PHP	Indisponível	Indisponível
Python	AgentsClient	AgentsClient
Ruby	Indisponível	Indisponível

Fechar

As subseções a seguir descrevem as diferentes categorias de configurações do agente.

Configurações gerais

As seguintes configurações gerais estão disponíveis para agentes:

• Nome de exibição

  Um nome legível para seu agente.

• Fuso horário

  O fuso horário padrão do seu agente.

• Idioma padrão

  O idioma padrão compatível com seu agente. Depois que um agente é criado, não é possível alterar o idioma padrão. No entanto, é possível fazer o seguinte:

  1. Exporte o agente para o formato JSON.
  2. Descompacte o arquivo salvo.
  3. Localize o arquivo agent.json.
  4. Atualize os campos defaultLanguageCode e supportedLanguageCodes para os valores desejados.
  5. Restaure o agente para o mesmo agente ou para um diferente da etapa 1.
  6. Atualize as frases de treinamento específicas da linguagem e os valores de entidade conforme necessário.

• Bloqueio de agente

  • Bloquear o agente

    Indica se o agente está bloqueado. Não é possível editar um agente bloqueado.

• Configurações de registro

  • Ativar o Cloud Logging

    Indica se o Cloud Logging está ativado para o agente.

  • Ativar a geração de registros de interação

    Indica se você quer que o Google colete e armazene consultas do usuário final editadas para melhorar a qualidade.

    Observação :alguns recursos, como Experimentos, Histórico de conversas, BigQuery Export, Analytics e melhoria do modelo de PLN, exigem que essa configuração esteja ativada, porque eles dependem de registros de tráfego.

• Exportação do BigQuery

  • Ativar o BigQuery Export

    Indica se a exportação do BigQuery está ativada.

  • Conjunto de dados do BigQuery

    O nome do conjunto de dados do BigQuery.

  • Tabela do BigQuery

    O nome da tabela do BigQuery.

• Sugestões de intent

  É possível ativar as sugestões de intent.

• Modelo de payload personalizado

  Nesta seção, é possível criar descrições e payloads para modelos de payload personalizados.

Configurações de ML

O Dialogflow usa algoritmos de machine learning (ML) para entender as entradas do usuário final, fazer a correspondência com intents e extrair dados estruturados. O Dialogflow aprende com frases de treinamento fornecidas por você e com os modelos de linguagem incorporados ao Dialogflow. Com base nesses dados, ele cria um modelo para tomar decisões sobre qual intent deve ser combinada com uma entrada do usuário final. É possível aplicar configurações de ML exclusivas a cada fluxo de um agente, e o modelo criado pelo Dialogflow é exclusivo para cada fluxo.

As seguintes configurações de ML em todo o agente estão disponíveis:

• Permitir que o ML corrija a ortografia

  Se esse recurso estiver ativado, e a entrada do usuário final tiver um erro ortográfico ou gramatical, um intent será escolhido como se a entrada estivesse correta. A resposta do intent de detecção conterá a entrada de usuário final corrigida. Por exemplo, se um usuário final digitar "Quero uma caçã", a frase será processada como se o usuário final tivesse digitado "Quero uma maçã". Isso também se aplica a correspondências envolvendo entidades do sistema e personalizadas.

  A correção ortográfica está disponível em inglês, francês, alemão, espanhol e italiano. Ele está disponível em todas as regiões do Dialogflow CX.

  Observação: se a entrada original e corrigida do usuário final corresponderem a intents diferentes, será selecionada a intent correspondente à entrada original do usuário final.

  Avisos e práticas recomendadas:

  • A correção ortográfica não corrige erros de reconhecimento de fala automático (ASR, na sigla em inglês). Portanto, não recomendamos ativá-la para agentes que usam entradas de ASR.
  • É possível que a entrada corrigida corresponda à intent errada. Isso pode ser corrigido com a inclusão de frases normalmente divergentes em .
  • A correção ortográfica aumenta um pouco o tempo de resposta do agente.
  • Se um agente for definido usando jargão específico do domínio, as correções poderão ser indesejadas.

As seguintes configurações de ML específicas para fluxo estão disponíveis:

• Tipo de PLN

  Pode ser:

  • PLN avançado (padrão): tecnologia PLN avançada. Esse tipo de PLN funciona melhor que o padrão, especialmente para agentes e fluxos grandes.
  • PLN padrão: tecnologia PLN padrão. não receberá mais melhorias de qualidade ou novos recursos;

• Trem automático

  Se ativado, o fluxo é treinado sempre que é atualizado com o console. Isso pode causar atrasos na IU do console no caso de fluxos grandes. Portanto, desative essa configuração e treine os fluxos manualmente conforme necessário.

• Limite de classificação

  Para filtrar resultados falsos positivos e ainda conseguir variedade nas entradas de idioma natural correspondentes para seu agente, ajuste o limiar de classificação de machine learning. Essa configuração controla a confiança de detecção de intent mínima necessária para uma correspondência de intent.

  Se a pontuação de confiança de uma correspondência de intent for menor que o valor do limite, um evento sem correspondência será invocado.

  Observação :antes de ajustar esse valor, tente adicionar exemplos negativos.

• Status do treinamento

  Indica se o fluxo foi treinado desde a atualização mais recente dos dados do fluxo.

• PLN do treinamento

  Use esse botão para treinar manualmente o fluxo.

Configurações de fala e de URA

As seguintes configurações de fala e URA estão disponíveis:

• Text-to-Speech

  • Seleção de voz

    Você pode selecionar o idioma e a voz usados para a síntese de fala.

    Se quiser ativar a Voz personalizada para seu agente, selecione essa opção na caixa de depósito de seleção de voz e especifique o nome dela no campo correspondente. O nome da voz personalizada precisa seguir este padrão: projects/PROJECT_ID/locations/LOCATION/models/MODEL_NAME.

    • Se você estiver usando o gateway de telefonia, verifique se a conta de serviço do Agente de serviço do Dialogflow [e-mail] foi concedida com o "AutoML Predictor" no seu projeto de voz personalizado.
    • Para chamadas de API normais, verifique se a conta de serviço usada para chamar o Dialogflow recebeu o papel "AutoML Predictor" no seu projeto de voz personalizado.

• Speech-to-Text

  • Ativar a adaptação automática de fala

    Consulte Adaptação automática de fala.

  • Configurações avançadas de fala

    Observação :as configurações de fala avançadas são compatíveis apenas com integrações de telefonia.

    Esta seção fornece configurações adicionais e avançadas para recursos de fala. É possível ativar e desativar essas configurações avançadas.

    Essas configurações estão disponíveis em configurações do agente (aplicáveis a todo o agente), configurações de fluxo (aplicam-se a todo o fluxo e substituem as configurações do agente), configurações de página (aplicam-se a páginas e modifica configurações de fluxo e agente) e configurações de fulfillment (aplicáveis a fulfillment e substitui configurações de página, fluxo e agente). Um subconjunto dessas configurações está disponível em cada nível, dependendo da relevância da configuração para o nível.

    As configurações atualizadas no nível do agente não são propagadas para o fluxo, a página e o nível de fulfillment quando a opção Personalizar é selecionada nesses níveis inferiores. Se a opção Personalizar incluir várias configurações e você quiser atualizar apenas algumas, talvez seja necessário atualizar outras configurações se quiser que elas sejam iguais às configurações no nível do agente.

    • Seleção de modelo (Speech-to-Text)

      Define o modelo de fala usado para reconhecimento de fala. Essa configuração é específica do idioma, para que seja possível selecionar modelos diferentes para idiomas diferentes. Você também pode marcar Substituir modelo de fala no nível da solicitação, o que fará com que o modelo selecionado seja usado mesmo que uma chamada de API de ambiente de execução especifique um modelo diferente.

      Para o Dialogflow CX Phone Gateway, consulte Limitações.

      Para mais informações, consulte Modelos de fala.

    • Sensibilidade do fim da fala

      Controla a sensibilidade do reconhecimento do final da fala na entrada de áudio do usuário final. O valor varia de 0 (baixa sensibilidade, menor probabilidade de encerrar a fala) a 100 (alta sensibilidade, mais probabilidade de encerrar a fala).

      Observação: essa configuração é compatível apenas com a tag de idioma en-US, a menos que você marque a configuração Ativar a sensibilidade avançada do fim da fala com base no tempo limite.

    • Ativar a sensibilidade avançada ao fim da fala baseada em tempo limite

      Se essa configuração estiver ativada, o valor da configuração Sensibilidade ao fim da fala será usado como um medidor para estabelecer um tempo limite do silêncio de áudio relativo para determinar o fim da fala.

      Se essa configuração estiver desativada (o padrão), o valor de configuração Sensibilidade ao fim da fala será usado para determinar o fim da fala pelo modelo de ML fornecido pelo Google Cloud Speech-to-Text.

      Embora a configuração Sensibilidade ao fim da fala seja compatível apenas com a tag en-US de idioma por padrão, a configuração Ativar sensibilidade avançada ao fim da fala baseada em tempo limite permite configurar essa sensibilidade para todos os idiomas e modelos de fala compatíveis com o Dialogflow.

    • Ativar o endpoint inteligente

      Se essa configuração estiver ativada, o Dialogflow analisará a entrada parcial do usuário para determinar o fim da fala. Por exemplo, se o usuário disser "Eu gostaria" e fizer uma pausa, o Dialogflow esperará que o usuário continue a frase.

      Isso é particularmente útil para a coleta de parâmetros numéricos, em que o usuário pode dizer "1234" e fazer uma pausa antes de dizer "5678". Para aplicar essa configuração a um parâmetro específico, é preciso definir o endpoint inteligente no formulário do parâmetro.

      Esse recurso está disponível apenas para a tag de idioma en-US.

      Esta configuração fica desativada por padrão.

    • Sem tempo limite de fala

      O tempo em segundos que o Dialogflow deixará de aguardar pela entrada de áudio do usuário final. O padrão é 5 segundos, e o valor máximo é 60 segundos. Para esse tempo limite, o Dialogflow invoca um evento sem entrada (em inglês).

    • Interrupção

      Quando ativado, um usuário final pode interromper o áudio da resposta do Dialogflow. Quando interrompido, o Dialogflow interromperá o envio de áudio e processará a próxima entrada do usuário final.

      Se houver várias mensagens na fila de mensagens e uma mensagem foi enfileirada por um fulfillment associado a uma página, um fluxo ou um agente com carregamento ativado, todas as mensagens seguintes na fila também terão a ativação ativada. Nesse caso, a integração vai interromper a reprodução de áudio para todas as mensagens na fila com a interrupção ativada.

    • Permitir o cancelamento da reprodução da resposta parcial

      Quando a resposta parcial está ativada, essa configuração permite o cancelamento de uma reprodução de resposta parcial. Se uma mensagem na fila de mensagens for criada por um fulfillment que permita o cancelamento, a reprodução será cancelada se outra mensagem for adicionada à fila. Isso é útil quando você quer que uma mensagem inicial inicie a reprodução, mas para que essa reprodução seja cancelada se um webhook em funcionamento produzir outra mensagem antes que a reprodução da mensagem inicial seja concluída.

    • Bucket de exportação de áudio

      Se fornecido, todos os dados de áudio associados a uma solicitação serão salvos no bucket do Cloud Storage:

      Áudio salvo	Solicitações aplicáveis
      Entrada de áudio do usuário final	DetectIntent, StreamingDetectIntent, AnalyzeContent, StreamingAnalyzeContent
      Áudio de conversão de texto em voz (TTS) sintetizado para uma resposta	AnalyzeContent, StreamingAnalyzeContent

      Conceda o papel Criador de objetos do Storage às seguintes contas de serviço no seu projeto:

      • Para a conta de serviço no formato one-click@df-cx-ALPHANUMERIC_VALUE-ALPHANUMERIC_VALUE.iam.gserviceaccount.com, se você usar uma integração de telefonia integrada por parceiro.

      • Para a conta de serviço no formato [e-mail], se você usar a integração do Dialogflow CX Phone Gateway. Para encontrar essa conta de serviço no IAM, marque a opção Incluir concessões de papel fornecidas pelo Google.

    • DTMF: consulte DTMF para integrações de telefonia.

Multimodal

Consulte Complementar da chamada.

Configurações de compartilhamento

Consulte Controle de acesso.

Configurações de idiomas

Adicione suporte extra ao idioma para o agente. Para ter acesso à lista completa de idiomas, consulte a referência de idioma.

Detecção automática de idioma

Quando você configura a detecção automática de idioma, seu agente de bate-papo detecta automaticamente o idioma do usuário final e alterna para ele. Consulte a documentação sobre detecção automática de idiomas para mais detalhes.

Configurações de segurança

Consulte Configurações de segurança.

Configurações avançadas

Atualmente, a única configuração avançada é para a análise de sentimento.

Exportar e restaurar um agente

Observação: os tipos de agente do Dialogflow ES e do Dialogflow CX são incompatíveis. Não é possível restaurar um agente incompatível.

É possível exportar um agente para um arquivo e restaurar um agente com esse arquivo.

Uma exportação de agente inclui todos os dados do agente, exceto estes:

• Versões de fluxo: somente os fluxos de rascunho são exportados para o arquivo.
• Ambientes: os ambientes personalizados não são exportados para o arquivo.

A restauração de um agente substitui todos os dados do agente de destino (incluindo todas as versões do fluxo), exceto:

• Ambientes: todos os ambientes personalizados permanecem inalterados no agente de destino. As versões de fluxo referenciadas por ambientes personalizados no agente de destino continuarão existindo enquanto os ambientes associados existirem. No entanto, essas versões desatualizadas do fluxo não são listadas nem selecionáveis para o agente.
• Apps de conversação da Vertex AI: a associação a um app de conversação da Vertex AI permanece inalterada no agente de destino. (Em outras palavras, o valor de engine em GenAppBuilderSettings). Isso significa que os agentes de repositório de dados só podem ser restaurados em outros agentes de repositório de dados atuais, porque o agente resultante também precisa estar associado a um app de conversação da Vertex AI.

• Repositórios de dados de conversação da Vertex AI: todas as referências a repositórios de dados serão substituídas no agente de destino de acordo com as seguintes regras:

  • Se o agente de destino não estiver associado a um app, não será possível restaurar um agente com referências de repositório de dados. Essa tentativa resulta em uma mensagem de erro. Para corrigir isso, crie um novo agente de repositório de dados do zero. Também é possível transformar o agente atual em um agente de repositório de dados adicionando um gerenciador de estado do repositório de dados a ele. Nesse caso, você será orientado a adicionar um app associado ao seu agente.
  • Se o agente de destino estiver associado a um aplicativo, todas as referências de repositório de dados serão atualizadas após a restauração: o ID do projeto e o local do Google Cloud serão atualizados para corresponder ao aplicativo do agente de destino. Os ID da coleção e do repositório de dados permanecerão inalterados. Isso significa que você precisa adicionar repositórios de dados para todos os IDs com tipos correspondentes no app do agente de destino antes da operação de restauração.

  Exemplo: se o agente de origem se referir a um armazenamento de dados chamado projects/123/locations/eu-west2/collections/default_collection/dataStores/myDataStore1 e o app do agente de destino tiver o nome projects/321/locations/us-east1/collections/default_collections/engines/app123, a referência de repositório de dados resultante no agente de destino será: projects/321/locations/us-east1/collections/default_collection/dataStores/myDataStore1

Observação :na API e no conteúdo dos dados exportados, o app Vertex AI para Conversação é chamado de GenAppBuilder Engine. Por exemplo, em um pacote JSON exportado, o nome do mecanismo pode ser encontrado no arquivo agent.json na chave genAppBuilderSettings.engine.

Ao exportar, é possível selecionar o formato do arquivo. Se você estiver usando o controle de versões do controle de origem para os dados do agente, será necessário exportar no formato JSON. Quando você restaura um agente, o Dialogflow determina automaticamente o formato do arquivo.

Para exportar ou restaurar um agente:

Console

1. Abra o Console do Dialogflow CX.
2. Escolha o projeto do Google Cloud para o agente.
3. Clique no menu de opções de um agente na lista.
4. Clique no botão Exportar ou Restaurar.
5. Siga as instruções para concluir.

Observação: para restaurar um agente de repositório de dados, verifique se o agente de destino foi criado como agente de repositório de dados.

API

Veja os métodos export e restore para o tipo Agent. Acessar a referência da API Agent

Selecione um protocolo e uma versão para a referência do agente:

Protocolo	V3	V3beta1
REST	Recurso de agente	Recurso de agente
RPC (remote procedure call)	Interface do agente	Interface do agente
C++	AgentsClient	Indisponível
C#	AgentsClient	Indisponível
Go	AgentsClient	Indisponível
Java	AgentsClient	AgentsClient
Node.js	AgentsClient	AgentsClient
PHP	Indisponível	Indisponível
Python	AgentsClient	AgentsClient
Ruby	Indisponível	Indisponível

Fechar

Se o tamanho do agente exceder o limite máximo, use a opção do Cloud Storage para exportar e restaurar o agente.

Se você usa o GitHub, consulte também o guia de exportação/restauração do GitHub (em inglês).

Excluir um agente

Atenção: não é possível desfazer a ação de excluir um agente. Exporte-o para manter um backup, caso seja necessário.

Para excluir um agente, é preciso ter um papel que forneça acesso total ou acesso para editar. Para mais informações, consulte o guia de controle de acesso.

Para excluir um agente:

Console

1. Abra o Console do Dialogflow CX.
2. Escolha o projeto do Google Cloud para o agente.
3. Clique no menu de opções de um agente na lista.
4. Clique no botão Excluir.
5. Confirme a exclusão na caixa de diálogo.

API

Veja o método delete para o tipo Agent. Acessar a referência da API Agent

Selecione um protocolo e uma versão para a referência do agente:

Protocolo	V3	V3beta1
REST	Recurso de agente	Recurso de agente
RPC (remote procedure call)	Interface do agente	Interface do agente
C++	AgentsClient	Indisponível
C#	AgentsClient	Indisponível
Go	AgentsClient	Indisponível
Java	AgentsClient	AgentsClient
Node.js	AgentsClient	AgentsClient
PHP	Indisponível	Indisponível
Python	AgentsClient	AgentsClient
Ruby	Indisponível	Indisponível

Fechar

Se você excluir o projeto, todos os agentes e dados do Dialogflow CX associados a ele serão excluídos imediatamente.