Agente pré-construído do Departamento de Veículos Motorizados (DMV, na sigla em inglês)

O Departamento de Veículos Automotores (DMV) playbook-based prebuilt agents permite que os usuários renovem a carteira de habilitação on-line e agendem horários nas agências de campo do DMV.

Exemplos de diálogos

As caixas de diálogo de exemplo a seguir demonstram cenários comuns processados por esse agente pré-criado.

Renovar carteira de habilitação

O usuário pede para renovar a carteira de habilitação. O agente coleta as informações necessárias, incluindo o número da carteira de habilitação do usuário, a data de validade, o nome na carteira e a data de nascimento. Em seguida, o agente verifica se a licença está qualificada para renovação e confirma se o usuário quer continuar com uma renovação on-line. O agente cria a inscrição on-line e fornece um número de confirmação.

Entrada do usuário	Resposta do agente
Olá,
	Olá, sou seu assistente do DMV. Posso ajudar você a renovar sua carteira de motorista on-line e agendar um horário em um escritório de campo do DMV. Como posso ajudar?
Quero renovar minha carteira de habilitação
	Informe o número da sua carteira de habilitação mais recente.
Sim, é ABCD1234.
	Obrigado, encontrei seu perfil. Informe a data de validade da licença.
09-01-2023
	Informe o nome na licença.
O nome na licença é Jacky Wang
	Obrigado. Qual é sua data de nascimento?
1985-02-03
	Você pode confirmar as informações para mim? Nome do motorista: Jacky Wang Data de nascimento: 02-03-1985 Número da carteira de habilitação: ABCD1234 Data de validade: 09-01-2023
Sim, isso mesmo
	Obrigado. Verifiquei suas informações. Você se qualifica para a renovação on-line. Você quer renovar sua carteira de habilitação on-line?
Sim
	Você solicitou a renovação da sua carteira de habilitação. Seu número de confirmação é 3LKCN0JS.
	Posso ajudar com mais alguma coisa hoje?
Não, já terminei. Obrigado.
	Valeu! Tenha um bom dia.

Agendar horário

O usuário pede para marcar um horário. O agente coleta as informações necessárias, incluindo o escritório específico do DMV, a data e a hora do agendamento. Depois de confirmar os detalhes coletados com o usuário, o agente marca o horário para o usuário e fornece um número de confirmação.

Entrada do usuário	Resposta do agente
Você pode me ajudar a marcar um horário?
	Posso ajudar você a marcar um horário. Você pode me dar um endereço para que eu possa pesquisar os escritórios do DMV mais próximos?
Sim, é a 1st Main Street, MN.
	Obrigado. Encontrei os seguintes escritórios do DMV perto de você. Selecione uma opção. 1. Minnesota Driver & Vehicle Services: 2929 Chicago Ave, Minneapolis, MN 55407 2. DMV de Apple Valley: 15026 Glazier Ave, Apple Valley, MN 55124
Quero ir ao DMV do Brooklyn
	Não consegui encontrar o DMV que você informou. Selecione na lista: 1. Minnesota Driver & Vehicle Services 2. Apple Valley DMV
Depois, Apple Valley DMV
	Para que data você quer marcar um horário? Tenho o seguinte disponível: 1. 12-13-2023 2. 12-14-2023 3. 15/12/2023 Se nenhuma dessas datas for adequada para você, informe outra data de sua preferência.
Quero ir em 16 de dezembro de 2023
	Nosso escritório fecha aos fins de semana. Você quer selecionar uma das seguintes datas? 1. 18/12/2023 2. 19/12/2023 3. 12-20-2023
19 de dezembro de 2023
	Obrigado. Que horário você quer agendar? Tenho estes horários disponíveis para 19/12/2023: 1. 9:30 2. 10:00 3. 11:30
nine
	Sinto muito. 9h não dá. Que horário você quer agendar? Tenho 1. 9:30 2. 10:00 3. 11:30
nove e meia
	Confirme se você quer agendar este horário: Departamento de veículos automotores: Apple Valley DMV Data do agendamento: 19/12/2023 Horário do agendamento: 9h30
Sim, funciona para mim
	Obrigado. Marquei a consulta. Seu número de confirmação é BNFG987H.
	Posso ajudar com mais alguma coisa hoje?
Incorreto
	Agradecemos por entrar em contato com seu assistente do DMV. Tenha um bom dia!

Entrada não reconhecida

