Agentes de repositório de dados

Os agentes de armazenamento de dados são um tipo especial de agente do Dialogflow que podem fornecer respostas do agente geradas por LLM com base no conteúdo do seu site e nos dados enviados.

Para criar esse agente, forneça armazenamentos de dados ao criá-lo.

Um agente de repositório de dados tem gerenciadores de estado especiais chamados gerenciadores de repositório de dados. Com o uso deles, o agente de repositório de dados pode conversar sobre o conteúdo com os usuários finais.

Limitações

Considere as seguintes limitações:

  • No momento, esse recurso só é compatível com idiomas selecionados no GA. Consulte a coluna do repositório de dados na referência de idiomas.
  • Somente as seguintes regiões são aceitas: global, multirregião us e multirregião eu.
  • As perguntas frequentes são o único tipo de repositório de dados estruturados aceito.
  • Apps com armazenamentos de dados em partes e não divididos não são compatíveis.

Controle de acesso

Se você for o proprietário do projeto, terá todas as permissões necessárias para criar um agente de repositório de dados. Se você não for o proprietário do projeto, precisará ter os seguintes papéis:

  • Administrador do Dialogflow
  • Administrador do Discovery Engine

Para mais informações, consulte o Guia de controle de acesso do Dialogflow.

Criar um agente de repositório de dados

Para criar um agente de repositório de dados:

  1. Siga as instruções de setup do Dialogflow, caso ainda não tenha feito isso.
  2. Acesse o console do Agent Builder:

    Console do Agent Builder

  3. Selecione o projeto na lista suspensa do console.

  4. Se você ainda não ativou a API, leia e concorde com os Termos de Serviço e clique em Continuar e ativar a API.

  5. Clique em Create a New App ou New App.

  6. Selecione Chat.

  7. Forneça o nome da sua empresa na seção Configurações do agente.

  8. Expanda a seção de configurações de fuso horário e idioma.

  9. Selecione um fuso horário.

  10. Selecione um idioma padrão.

  11. Forneça um nome de agente na seção Nome do agente.

  12. Selecione uma região ou multirregião na seção Local do seu agente.

  13. Clique em Continuar.

  14. Para conectar um repositório de dados ao seu agente, siga um destes procedimentos:

    • Selecione um repositório de dados que você criou anteriormente.
    • Crie um repositório de dados:
      1. Clique em Criar novo repositório de dados.
      2. Escolha uma fonte de dados.
      3. Forneça os dados e a configuração da fonte de repositório de dados selecionada. O local do repositório de dados precisa corresponder ao local do agente.
      4. Clique em Criar para criar o repositório de dados.
      5. Selecione seu novo repositório de dados.
  15. Clique em Criar.

  16. Seu agente será criado, e você será redirecionado automaticamente para a página Repositórios de dados disponíveis, em que é possível adicionar mais repositórios de dados conforme necessário.

  17. Se você criou um novo repositório de dados para um site, é necessário verificar seu domínio.

  18. Para abrir seu agente com o Dialogflow CX, clique em Visualizar no painel esquerdo. No console do Dialogflow CX, é possível editar ou adicionar repositório de dados dados, implantar seu agente e, opcionalmente, adicionar fluxos que processarão cenários não cobertos pelos armazenamentos de dados.

Testar seu agente

Use o simulador do Dialogflow CX para testar seu agente.

Implantar o agente

Há várias maneiras de implantar o agente:

  • A opção mais simples é usar uma integração do Dialogflow CX, que fornece uma interface do usuário para seu agente. Cada integração fornece instruções para implantação.

  • A integração do Dialogflow Messenger é uma opção particularmente boa para agentes de repositório de dados. Ele tem opções integradas para recursos generativos.

  • É possível criar sua própria interface do usuário e usar a API Dialogflow CX para interações. A implementação da interface do usuário controla a implantação.

Intents especiais

Além de lidar com perguntas sobre o conteúdo fornecido, o agente de repositório de dados pode lidar com os seguintes tipos de perguntas:

  • Identificação de agente: processa perguntas como "Quem é você?" ou "Você é humano?".
  • Encaminhar para um agente humano: processa perguntas como "Quero conversar com uma pessoa" ou "Quero conversar com uma pessoa real".

Isso é feito por intents e rotas de intent geradas automaticamente.

Adicionar ou editar gerenciadores de repositório de dados para um agente existente

Os gerenciadores de repositório de dados são um tipo especial de gerenciador de estado do Dialogflow. Isso significa que é possível aplicá-los a fluxos ou páginas e que são avaliados usando as mesmas regras de escopo.

Para adicionar ou editar um gerenciador de repositório de dados:

  1. Acesse o Console do Dialogflow CX.
  2. Selecione seu projeto do Google Cloud.
  3. Selecione o agente.
  4. Selecione o fluxo associado ao gerenciador do repositório de dados. Geralmente, esse é o fluxo inicial padrão.
  5. Selecione a página associada ao gerenciador do repositório de dados. Geralmente, é a página inicial.
  6. Clique em Adicionar gerenciador de estado nos dados da página e selecione repositório de dados.
  7. Se você precisar criar um repositório de dados, a interface do usuário do Vertex AI Agent Builder será exibida. Consulte as informações do repositório de dados para fazer as seleções.
  8. Se você já tiver um repositório de dados, clique em Editar repositório de dados.
  9. Faça as atualizações conforme necessário e salve quando terminar. Consulte as informações abaixo sobre as configurações específicas do repositório de dados.

Respostas do agente

Na seção Respostas do agente, é possível fornecer respostas personalizadas que fazem referência a respostas generativas. Use $request.knowledge.questions[0] na seção O agente diz para fornecer a resposta generativa.

Opções de resposta do repositório de dados

É possível atualizar o campo Máximo de links para indicar o número máximo de links complementares que precisam ser fornecidos pelas respostas generativas.