Manipuladores de repositório de dados

Os gerenciadores de repositório de dados são um tipo especial de gerenciador de estado que podem fornecer respostas de agentes geradas por LLMs com base no conteúdo do seu site e nos dados enviados.

Para criar esse gerenciador, você fornece armazenamentos de dados ao criar o agente.

Usando esses manipuladores de repositório de dados, o agente pode conversar sobre o conteúdo com os usuários finais.

Limitações

Considere as seguintes limitações:

Controle de acesso

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

  • Administrador do Dialogflow
  • Administrador do Discovery Engine

Para mais informações, consulte o guia de controle de acesso.

Criar um agente

Para criar um agente que use gerenciadores de repositório de dados:

  1. Caso ainda não tenha feito isso, siga configuração instruções.
  2. Acesse o console do Criador de agentes:

    Console do Criador de agentes

  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. Informe 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. Informe o nome do agente na seção Nome do agente.

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

  13. Clique em Continuar.

  14. Conecte um repositório de dados para o agente de uma das seguintes formas:

    • Selecione um repositório de dados criadas anteriormente.
    • Crie um repositório de dados:
      1. Clique em Criar novo repositório de dados.
      2. Escolha uma origem de dados.
      3. Forneça dados e configuração para a origem do 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 foi criado, A página Repositórios de dados disponíveis é aberta automaticamente. 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 o agente com o console do Dialogflow CX, clique em Prévia no painel à esquerda. No console, é possível editar ou adicionar manipuladores de repositório de dados, implantar seu agente e, opcionalmente, adicionar fluxos que processarão cenários não cobertos pelos repositórios de dados.

Testar seu agente

Use o simulador para testar seu agente.

Implantar o agente

Há muitas maneiras de implantar o agente:

Intents especiais

Além de responder a perguntas sobre o conteúdo que você fornece, o agente pode responder aos seguintes tipos de perguntas:

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

Isso é feito com intents e rotas de intent gerados automaticamente.

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

Os manipuladores de armazenamento de dados são um tipo especial de manipulador de estado. Isso significa que você pode aplicá-los a fluxos ou páginas, e são avaliados usando a mesma regras de escopo.

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

  1. Acesse o console do Dialogflow CX.
  2. Selecione o projeto.
  3. Selecione o agente.
  4. Selecione o fluxo associado ao gerenciador de repositório de dados. Geralmente, essa é a 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 manipulador de estado nos dados da página e selecione armazenamento de dados.
  7. Se você precisar criar um repositório de dados, você vai acessar a página da Vertex AI Agent Builder de uma ferramenta de visualização. Consulte a informações do repositório de dados para ajudar você a fazer 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 Link máximo para indicar o número máximo de links complementares que precisam ser fornecidos pelas respostas generativas.