1. Antes de começar
Este codelab autoguiado vai orientar você na criação de agentes de IA com o Vertex AI Agent Builder do Google Cloud. Cada etapa destaca um recurso específico do Criador de agentes e explica a finalidade dele.
Pré-requisitos
- Conhecimento básico sobre a IA generativa no Google Cloud
- Noções básicas sobre os conceitos de agentes de IA
O que você vai aprender
- Como criar um agente de IA simples usando o Vertex AI Agent Builder
- Como conectar o agente criado anexando um repositório de dados
O que é necessário
- Uma mente curiosa
- Um computador em funcionamento com uma rede Wi-Fi confiável
- Um projeto do Google Cloud com faturamento anexado
2. Como projetar seu primeiro agente de IA
Agora você está pronto para criar seu próprio agente de IA. No entanto, antes de começar a desenvolver, é essencial estabelecer uma visão clara do agente. Faça estas perguntas:
- Qual problema ele vai resolver? Ele vai automatizar tarefas, fornecer informações, oferecer entretenimento ou facilitar a exploração criativa?
- Quais são as principais funções? Ele vai executar ou delegar tarefas? Ele vai gerar texto ou uma combinação de mídias diferentes?
- Quais são as limitações? Ele vai conseguir fazer tudo de forma autônoma?
- Qual personalidade ou perfil ele deve ter? Será formal, informal, bem-humorado, útil ou informativo?
- Quais são as métricas de sucesso? Como você vai medir a eficácia do agente?
Para acelerar o processo, aqui estão as respostas a essas perguntas para o agente de viagens que você criará hoje:
- Qual problema ele vai resolver?
- Planejar uma viagem pode ser demorado e cansativo. Esse agente de viagens ajuda os usuários a descobrir destinos, planejar itinerários e reservar voos e acomodações.
- Quais são as principais funções?
- O agente precisa ser capaz de
- responder a perguntas sobre destinos, como requisitos de visto;
- planejar itinerários que funcionem para os horários e objetivos dos usuários
- reservar voos e acomodações
- Quais são as limitações?
- O agente pode não conseguir responder a consultas complicadas por padrão
- O agente não vai conseguir gerar imagens visuais.
- O conhecimento do agente será limitado pelo modelo subjacente
- Qual personalidade ou perfil ele deve ter?
- Esse agente precisa ser experiente, prestativo e entusiasmado com viagens. Ele precisa ser capaz de comunicar informações de forma clara e concisa.
- Quais são as métricas de sucesso?
- O sucesso desse agente pode ser medido pela satisfação dos usuários com as recomendações (exploração, planejamento, reserva).
3. Como criar um agente de IA com o Vertex AI Agent Builder
Com o Vertex AI Agent Builder, é possível criar agentes de IA em apenas algumas etapas.
Etapa 1:
- Acesse o Vertex AI Agent Builder.
- A página de boas-vindas vai aparecer.
- Clique no botão CONTINUAR E ATIVAR A API.
Etapa 2:
- Você será redirecionado para a página "Criação de apps".
- Clique no botão CREATE A NEW APP.
Etapa 3:
- Selecione Agente na próxima página.
Etapa 4:
- Escolha um Nome de exibição (por exemplo, parceiro de viagem)
- Selecione global como Região.
- Clique no botão CONCORDAR E CRIAR.
Etapa 5:
- Escolha um nome de agente (por exemplo, agente de informações)
- Adicionar uma meta (por exemplo, ajudar os clientes a responder a consultas relacionadas a viagens)
- Defina uma instrução (por exemplo, cumprimentar os usuários e perguntar como você pode ajudá-los hoje mesmo).
- Clique em Salvar quando tudo estiver finalizado.
Etapa 6:
- Selecione o agente que você acabou de criar (por exemplo, Agente de informações).
- Escolha o modelo de IA generativa subjacente para seu agente (por exemplo, gemini-1.5-flash)
- Teste seu agente conversando com ele (por exemplo, digite algo na caixa de texto "Entrada do usuário").
Parabéns! Você acabou de criar um agente de IA usando o Vertex AI Agent Builder.
4. Como anexar Datastores ao agente
Pergunte ao seu agente sobre como chegar a Wakanda (por exemplo, "Qual é a melhor maneira de entrar em contato com Wakanda?"). Você receberá uma resposta como esta:
Embora isso seja correto, em vez de simplesmente dizer "Não posso fornecer informações" e encerrar a conversa, seria mais útil para o usuário se o agente sugerisse lugares semelhantes. Essa abordagem pode levar os usuários a reservar uma viagem com o agente.
Para que o agente recomende lugares semelhantes, forneça mais informações a ele usando os repositórios de dados. Funciona como uma base de conhecimento adicional para o agente consultar se ele não for capaz de responder às perguntas do usuário com base em seu conhecimento integrado.
A criação de um repositório de dados é simples. Clique no botão + Data store na parte de baixo da página "Agent Basics".
Na próxima tela, preencha as seguintes informações:
- Nome da ferramenta:Local alternativo
- Tipo:repositório de dados
- Descrição:use essa ferramenta se a solicitação do usuário tiver um local que não existe
e clique em Salvar quando terminar. Isso cria uma ferramenta de repositório de dados para que o agente se comunique com ele, mas você ainda precisa criar um repositório de dados real que contenha as informações. Para isso, clique em Criar um repositório de dados.
Você pode receber uma mensagem pop-up para concordar com o armazenamento dos seus repositórios de dados de pesquisa e conversa na região dos EUA. Se você quiser continuar, clique no botão AGREE.
Para continuar a criação de repositórios de dados, preencha o campo nome da empresa (por exemplo, Travel Wise) e clique em CONTINUAR.
Clique em CRIAR LOJA DE DADOS e selecione Cloud Storage.
Quando você concluir essa etapa,
- Selecione Documentos não estruturados (PDF, HTML, TXT e muito mais).
- Clique em ARQUIVO.
- Digite ai-workshops/agents/data/wakanda.txt na célula
- Clique no botão CONTINUAR.
Confira o conteúdo do arquivo de texto fornecido:
Lugares semelhantes a Wakanda
- Oribi Gorge, na África do Sul: as formações rochosas lembram as Cataratas do Guerreiro em Wakanda.
- Cataratas do Iguaçu: localizadas na fronteira da Argentina com o Brasil, estas enormes cachoeiras foram uma grande inspiração para as Cataratas do Guerreiro.
- Mergulhe na cultura de Wakanda: leia os quadrinhos da Pantera Negra, assista aos filmes e explore os recursos on-line para saber mais sobre a cultura, a língua e a tecnologia de Wakanda.
- Visite um parque temático da Disney: embora ainda não exista uma área dedicada a Wakanda, você pode encontrar o Pantera Negra na Disneylândia ou em um cruzeiro Marvel Day at Sea da Disney.
Na próxima página, nomeie o repositório de dados (por exemplo, "Wakanda Alternative") e clique em Criar.
Por fim, clique em SELECIONAR a fonte de dados que você acabou de criar e clique em CRIAR.
Se tudo tiver corrido bem, o repositório de dados criado vai aparecer na página "Repositórios de dados disponíveis".
Se você clicar no repositório de dados (Wakanda Alternative, neste caso), vai encontrar mais detalhes sobre ele, incluindo os documentos incluídos:
Volte para a página Noções básicas sobre o agente e clique em Gerenciar todas as ferramentas 
.
Clique no repositório de dados que você criou anteriormente.
Haverá novas configurações na seção "Repositórios de dados". Se você não conseguir acessar essas novas configurações imediatamente, significa que o repositório de dados ainda está ingerindo os dados do Google Cloud Storage. O processo deve ser concluído em menos de cinco minutos.
- Escolha o repositório de dados que você quer vincular (por exemplo, Wakanda Alternative)
- Para evitar que o Agente tenha alucinações, defina a configuração como Muito baixa. Isso aplica restrições mais rígidas ao Agente de inventar coisas.
- Clique no botão Salvar na parte de cima da página quando terminar as edições.
Volte para a página Noções básicas do agente, verifique o repositório de dados (por exemplo, local alternativo) e clique no botão Salvar na parte de cima da página.
Você está quase lá! A etapa final é incluir a ferramenta Local alternativo nas instruções do agente. Adicione uma linha, - Use ${TOOL: Alternative Location} se a solicitação do usuário contiver um local que não existe, às instruções do agente.
A borda da caixa de instruções pode ficar vermelha, mas isso não é um problema. Para salvar o agente, clique no botão Save na parte de cima da página.
Depois de salvar a configuração do agente, tente perguntar sobre como chegar a Wakanda (por exemplo, "Qual é a melhor maneira de chegar a Wakanda?") novamente. Você vai receber uma resposta diferente, como esta:
Parabéns! Agora, o agente recomenda lugares usando as informações fornecidas em um arquivo de texto.