Se você não conhece o Vertex AI Agent Builder, siga o tutorial Começar a usar a Pesquisa da Vertex AI para criar um app de exemplo.
Configurar um projeto do Google Cloud, ativar a Vertex AI Agent Builder e definir o acesso de controle de acesso para seu projeto. É possível usar um projeto do Google Cloud se você já tiver um.
Ações
- Leia a seção Antes de começar e confirme que você concluiu as etapas.
Determine que tipo de dados você vai disponibilizar no app de pesquisa e prepare-o para a importação na Vertex AI para Pesquisa.
Seu repositório de dados pode ser baseado nos seguintes tipos de dados:
- Dados não estruturados. Documentos (como PDFs, arquivos HTML e TXT) ) que são armazenados no Cloud Storage. Como opção, é possível fornecer metadados em um arquivo JSON ou em uma tabela do BigQuery.
- Dados estruturados. Dados fornecidos com um esquema específico. Por exemplo, podem fornecer dados em uma tabela do BigQuery, como arquivos JSON no no Cloud Storage ou em conectores de terceiros, como o Jira.
Ações
Leia as informações sobre os dados com suporte e a relação entre os apps e repositórios de dados em Sobre apps e dados .
Prepare seus dados de acordo com os requisitos em Preparar dados para ingestão de dados.
Se você precisar configurar o controle de acesso para limitar os dados que os usuários podem ver nos resultados do seu app de pesquisa, consulte os pré-requisitos e siga as instruções para o tipo de provedor de identidade e a fonte de dados em Usar o controle de acesso à fonte de dados.
Crie um repositório de dados e importe seus dados para ele ou configure um conector de terceiros como fonte de dados sincronizada.
A forma de importar seus dados depende de onde você está fazendo a importação. Por exemplo, se os dados estiverem no Cloud Storage, você poderá importá-los usando o console ou a API, fornecendo o local do bucket dos dados.
Ações
- Siga as instruções para sua origem de dados em Criar um repositório de dados de pesquisa.
Crie seu app de pesquisa genérica e conecte-o ao novo repositório de dados.
Ações
A Vertex AI para Pesquisa oferece muitas opções de configuração. Algumas opções dependem se você planeja implantar um widget de pesquisa.
Ações
Dependendo do seu caso de uso e se você planeja implantar a solução pronta para uso widget de pesquisa ou integrar chamadas de API de pesquisa em seu próprio código, A Vertex AI para Pesquisa oferece várias opções de configuração.
Você pode incorporar um widget de pesquisa ao seu site. O widget automaticamente fornece uma barra de pesquisa e uma interface de pesquisa expansível. Se você planeja implantar widget de pesquisa, configure o seguinte:
Resultados do widget da Pesquisa. Consulte Configurar resultados para o widget de pesquisa.
Facets do widget de pesquisa (pré-lançamento). Consulte Configurar facetas para o widget de pesquisa.
Se você planeja integrar chamadas de API de pesquisa ao seu servidor ou aplicativo em vez de usar o widget, você pode definir suas configurações de pesquisa usando as seguintes opções:
Configurações de campo. Para dados estruturados ou não estruturados com os metadados de pesquisa e atualizar as configurações de campo para refinar a forma como a Vertex AI para Pesquisa usa metadados para pesquisa. Consulte Configurar campos para pesquisa.
Preenchimento automático. Dependendo dos seus dados, configure as sugestões de preenchimento automático com base no conteúdo do documento, nos campos, no histórico de pesquisa ou nos eventos do usuário. Consulte Configurar o preenchimento automático.
Controles de veiculação (visualizar com lista de permissões). Controle quando os resultados da pesquisa são impulsionados, ocultos, filtrados ou redirecionados ou se determinadas consultas são associadas a outras. Consulte Configurar controles de serviço.
Ajuste da pesquisa (pré-lançamento). Ajustar o modelo de pesquisa com seu próprio treinamento dados. Consulte Melhorar os resultados da pesquisa com a pesquisa ajuste.
Embeddings personalizados (pré-lançamento). Se você já criou seus próprios embeddings, você pode preferir usá-los em vez daqueles gerados Vertex AI para Pesquisa para enriquecer suas pesquisas contexto. Esse recurso está disponível para repositórios de dados estruturados ou não estruturados com metadados. Consulte Usar embeddings.
Se você planeja implantar seu app integrando chamadas de API de pesquisa ao seu próprio código, a Vertex AI para Pesquisa oferece outras opções para configurar como os resultados da pesquisa são retornados.
Ações
Configure os resultados da pesquisa com as seguintes opções:
- Filtrar pesquisa genérica por pesquisa estruturada ou e não estruturados.
- Confira snippets, respostas extrativas ou segmentos extrativos. Consulte Adquirir snippets e conteúdo extraído.
É possível visualizar os resultados da pesquisa para verificar se as configurações do app estão o funcionamento esperado.
Ações
Para visualizar os resultados da pesquisa, use o console ou a API.
Console. Use a página Visualização do console do Vertex AI Agent Builder para conferir como as configurações do widget de pesquisa afetam seus resultados. Consulte o Console. instruções em Fazer uma pesquisa resultados.
API. Se você estiver integrando chamadas de API ao seu aplicativo, faça chamadas de API para visualizar as configurações de pesquisa. Consulte as instruções do REST em Pegar resultados da pesquisa.
Quando você estiver satisfeito com a versão de pré-lançamento do seu aplicativo de pesquisa, compartilhe-a com os usuários ao implantá-lo no seu site.
Ações
É possível implantar o app de pesquisa de uma das seguintes maneiras:
Incorpore o widget de pesquisa ao seu site. Vertex AI para Pesquisa fornece um código que pode ser copiado para seu site ou aplicativo da Web. Isso implanta o widget de pesquisa. É possível visualizar os resultados da pesquisa no console. Consulte Adicionar o widget de pesquisa a uma página da Web.
Integrar as chamadas da API Search ao seu servidor ou aplicativo. Para ter controle total sobre como os resultados da pesquisa são exibidos, integre as chamadas de API ao seu servidor ou aplicativos. Para mais informações sobre como fazer chamadas de API, consulte Receber resultados da pesquisa. Para recursos da biblioteca de cliente, consulte Cliente da Vertex AI Agent Builder bibliotecas.
Faça a manutenção do seu app para garantir que os dados mais recentes e necessários estejam disponíveis no seu repositório de dados.