Os manipuladores de repositório de dados são um tipo especial de manipulador de estado que pode fornecer respostas de agentes geradas pelo LLM com base no conteúdo do seu site e nos dados enviados.
Para criar esse gerenciador, forneça 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:
- No momento, esse recurso só é compatível com alguns idiomas no GA. Consulte a coluna "repositório de dados" na referência de idiomas.
- Somente as seguintes regiões
são compatíveis:
global, multirregiõesuse multirregiõeseu. - O único tipo de repositório de dados estruturados compatível é o de perguntas frequentes.
- Não há suporte para apps com armazenamentos de dados em blocos e não em blocos.
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, 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 manipuladores de repositório de dados:
- Se ainda não tiver feito isso, siga as instruções de configuração.
Acesse o console do Criador de agentes:
Selecione seu projeto no menu suspenso do console.
Se você ainda não ativou a API, leia e aceite os Termos de Serviço e clique em Continuar e ativar a API.
Clique em Criar um app ou Novo app.
Selecione Chat.
Informe o nome da sua empresa na seção Configurações do agente.
Abra a seção de configurações de fuso horário e idioma.
Selecione um fuso horário.
Selecione um idioma padrão.
Informe o nome do agente na seção Nome do agente.
Selecione uma região ou multirregião na seção Local do agente.
Clique em Continuar.
Conecte um repositório de dados ao seu agente fazendo uma das seguintes ações:
- Selecione um repositório de dados criado anteriormente.
- Crie um novo repositório de dados:
- Clique em Criar novo repositório de dados.
- Escolha uma origem de dados.
- Forneça dados e configuração para a fonte do repositório de dados selecionada. O local do repositório de dados precisa corresponder ao local do agente.
- Clique em Criar para criar o repositório de dados.
- Selecione o novo repositório de dados.
Clique em Criar.
Seu agente foi criado, e você foi redirecionado automaticamente para a página Repositórios de dados disponíveis, onde é possível adicionar mais repositórios de dados conforme necessário.
Se você criou um novo repositório de dados para um site, é necessário verificar seu domínio.
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 o agente
Use o simulador para testar seu agente.
Implantar o agente
Há muitas maneiras de implantar o agente:
A opção mais simples é usar uma integração, que fornece uma interface de usuário para seu agente. Cada integração oferece instruções para a implantação.
A integração do Dialogflow CX Messenger é uma opção particularmente boa para processadores de repositório de dados. Ele tem opções integradas para recursos generativos.
Você pode criar sua própria interface do usuário e usar a API de agentes de conversação (Dialogflow CX) para interações. A implementação da interface do usuário controla a implantação.
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 real".
Isso é feito com intents e rotas de intent gerados automaticamente.
Adicionar ou editar manipuladores de repositório de dados para um agente
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 que eles são avaliados usando as mesmas regras de escopo.
Para adicionar ou editar um gerenciador de repositório de dados:
- Acesse o console do Dialogflow CX.
- Selecione o projeto.
- Selecione o agente.
- Selecione o fluxo associado ao gerenciador do repositório de dados. Esse é geralmente o fluxo de início padrão.
- Selecione a página associada ao gerenciador de repositório de dados. Geralmente, é a página inicial.
- Clique em Adicionar manipulador de estado nos dados da página e selecione Repositório de dados.
- Se você precisar criar um repositório de dados, a interface do usuário do Vertex AI Agent Builder vai ser aberta. Consulte as informações do repositório de dados para ajudar a fazer seleções.
- Se você já tiver um repositório de dados, clique em Editar repositório de dados.
- Faça as atualizações necessárias e salve quando terminar. Confira abaixo as informações 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 devem ser fornecidos pelas respostas generativas.