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
- Abra o Console do Dialogflow CX.
- Crie ou escolha um projeto do Google Cloud.
- Clique em Criar agente.
- Selecione Gerar automaticamente para criar um agente do repositório de dados ou selecione Criar seus próprios agentes para criar outros tipos de agentes.
- Preencha o formulário para as configurações básicas do agente.
- Você pode escolher qualquer nome de exibição.
- Selecione um local. Clique no botão Editar se quiser alterar as configurações avançadas de local.
- Selecione o fuso horário.
- Selecione o idioma padrão do agente. Não é possível alterar o idioma padrão de um agente depois que ele é criado.
- Clique em Save.
API
Se você ainda não configurou configurações de localização para o seu projeto, você precisa definir essas configurações com o console antes de criar agentes com a API. Atualmente, não é possível definir configurações de local 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 de agente | Recurso de 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
- Abra o Console do Dialogflow CX.
- Escolha o projeto do Google Cloud para o agente.
- Encontre o agente na lista.
- Clique no nome de exibição do agente.
- 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 níveis variados, consulte o níveis de aplicação de dados.
Configurações do agente
Para acessar as configurações do agente:
Console
- Abra o Console do Dialogflow CX.
- Escolha seu projeto do Google Cloud.
- Selecione seu agente.
- Clique em Configurações do agente.
- Atualize as configurações conforme desejado.
- 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 de agente | Recurso de 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:
-
Um nome legível para seu agente.
-
O fuso horário padrão do seu agente.
-
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, você pode fazer o seguinte:
- Exporte seu agente para o Formato JSON.
- Descompacte o arquivo salvo.
- Localize o arquivo
agent.json
. - Atualize
defaultLanguageCode
esupportedLanguageCodes
aos valores desejados. - Restaurar o agente para o mesmo agente ou um para um diferente da etapa 1.
- Atualize frases de treinamento e valores de entidade específicos da linguagem conforme necessário.
-
Bloquear o agente
Indica se o agente está bloqueado. Não é possível editar um agente bloqueado.
-
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.
-
Ativar o BigQuery Export
Indica se Exportação do BigQuery está ativado.
Conjunto de dados do BigQuery
O nome do conjunto de dados do BigQuery.
Tabela do BigQuery
O nome da tabela do BigQuery.
-
É possível ativar sugestões de intenção.
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.
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:
-
Pode ser:
- PLN avançado (padrão): tecnologia PLN avançada. Esse tipo de PLN funciona melhor do que o padrão, especialmente para fluxos e agentes grandes.
- PLN padrão: é tecnologia PLN padrão. Will (Ação) não recebem mais melhorias de qualidade ou novos recursos.
-
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.
-
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.
-
Indica se o fluxo foi treinado desde a atualização mais recente dos dados do fluxo.
-
Use esse botão para treinar manualmente o fluxo.
Configurações da IA generativa
As seguintes configurações de IA generativa estão disponíveis:
Geral
Agente generativo
-
Selecione o modelo usado pelos recursos generativos. Para mais informações, consulte versões de modelo.
-
Substituto generativo
Datastore
Configurações de fala e de URA
As seguintes configurações de fala e URA estão disponíveis:
-
-
Você pode selecionar o idioma e a voz usados para a síntese de fala.
Você pode ativar a Voz personalizada para seu agente selecionando a opção de voz personalizada caixa de seleção e especifique o nome da voz personalizada no . O nome da voz personalizada precisa seguir o seguinte 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
service-PROJECT_NUMBER@gcp-sa-dialogflow.iam.gserviceaccount.com
é concedido com "AutoML Predictor" no seu projeto de voz personalizado. - Para chamadas de API comuns, verifique se a conta de serviço usada para chamar o Dialogflow recebeu o "AutoML Predictor". em um projeto de voz personalizado.
- Se você estiver usando o gateway de telefonia, verifique se a conta de serviço do Agente de serviço do Dialogflow
-
-
Ativar a adaptação automática 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.
Essas configurações estão disponíveis nas configurações do agente (aplicáveis a todo o agente), configurações de fluxo (se aplica a todo o fluxo e substitui as configurações do agente), configurações da página (se aplica à página e substitui as configurações de fluxo e agente), e configurações de fulfillment (se aplica ao fulfillment e substitui as páginas, o fluxo e as configurações do 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 de fulfillment quando a opção Personalizar está selecionada nestas níveis Se a opção Personalizar abranger várias configurações, e você quiser atualizar apenas alguns, talvez seja necessário atualizar outras configurações se você 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 para cada idioma, para que você possa selecionar modelos diferentes para idiomas diferentes. Você também pode conferir Substituir o 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 tempo de execução especifique um modelo diferente.
Para o gateway de telefone do Dialogflow CX, consulte limitações.
Para mais informações, consulte Modelos de 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, maior probabilidade de encerrar a fala).
Ativar a sensibilidade de fim de fala avançada baseada em tempo limite
Se essa configuração estiver ativada, o valor de configuração Sensibilidade de fim de fala é usado como um medidor para estabelecer um tempo limite relativo de silêncio do áudio para determinar o fim da fala.
Se essa configuração estiver desativada (o padrão), o valor de configuração Sensibilidade de fim de fala é usada para determinar o fim da fala pelo modelo de ML fornecido pela Google Cloud Speech-to-Text.
Embora a configuração Sensibilidade de fim de fala seja compatível apenas com a tag de idioma
en-US
por padrão, a configuração Ativar a sensitividade avançada de fim de fala baseada em tempo limite. permite configurar a sensibilidade de fim de fala para todos os idiomas e modelos de fala compatíveis com o Dialogflow.-
Se essa configuração estiver ativada, o Dialogflow vai analisar dados parciais de usuários entrada para determinar o fim da fala. Por exemplo, se o usuário diz "Eu gostaria" e pausa, o Dialogflow aguardará o usuário para continuar 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, você precisa Configure o endpoint inteligente. no formato do parâmetro.
Esse recurso só está disponível para a tag do idioma
en-US
.Essa configuração fica desativada por padrão.
-
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 é de 60 segundos. Para esse tempo limite, o Dialogflow invoca um evento sem entrada (em inglês).
-
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 de todas as mensagens na fila com a barcalho ativada.
Permitir o cancelamento da reprodução de resposta parcial
Quando resposta parcial está ativada, esta configuração permite o cancelamento de uma reprodução de resposta parcial. Se uma mensagem no fila de mensagens for criado por um fulfillment que permite o cancelamento, a reprodução da mensagem é cancelada se outra mensagem é adicionado à fila. Isso é útil quando você quer que uma mensagem inicial para iniciar a reprodução, mas para que a reprodução seja cancelada se um webhook em funcionamento produz outra mensagem antes de reproduzir a mensagem inicial.
-
Se fornecido, todos os dados de áudio associados a uma solicitação será salvo 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 e 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.
DTMF: consulte DTMF para integrações de telefonia.
Multimodal
Consulte Complementar 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
Ao configurar detecção automática de idioma, seu agente de chat detectará automaticamente o idioma do usuário final e mudará para nesse idioma. 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
É possível exportar um agente para um arquivo e restaurar um agente com esse arquivo.
A exportação do agente inclui todos os dados dele, exceto:
- Versões do Flow: 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 do agente substitui todos os dados do agente de destino (incluindo todas as versões de fluxo), exceto:
- Ambientes: Todos os ambientes personalizados permanecem inalterados no agente de destino. Versões de fluxo referenciadas por ambientes personalizados no agente de destino vão continuar existindo enquanto os ambientes associados existirem. No entanto, essas versões de fluxo desatualizadas não são listadas nem selecionáveis. de fluxo para o agente.
- Apps de agentes da Vertex AI:
A associação a um aplicativo de agentes da Vertex AI não é alterada
no agente de destino. Em outras palavras, o valor de
engine
em GenAppBuilderSettings) Isso significa que os agentes do repositório de dados só podem ser restaurados a outros agentes de repositório de dados, porque o agente resultante também precisa ter uma associação a um aplicativo de agentes da Vertex AI. Repositórios de dados de agentes 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 para restaurar um agente com referências a repositório de dados. Resultados da tentativa de fazer isso em uma mensagem de erro. Para corrigir isso, você pode criar um novo agente de repositório de dados do zero. (Como alternativa, você pode transformar seu agente atual em um agente de repositório de dados adicionando um repositório de dados gerenciador de estado a ele. Nesse caso, você será orientado a adicionar um aplicativo associado ao com seu agente.
- Se o agente de destino estiver associado a um app, todo o repositório de dados serão atualizadas após a restauração: o ID do projeto do Google Cloud e O local será atualizado para corresponder ao app do agente de destino. O o ID de coleta e o ID de repositório de dados permanecerão inalterados. Isso significa que você necessário adicionar repositórios de dados para todos os IDs com tipos correspondentes ao aplicativo do agente de destino antes da operação de restauração.
Exemplo: se o agente de origem se referir a um repositório de dados chamado
projects/123/locations/eu-west2/collections/default_collection/dataStores/myDataStore1
e o app do agente de destino tem o nomeprojects/321/locations/us-east1/collections/default_collections/engines/app123
, A referência do repositório de dados resultante no agente de destino será:projects/321/locations/us-east1/collections/default_collection/dataStores/myDataStore1
Ao exportar, você pode selecionar o formato do arquivo de exportação. Se você estiver usando o controle de versões do controle de origem para os dados do agente, faça o seguinte: você deveria exportar no formato JSON. Quando você restaura um agente, O Dialogflow determina automaticamente o formato do arquivo.
Para exportar ou restaurar um agente:
Console
- Abra o Console do Dialogflow CX.
- Escolha o projeto do Google Cloud para o agente.
- Clique no menu de opções more_vert de um agente na lista.
- Clique no botão Exportar ou Restaurar.
- 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 de agente | Recurso de 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 a Guia de exportação/restauração do GitHub (em inglês).
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
- Abra o Console do Dialogflow CX.
- Escolha o projeto do Google Cloud para o agente.
- Clique no menu de opções more_vert de um agente na lista.
- Clique no botão delete Excluir.
- 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 de agente | Recurso de 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 e dados do Dialogflow CX associados ao projeto são excluídos imediatamente.