Agentes

Um agente de agentes de conversação (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. Os agentes de conversação (Dialogflow CX) convertem textos ou áudios de uma conversa com o usuário final em 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.

O atendimento do agente de conversação (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 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 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 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 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 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.

Exportar e restaurar um agente

É 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 do agente, 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 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 do 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 desaturadas não são listadas ou selecionáveis para o agente.
• Apps da Vertex AI Agents: a associação a um app da Vertex AI Agents 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, porque o agente resultante também precisa ter uma associação a um app de agentes do 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 restaurar um agente com referências de repositório de dados. Tentar fazer isso resulta 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 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 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 app de agentes da Vertex AI é chamado de mecanismo do 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. Se você estiver usando a controle de versão do 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 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, é 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 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 conversação (Dialogflow CX) e dados associados ao projeto serão excluídos imediatamente.