O usuário pergunta sobre um assunto não relacionado à renovação de uma carteira de habilitação ou ao agendamento de um horário. O agente responde esclarecendo quais assuntos ele pode abordar.

Entrada do usuário	Resposta do agente
oi
	Olá, sou seu assistente do DMV. Posso ajudar você a renovar sua carteira de motorista on-line e agendar um horário em um escritório de campo do DMV. Como posso ajudar?
Quero comprar um carro
	Sinto muito. Não entendi. Posso ajudar você a renovar uma carteira de habilitação ou agendar um horário.
	Como posso ajudar?
Quero marcar um horário
	Posso ajudar você a marcar um horário. Você pode me dar um endereço para que eu possa pesquisar os escritórios do DMV mais próximos?
Quanto isso vai me custar?
	Não consigo determinar as taxas esperadas. Consulte o site do DMV local para conferir todos os serviços e taxas.
	Quer continuar?
não, é isso
	Posso ajudar com mais alguma coisa hoje?
não, isso é tudo
	Ok, obrigado por entrar em contato com seu assistente do DMV. Tenha um bom dia!

Configuração básica

Para configurar esse agente pré-criado:

1. Importe o agente pré-criado.
2. Configure as ferramentas fornecidas com seus serviços externos. Consulte Configuração de ferramentas.

Configuração da ferramenta

Esse agente inclui ferramentas usadas para integração com serviços externos. É possível usar o instalador de ferramentas pré-criado para implantar código e dados de amostra para seu agente pré-criado.

Para implantar e configurar o exemplo de código e os dados do agente pré-criado do DMV, abra as instruções.

1. Faça o download do instalador de ferramentas pré-criadas para um diretório local.
2. Navegue até o diretório local em que você fez o download de installer.zip.
3. Descompacte installer.zip e abra a pasta installer.
4. Consulte o arquivo README.md para uma visão geral detalhada do instalador e dos requisitos dele.
5. Execute pip install -r requirements.txt para instalar os requisitos.
6. Execute gcloud auth application-default login para fazer a autenticação usando gcloud auth.
7. Execute o instalador usando python installer.py --project-id=YOUR_GCP_PROJECT_ID --prebuilt-id=dmv
8. Depois de implantar todos os serviços necessários, configure cada ferramenta no agente pré-criado com os URLs fornecidos registrados pelo instalador:

   Console do Vertex AI Agent Builder

   1. Se você ainda não importou o agente pré-criado, importe-o para seu projeto.
   2. Acesse o console do Vertex AI Agent Builder.

      Console do Vertex AI Agent Builder

   3. Selecione seu projeto no menu suspenso do console.
   4. Selecione seu app.
   5. Clique no ícone Ferramentas.
   6. Para cada ferramenta no agente, edite o esquema para substituir o URL no campo servers: pelo endpoint registrado pelo instalador.
   7. Clique em Salvar.

   Dialogflow CX

   1. Se você ainda não importou o agente pré-criado, importe-o para seu projeto.
   2. Abra o console do Dialogflow CX.
   3. Escolha seu projeto do Google Cloud.
   4. Selecione seu agente.
   5. Clique no ícone de Recursos generativos.
   6. Clique em Ferramentas.
   7. Para cada ferramenta no agente, edite o esquema para substituir o URL no campo servers pelo endpoint registrado pelo instalador.
   8. Clique em Salvar.
9. Conceda à conta de serviço do Compute Engine (your-project-number-developer.gserviceaccount.com) o papel de Usuário do Cloud Datastore, para que as funções do Cloud Run recém-implantadas possam acessar o Firestore.

Ferramenta de renovação de licença

A ferramenta dmv_renew_tool é usada para verificar os detalhes da carteira de habilitação, incluindo nome do motorista, data de nascimento, número da carteira e data de validade. Depois que as informações necessárias são coletadas e verificadas, essa ferramenta é usada para verificar se uma licença está qualificada para renovação. Se a licença estiver qualificada para renovação, a ferramenta será usada para enviar um pedido de renovação para o usuário.

Ferramenta de agendamento de horário

A ferramenta dmv_book_appointment_tool recupera informações de horários disponíveis, incluindo escritórios locais, datas e horários de agendamento. Depois que um escritório, uma data e um horário válidos são selecionados, essa ferramenta é usada para agendar a consulta.

Concluído

Seu agente e as integrações dele agora estão configurados e prontos para teste.