Agentes

Um agente de agentes de conversação (Dialogflow CX) é um agente virtual que processa conversas simultâneas com os seus utilizadores finais. É um módulo de compreensão de linguagem natural que compreende as nuances da linguagem humana. Os agentes conversacionais (Dialogflow CX) traduzem o texto ou o áudio do utilizador final durante uma conversa em dados estruturados que as suas apps e serviços podem compreender. Cria e desenvolve um agente de agentes conversacionais (Dialogflow CX) para processar os tipos de conversas necessários para o seu sistema.

Um agente de agentes conversacionais (Dialogflow CX) é semelhante a um agente humano de um centro de chamadas. Prepara-os para processarem cenários de conversa esperados, e a preparação não tem de ser demasiado explícita.

Crie um agente

Para criar um agente:

Dados do agente

Os agentes conversacionais (Dialogflow CX) funcionam como contentores de nível superior para definições e dados de agentes virtuais. Os seguintes dados estão associados aos agentes:

• Intenções
• Tipos de entidades
• Webhooks
• Fluxos
• Páginas
• Grupos de trajetos

Para mais informações sobre como os dados são aplicados a vários níveis, consulte os níveis de aplicação de dados.

Exporte e restaure um agente

Pode exportar um agente para um ficheiro e restaurar um agente com esse ficheiro.

Uma exportação de agentes inclui todos os dados dos agentes, exceto o seguinte:

• Versões do fluxo: Apenas os fluxos de rascunho são exportados para o ficheiro.
• Ambientes: Os ambientes personalizados não são exportados para o ficheiro.

Uma restauração do agente substitui todos os dados do agente de destino (incluindo todas as versões do 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 continuam a existir, desde que os ambientes associados existam. No entanto, estas versões de fluxo desatualizadas não são apresentadas nem selecionáveis para o agente.
• Apps de agentes do Vertex AI: a associação a uma app de agentes do Vertex AI permanece inalterada no agente de destino. (Por outras palavras, o valor de engine em GenAppBuilderSettings) Isto significa que os agentes de armazenamento de dados só podem ser restaurados noutros agentes de armazenamento de dados existentes, porque o agente resultante também tem de ter uma associação a uma app de agentes da Vertex AI.

• Vertex AI Agents Data Stores: Todas as referências a arquivos de dados são substituídas no agente de destino de acordo com as seguintes regras:

  • Se o agente de destino não estiver associado a uma app, não é possível restaurar um agente com referências de armazenamento de dados no mesmo. Se o tentar fazer, recebe uma mensagem de erro. Para corrigir esta situação, pode criar um novo agente de armazenamento de dados de raiz. (Em alternativa, pode transformar o seu agente existente num agente de arquivo de dados adicionando-lhe um processador de estado. Neste caso, vai receber orientações para adicionar uma app associada ao seu agente.)
  • Se o agente de destino estiver associado a uma app, todas as referências da loja de dados são atualizadas após o restauro: o respetivo ID do projeto do Google Cloud e a localização são atualizados para corresponderem à app do agente de destino. O ID da coleção e o ID da loja de dados permanecem inalterados. Isto significa que tem de adicionar arquivos de dados para todos os IDs com tipos correspondentes na app do agente de destino antes da operação de restauro.

  Exemplo: se o agente de origem se referir a um repositório de dados denominado projects/123/locations/eu-west2/collections/default_collection/dataStores/myDataStore1 e a app do agente de destino se denominar projects/321/locations/us-east1/collections/default_collections/engines/app123, a referência ao repositório de dados resultante no agente de destino torna-se: projects/321/locations/us-east1/collections/default_collection/dataStores/myDataStore1

Quando exporta, pode selecionar o formato do ficheiro de exportação. Se estiver a usar o controlo de versões de controlo de origem para os dados do seu agente, deve exportar no formato JSON. Quando restaura um agente, os agentes conversacionais (Dialogflow CX) determinam automaticamente o formato do ficheiro.

Para exportar ou restaurar um agente:

Se o tamanho do agente exceder o limite máximo, use a opção do Cloud Storage para exportar e restaurar o agente.

Se usar o GitHub, consulte também o guia de exportação/restauro do GitHub.

Elimine um agente

Para eliminar um agente, precisa de uma função que forneça acesso total ou acesso de edição. Consulte o guia de controlo de acesso para mais informações.

Para eliminar um agente:

Se eliminar o seu projeto, todos os agentes conversacionais (Dialogflow CX) e os dados associados ao projeto são eliminados imediatamente.