Agentes

Um agente do Dialogflow CX é um agente virtual que processa 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 CX 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 de CX do Dialogflow CX para processar os tipos de conversa solicitados para seu sistema.

O atendimento do agente do Dialogflow CX é semelhante ao de um funcionário 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 do Dialogflow CX para um projeto do Google Cloud.

Para criar um agente, siga estas etapas:

Console

1. Abra o console do Dialogflow CX.
2. Criar ou escolher um projeto
3. Clique em Criar agente.
4. Selecione Gerar automaticamente para criar um agente de repositório de dados ou selecione 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. Se você quiser mudar as configurações de localização avançadas, clique no botão Editar.
   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 configurou as configurações de localização do seu projeto, configure essas configurações no console antes de criar agentes com a API. 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 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

Fechar

Dados do agente

Os agentes de CX do Dialogflow CX servem como contêineres de nível superior para configurações e dados de agentes virtuais. 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 vários níveis, consulte os níveis de aplicação de dados.

Endpointing inteligente

A Speech-to-Text (STT) é uma API que converte áudio em texto usando machine learning, permitindo que você integre o reconhecimento de fala aos seus aplicativos. Os modelos de STT compatíveis incluem qualquer modelo de formato longo (por exemplo, phone_call). Somente o idioma en-US é aceito.

Observação: se você usar um modelo curto, isso vai ativar o endpoint de fala na nuvem.

Se o endpoint inteligente estiver ativado para o agente, será possível personalizar o comportamento dele para um parâmetro numérico definindo o Tempo limite de espera para especificar o tempo extra. O Dialogflow CX vai aguardar o usuário fornecer mais informações.

O tempo limite de espera é um período de carência que permite adicionar algo à transcrição de STT antes que o tempo limite de fala seja acionado. O Dialogflow CX usa heurísticas para especificar qual tempo limite precisa ser escolhido com base na transcrição. Por exemplo, ele pode escolher um tempo limite muito curto se a intent tiver sido correspondida. Se a intent não for correspondida, ele poderá aumentar o tempo limite para que você diga outra coisa e tentar novamente a correspondência de intent.

Outros recursos da STT incluem:

• Endpointing mais rápido:a análise em tempo real usa o streaming de transcrição de áudio para distinguir entre uma pausa natural e a conclusão de uma fala enquanto o stream de STT permanece aberto. Se o usuário terminar de falar, o Dialogflow CX encerrará o stream antes para fornecer uma resposta mais rápida.
• Feedback de conversação natural:se o usuário fizer uma pausa no meio da fala, o Dialogflow CX poderá estender dinamicamente o tempo limite da STT para evitar interrupções prematuras ou injetar dicas de canal de retorno naturais (por exemplo, "mm hmm", "uh huh") para confirmar que o agente virtual ainda está ouvindo.

Exportar e restaurar um agente

Aviso: não vamos mais exportar credenciais de valor bruto para as ferramentas e webhooks da OpenAPI a partir de 15 de agosto de 2025. Migre para armazenar suas credenciais no Secret Manager. Para instruções, consulte as documentações de Webhook e Ferramenta.

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

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

• Versões do fluxo: somente as versões do fluxo usadas no ambiente selecionado são exportadas para um arquivo.
• Ambientes: os ambientes que não foram selecionados não são exportados para um arquivo.

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

• 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 podem ser selecionadas para o agente.
• Apps de agentes de IA da Vertex AI: a associação a um app de agentes de IA da Vertex AI permanece inalterada no agente de destino (ou seja, 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, porque o agente resultante também precisa ter uma associação com um app de agentes da Vertex AI.

• Repositórios de dados dos agentes de IA 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 nele. Se você tentar fazer isso, vai receber uma mensagem de erro. Para corrigir isso, crie um novo agente de repositório de dados do zero. Como alternativa, é possível transformar o agente atual em um agente de repositório de dados adicionando um gerenciador de estado de repositório de dados a ele. Nesse caso, você vai receber orientações para 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 após a restauração: o ID do projeto e o local do Google Cloud serão atualizados para corresponder ao app do agente de destino. O ID da coleção e o ID do repositório de dados não vão mudar. Isso significa que você precisa adicionar repositórios de dados para todos os IDs com tipos correspondentes ao 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 do 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, um app de agentes de IA da Vertex AI é chamado de mecanismo GenAppBuilder. 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 o controle de versões de origem para os dados do agente, exporte no formato JSON. Quando você restaura um agente, o Dialogflow CX determina automaticamente o formato do arquivo.

Para exportar ou restaurar um agente:

Console

1. Abra o console do Dialogflow CX.
2. Escolha o projeto para o agente.
3. Selecione a opção de menu para 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 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

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, você precisa de um papel que forneça acesso total ou de edição. 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 para o agente.
3. Selecione a opção de menu para um agente na lista.
4. Clique no botão .
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 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

Fechar

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