Agentes

Mantenha tudo organizado com as coleções Salve e categorize o conteúdo com base nas suas preferências.

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

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. 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.
  5. Clique em Save.

API

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

Para criar um agente, consulte o método create para o tipo Agent.

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

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

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:

Para mais informações sobre como os dados são aplicados em diversos níveis, consulte os níveis de aplicação 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 Save.

API

Veja os métodos get e patch/update para o tipo Agent.

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

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

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, o idioma padrão não pode ser alterado. No entanto, você pode realizar as seguintes ações:

    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 ou diferente agente da etapa 1.
    6. Atualize as frases de treinamento e os valores de entidade específicos da linguagem, 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 Stackdriver 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.

  • BigQuery

    • Ativar o BigQuery Export

      Indica se o BigQuery Export está ativado.

    • Conjunto de dados do BigQuery

      O nome do conjunto de dados do BigQuery.

    • Tabela do BigQuery

      O nome da tabela do BigQuery.

  • Modelo de payload personalizado

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

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

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:

  • Permição para 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 para todos os idiomas compatíveis com o Dialogflow, mas atualmente está limitada a regiões específicas.

    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:

    • Padrão: tecnologia NLU padrão (padrão).
    • Avançado: tecnologia avançada de NLU. Esse tipo de NLU funciona melhor que o padrão, especialmente para agentes e fluxos grandes. O treinamento de modelo levará mais tempo do que o de NLU padrão.
  • Treinamento 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.

  • Limiar 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.

  • Status do treinamento

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

  • Treinar PLN

    Use esse botão para treinar manualmente o fluxo.

Configurações de fala e de URA

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

  • Ativar a adaptação de fala

    Consulte Adaptação automática de fala.

  • Configurações avançadas de fala

    Esta seção fornece configurações adicionais e avançadas para recursos de fala. É possível ativar e desativar essas configurações avançadas. Estas configurações estão disponíveis nas configurações do agente (aplica-se a todo o agente): configurações de fluxo (aplica-se a todo o fluxo e modifica as configurações do agente) configurações da página (aplica-se à página e modifica as configurações de fluxo e agente) e configurações de atendimento do pedido (aplica-se ao fulfillment e modifica as 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.

    • Sensibilidade ao 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 terminar a fala) a 100 (alta sensibilidade, mais provável de terminar a fala)

    • 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 deixará de reproduzir áudio para todas as mensagens na fila com a ativação ativada.

    • URI do Google Cloud Storage

      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 e StreamingAnalyzeContent.
      Áudio de conversão de texto em voz (TTS) 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 service-PROJECT_NUMBER@gcp-sa-dialogflow.iam.gserviceaccount.com, 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.

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.

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

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

Uma exportação do agente inclui todos os dados dele, exceto o seguinte:

  • 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.

Uma restauração de agente substitui todos os dados do agente de destino, incluindo todas as versões de fluxo, exceto o seguinte:

  • 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 de fluxo desatualizadas não são listadas ou as versões de fluxo selecionáveis do agente.

Ao exportar, é possível selecionar o formato do arquivo de exportação. Se você estiver usando o controle de versões de origem para os dados do agente, exporte 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.

API

Veja os métodos export e restore para o tipo Agent.

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

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

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.

Excluir um agente

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.

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

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

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