Começar a usar a pesquisa genérica

A Vertex AI Search reúne o poder da recuperação profunda de informações, o processamento de linguagem natural de última geração e o mais recente em processamento de linguagem grande para entender a intenção do usuário e retornar os resultados mais relevantes para o usuário.

Com a Vertex AI para Pesquisa, é possível criar apps para pesquisa e recomendações. A Vertex AI para Pesquisa também tem recursos especiais para alguns setores, como mídia, saúde e varejo.

Este tutorial se concentra na criação de um app de pesquisa para dados genéricos. ou seja, dados que não são específicos de um segmento do setor.

Este tutorial explica como criar apps de pesquisa para diferentes tipos de dados:

  • Dados do site relacionados ao rastreamento de cloud.google.com/generative-ai-app-builder/
  • Dados estruturados na forma de um conjunto de dados formatado em NDJSON ingeridos de um bucket do Cloud Storage
  • Dados não estruturados na forma de PDFs ingeridos de um bucket do Cloud Storage

Antes de seguir este tutorial, siga as etapas descritas em Antes de começar.

Para seguir as instruções passo a passo desta tarefa diretamente no console do Google Cloud, clique em Orientação:

Orientações

Antes de começar

  1. Sign in to your Google Cloud account. If you're new to Google Cloud, create an account to evaluate how our products perform in real-world scenarios. New customers also get $300 in free credits to run, test, and deploy workloads.

  2. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

    Go to project selector

  3. Make sure that billing is enabled for your Google Cloud project.

  4. Enable the Vertex AI Agent Builder (Discovery Engine), BigQuery, Cloud Storage APIs.

    Enable the APIs

    5.

  5. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

    Go to project selector

  6. Make sure that billing is enabled for your Google Cloud project.

  7. Enable the Vertex AI Agent Builder (Discovery Engine), BigQuery, Cloud Storage APIs.

    Enable the APIs

    8.

Ativar o Vertex AI Agent Builder

  1. No Console do Google Cloud, acesse a página Criador de agentes.

    Criador de agentes

  2. Leia e aceite os Termos de Serviço e clique em Continuar e ativar a API.

Criar um repositório de dados

Primeiro, você criará um repositório de dados com os dados que seu aplicativo de pesquisa indexará.

Clique na guia do tipo de dados que você quer colocar no repositório de dados: site, estruturados ou não estruturados.

