Agentes

Um Agente de agentes de conversa (Dialogflow CX) é um agente virtual que lida com conversas simultâneas com os usuários finais. Ele é um módulo de processamento de linguagem natural que entende as nuances da fala humana. Os agentes de conversação (Dialogflow CX) traduzem textos ou áudios do usuário final durante uma conversa a dados estruturados que seus apps e serviços podem entender. Você projeta e cria um agente de agentes de conversação (Dialogflow CX) para lidar com os tipos de conversação necessárias para seu sistema.

Os agentes de conversação (Dialogflow CX) são semelhantes 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 de conversação (Dialogflow 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 do repositório de dados ou selecione Criar seus próprios agentes 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 Save.

API

Se você ainda não configurou as configurações de localização para seu projeto, faça isso no console antes de criar agentes com a API. No momento, não é possível configurar as configurações de local 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 do 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

Fechar

Dados do agente

Os agentes de agentes de conversação (Dialogflow CX) servem como contêineres de nível superior para configurações e dados de 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 diferentes 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. 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 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

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 seu agente para o formato JSON.
  2. Descompacte o arquivo salvo.
  3. Localize o arquivo agent.json.
  4. Atualize defaultLanguageCode e supportedLanguageCodes aos valores desejados.
  5. Restaure o agente para o mesmo agente ou um diferente da etapa 1.
  6. Atualize frases de treinamento e valores de entidade específicos da linguagem conforme necessário.

• Bloqueio do 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 da conversa, Exportação do BigQuery, Análise, e a melhoria do modelo de PLN requerem que essa configuração esteja ativada, já que dependem dos registros de tráfego.

  • Ativar a edição de entradas do usuário final com base no consentimento

    Quando esta configuração está ativada, é possível usar um parâmetro de sessão especial para controlar se as entradas e os parâmetros do usuário final são editados no histórico de conversas e no Cloud Logging. Por padrão, o parâmetro da sessão é true. Se essa configuração estiver desativada, não haverá ocultação.

    O consentimento do usuário é coletado usando um parâmetro de sessão booleano: $session.params.conversation-redaction. Se essa configuração for ativada e o parâmetro de sessão for definido como false, nenhuma edição vai ocorrer (outras estratégias de edição ainda se aplicam). Se essa configuração for ativada e o parâmetro da sessão for definido como true, a edição vai ocorrer.

    Um exemplo de fluxo de solicitação de consentimento pode ser: primeiro perguntar ao usuário se ele quer manter a entrada do usuário final e corresponder a resposta com duas intents, uma é "intent de sim" e a outra é "intent de não". Em seguida, defina o parâmetro da sessão como false (sem edição) nas predefinições de parâmetro da rota "intent yes" no fulfillment e como true (ocorre edição) na predefinição de parâmetro da rota "no intent".

• Exportação do BigQuery

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

• Sugestões de intent

  É possível ativar sugestões de intenção.

• Modelo de payload personalizado

  Nesta seção, você pode criar descrições e payloads para modelos de payload personalizados.

Configurações de ML

Os agentes de conversação (Dialogflow CX) usam algoritmos de machine learning (ML) para entender as entradas do usuário final, combiná-las com intents e extrair dados estruturados. Os agentes de conversação (Dialogflow CX) aprendem com frases de treinamento que você fornece e os modelos de linguagem integrados aos agentes de conversação (Dialogflow CX). 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 exclusivas de ML a cada fluxo de um agente, e o modelo criado pelos agentes de conversação (Dialogflow CX) é 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 de agentes de conversação (Dialogflow CX).

  Observação: se a entrada original e corrigida do usuário final corresponderem a intents diferentes, será selecionada aquela que corresponde à 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 NLU funciona melhor que o padrão, especialmente para agentes e fluxos grandes.
  • PLN padrão: tecnologia de PLN padrão. Não vai mais receber melhorias de qualidade nem 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 de falsos positivos e ainda conseguir variedade com entradas de linguagem natural correspondentes para seu agente, é possível ajustar o limiar de classificação de aprendizado. Essa configuração controla a intenção mínima a confiança de detecção exigida para um 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.

  É possível definir um valor de limiar de classificação separado para cada fluxo em cada idioma ativado para o agente. Isso serve para acomodar diferentes idiomas com melhor desempenho em diferentes limiares de classificação. Para mais informações sobre a criação de um agente multilíngue, consulte o documentação de agentes multilíngues.

  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 de trem

  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

  • Frases banidas

    Lista de frases proibidas para a IA generativa. Se uma frase proibida aparecer no comando ou na resposta gerada, a geração vai falhar.

  • Filtros de segurança

    Configurar níveis de sensibilidade de filtros de segurança para diferentes categorias de IA responsável (RAI). O conteúdo será avaliado com base nas quatro categorias a seguir:

    Categoria	Descrição
    Discurso de ódio	Comentários negativos ou nocivos voltados à identidade e/ou atributos protegidos.
    Conteúdo perigoso	Promove ou permite o acesso a produtos, serviços e atividades prejudiciais
    Conteúdo sexualmente explícito	Contém referências a atos sexuais ou outro conteúdo obsceno
    Assédio	Comentários maliciosos, intimidantes, abusivos ou violentos direcionados a outra pessoa

    O conteúdo é bloqueado com base na probabilidade de ser nocivo. Para personalizar o nível de sensibilidade, selecione Bloquear poucos, Bloquear alguns e Bloquear a maioria em cada categoria. Também é possível ter acesso à opção restrita Bloquear nenhum, que desativa as verificações de RAI para a categoria, depois de enviar uma solicitação de confirmação de risco para o projeto e receber a aprovação.

    Para mais informações, consulte Configurar atributos de segurança.

  • Segurança do prompt

    Você pode marcar a configuração Ativar solicitação de verificação de segurança. para ativar verificações de segurança de comandos. Quando ativado, o agente tentará impedir ataques de injeção de comando. Esses ataques podem ser usados para revelar partes do comando do agente ou fornecer respostas que o agente não deve fornecer. Para isso, é preciso enviar um comando LLM adicional que verifica se a consulta do usuário é possivelmente maliciosa.

    Essa configuração é ativada por padrão para novos agentes. Se o agente tiver sido criado antes do lançamento dessa configuração, a configuração não está ativada.

• Agente generativo

  Observação: essa configuração tem acesso restrito.

  • Seleção generativa de modelo

    Selecione o modelo usado pelos recursos generativos. Para mais informações, consulte versões do modelo.

• Fallback generativo

  • Configuração do comando de texto

    Consulte Fallback generativo: defina sua própria instrução.

• Datastore

  Consulte Configurações do agente de repositório de dados.

Configurações de fala e de URA

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

• Text-to-Speech

  • Seleção de voz

    É possível selecionar o idioma e a voz usados para a síntese de voz.

    Para ativar a Voz personalizada do agente, selecione a opção "Voz personalizada" na caixa de seleção de voz e especifique o nome da voz personalizada no campo correspondente. O nome da voz personalizada precisa seguir o seguinte padrão: projects/PROJECT_ID/locations/LOCATION/models/MODEL_NAME:

    • Se você estiver usando um gateway de telefonia, verifique se a conta de serviço do agente de serviço do Dialogflow [e-mail] recebeu o "Preditor do AutoML" no seu projeto de voz personalizada.
    • Para chamadas de API regulares, verifique se a conta de serviço usada para chamar os agentes de conversação (Dialogflow CX) foi concedida com o "AutoML Predictor" em um 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

    Para saber mais sobre as opções de fala avançadas, consulte o guia Configurações de fala avançadas.

DTMF

Consulte DTMF para integrações de telefonia para mais informações.

Multimodal

Consulte Companheiro de 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

Observação: os tipos de agente do Dialogflow ES e dos Agentes de conversação (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.

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

• Versões do 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 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. As 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 dos agentes da Vertex AI: todas as referências aos 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, crie um novo agente de repositório de dados do zero. Como alternativa, você pode transformar seu agente em um agente de repositório de dados adicionando um gerenciador de estado a ele. Nesse caso, você vai receber orientações sobre como adicionar um app associado ao seu agente.
  • Se o agente de destino estiver associado a um app, todas as referências do repositório de dados serão atualizadas durante a restauração: o ID do projeto do Google Cloud e o local serão atualizados para corresponder ao app do agente de destino. O ID da coleção e o ID do repositório de dados vão permanecer 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 repositório de dados chamado projects/123/locations/eu-west2/collections/default_collection/dataStores/myDataStore1 e o app do agente de destino for chamado projects/321/locations/us-east1/collections/default_collections/engines/app123, a referência resultante do repositório de dados no agente de destino vai ser: projects/321/locations/us-east1/collections/default_collection/dataStores/myDataStore1

Observação: na API e no conteúdo dos dados exportados, um O app Vertex AI Agents é chamado de GenAppBuilder Engine. Por exemplo, em um pacote JSON exportado, é possível encontrar o nome do mecanismo no arquivo agent.json, na chave genAppBuilderSettings.engine.

Ao exportar, você pode selecionar o formato do arquivo de exportação. Se você estiver usando a versão de controle de origem para os dados do agente, exporte no formato JSON. Quando você restaura um agente, os agentes de conversação (Dialogflow CX) determinam 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 um 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 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

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.

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 (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

Fechar

Se você excluir seu projeto, todos os agentes de conversação (Dialogflow CX) e dados associados ao projeto serão excluídos imediatamente.