Dados do site

  1. Acesse a página Criar repositório de dados.

    Agent Builder: criar repositório de dados

  2. No painel Selecionar uma fonte de dados, escolha Conteúdo do site.

  3. No painel Especificar os sites para seu repositório de dados, verifique se a indexação avançada de sites está desativada.

  4. No campo Sites a incluir, insira:

    cloud.google.com/generative-ai-app-builder/*

  5. Clique em Continuar.

  6. No painel Configure seu repositório de dados, selecione global (Global) como o local do seu repositório de dados.

  7. Insira um nome para o repositório de dados. Observe o ID que é gerado. Você precisará dele mais tarde.

  8. Clique em Criar.

Dados estruturados

  1. Acesse a página Criar repositório de dados.

    Agent Builder: criar repositório de dados

  2. No painel Selecionar uma fonte de dados, escolha Cloud Storage.

  3. No painel Importar dados do Cloud Storage, selecione Dados estruturados (JSONL).

  4. Verifique se a opção Arquivo está selecionada.

  5. No campo gs://, digite o seguinte valor:

    cloud-samples-data/gen-app-builder/search/kaggle_movies/movie_metadata.ndjson

    Esse bucket do Cloud Storage contém um arquivo de filmes formatado em NDJSON e disponibilizado pela Kaggle.

  6. Clique em Continuar.

  7. Atribua as propriedades principais da seguinte maneira:

    Nome do campo Propriedade da chave
    homepage uri
    overview description

    E clique em Continuar.

  8. No painel Configure seu repositório de dados, selecione global (Global) como o local do seu repositório de dados.

  9. Insira um nome para o repositório de dados. Observe o ID que é gerado. Você precisará dele mais tarde.

  10. Clique em Criar.

Dados não estruturados

  1. Acesse a página Criar repositório de dados.

    Agent Builder - Criar repositório de dados

  2. No painel Selecionar uma fonte de dados, escolha Cloud Storage.

  3. No painel Importar dados do Cloud Storage, selecione Documentos não estruturados (PDF, HTML, TXT e muito mais).

  4. Verifique se a opção Pasta está selecionada.

  5. No campo gs://, digite o seguinte valor:

    cloud-samples-data/gen-app-builder/search/alphabet-investor-pdfs

    Esse bucket do Cloud Storage contém PDFs do relatório de ganhos do site do investidor da Alphabet.

  6. No painel Configure seu repositório de dados, selecione global (Global) como o local do seu repositório de dados.

  7. Insira um nome para o repositório de dados. Observe o ID que é gerado. Você precisará dele mais tarde.

  8. Clique em Criar.

Criar um app de pesquisa

Em seguida, você criará um app de pesquisa e vinculará o repositório de dados criado anteriormente.

Dados do site

  1. Acesse a página Criar app.

    Agent Builder - Criar app

  2. No painel Selecionar tipo de app, escolha Pesquisa.

  3. Verifique se o conteúdo é Genérico e que a opção Recursos empresariais está ativada.

  4. No campo Nome do app, insira um nome para seu app. O ID do app aparece abaixo do nome dele.

  5. No campo Nome externo da sua empresa ou organização, insira o nome da empresa ou organização. Neste tutorial, é possível usar Google Cloud, porque o app vai pesquisar um site do Google Cloud.

  6. Selecione global (Global) como o local do app e clique em Continuar.

  7. Na lista de repositórios de dados, selecione aquele que você criou anteriormente e clique em Criar.

  8. Acesse a página Dados do seu app para visualizar a lista de sites indexados e altere-os, se necessário.

Dados estruturados

  1. Acesse a página Criar app.

    Agent Builder: criar app

  2. No painel Selecionar tipo de app, escolha Pesquisa.

  3. Verifique se o conteúdo é Genérico e que a opção Recursos empresariais está ativada.

  4. No campo Nome do app, insira um nome para seu app. O ID do app aparece abaixo do nome dele.

  5. No campo Nome externo da sua empresa ou organização, insira o nome da empresa ou organização. Neste tutorial, você pode usar Cymbal Cinemas, porque o app pesquisará um repositório de dados de filmes.

  6. Selecione global (Global) como o local do app e clique em Continuar.

  7. Na lista de repositórios de dados, selecione aquele que você criou anteriormente e clique em Criar.

  8. Na página Dados do app, clique na guia Atividade para consultar o status da ingestão de dados. Importação concluída aparece na coluna Status quando o processo de importação é concluído. Para este conjunto de dados, isso normalmente leva de dois a três minutos. Talvez seja necessário clicar em Atualizar para ver Importação concluída.

  9. Clique na guia Documentos para conferir o número de documentos importados.

Dados não estruturados

  1. Acesse a página Criar app.

    Agent Builder: criar app

  2. No painel Selecionar tipo de app, escolha Pesquisa.

  3. Verifique se o conteúdo é Genérico e que a opção Recursos empresariais está ativada.

  4. No campo Nome do app, insira um nome para seu app. O ID do app aparece abaixo do nome dele.

  5. No campo Nome externo da sua empresa ou organização, insira o nome da empresa ou organização. Neste tutorial, é possível usar Alphabet, porque o app vai pesquisar documentos da Alphabet.

  6. Selecione global (Global) como o local do app e clique em Continuar.

  7. Na lista de repositórios de dados, selecione aquele que você criou anteriormente e clique em Criar.

  8. Na página Dados do app, clique na guia Atividade para consultar o status da ingestão de dados. Quando o processo de importação é concluído, a coluna Status exibe Importação concluída. Para este conjunto de dados, o processo de importação geralmente leva de dois a três minutos. Talvez seja necessário clicar em Atualizar para consultar o status Importação concluída.

  9. Clique na guia Documentos para conferir o número de documentos importados.

Visualizar o app

Dados do site

  1. Na página Apps, clique no nome do seu novo aplicativo.

  2. No menu de navegação, clique em Visualizar para testar o app de pesquisa.

  3. Opcional: clique nos ícones para alternar entre a visualização para dispositivos móveis e para computadores.

  4. Na barra de pesquisa, pesquise Vertex AI Search para conferir os resultados do produto.

Dados estruturados

  1. Na página Apps, clique no nome do seu novo aplicativo.

  2. No menu de navegação, clique em Visualizar para testar o app de pesquisa.

  3. Opcional: clique nos ícones para alternar entre a visualização para dispositivos móveis e para computadores.

  4. Na barra de pesquisa, digite trains e pressione Enter para ver resultados de filmes relacionados a trens.

Dados não estruturados

  1. Na página Apps, clique no nome do seu novo aplicativo.

  2. No menu de navegação, clique em Visualizar para testar o app de pesquisa.

  3. Opcional: clique nos ícones para alternar entre a visualização para dispositivos móveis e para computadores.

  4. Na barra de pesquisa, digite Google e pressione Enter para consultar os resultados.

Configurar o widget de pesquisa

  1. No menu de navegação, clique em Configurações.

  2. Na guia interface, defina as configurações do app de pesquisa.

    Diferentes configurações de interface estão disponíveis para diferentes tipos de dados. Para mais informações, consulte Configurar resultados para o widget de pesquisa.

  3. Se você mudar as configurações na guia interface, clique em Salvar e publicar.

  4. Acesse a guia Preenchimento automático para definir configurações específicas.

    Para mais informações, consulte Configurar o preenchimento automático.

  5. Acesse a guia Avançado para configurar os recursos avançados.

    Para mais informações, consulte Sobre os recursos avançados.

Implantar um app de pesquisa

  1. Na página Apps, clique no nome do app que você quer implantar.

  2. No menu de navegação, clique em Integração.

  3. Verifique se a guia Widget está selecionada.

  4. Selecione Com base no JWT ou OAuth como o tipo de autorização do widget.

  5. No campo Domínio, digite o nome do domínio da página da Web em que você colocará o widget. Por exemplo, se você for copiar o widget para a página da Web example.com/ai.html, digite example.com como o domínio.

  6. Clique em Adicionar e, depois, clique em Salvar.

  7. Copie o snippet de código fornecido na seção Copie o código a seguir para seu aplicativo da Web.

  8. Na sua base de código, gere um token de autorização.

  9. Para passar o token de autorização ao seu widget, use o snippet de código "Definir token de autorização" fornecido na seção Copiar o código a seguir no seu aplicativo da Web e substitua o texto<JWT or OAuth token provided by your backend> pelo token de autorização.

  10. Teste o aplicativo implantado. Para ajustar ainda mais a configuração, siga as etapas em "Configurar o widget de pesquisa". Clique em Salvar e publicar para que as mudanças entrem em vigor no widget implantado.

Limpar

Para evitar cobranças na conta do Google Cloud pelos recursos usados nesta página, siga estas etapas.

  1. Para evitar cobranças desnecessárias do Google Cloud, use o console do Google Cloud para excluir o projeto se ele não for necessário.
  2. Se você criou um novo projeto para saber mais sobre instâncias do Vertex AI Agent Builder e não precisa mais do projeto, exclua-o.
  3. Se você usou um projeto do Google Cloud, exclua os recursos criados para evitar cobranças na sua conta. Para mais informações, consulte Excluir um app.
  4. Siga as etapas em Desativar o Vertex AI Agent Builder.

A seguir