Se você não conhece o Vertex AI Agent Builder, siga o tutorial Começar a usar a pesquisa genérica para criar um app de dados de exemplo do site.
Escolher entre a pesquisa básica e a indexação avançada de sites
O Vertex AI Agent Builder oferece dois tipos de repositórios de dados de sites: pesquisa básica e indexação avançada.
Você pode ativar a indexação avançada de sites para indexar as páginas da Web no repositório de dados de pesquisa. A indexação avançada de sites requer verificação de domínio e oferece vários recursos adicionais em relação à pesquisa básica de sites. Para mais informações, consulte Indexação de sites avançada.
Dependendo do tipo de repositório de dados do site que você precisa para suas necessidades de negócios, selecione uma das seguintes listas de verificação:
Configure um Google Cloud projeto, ative o Vertex AI Agent Builder e configure o controle de acesso para o projeto. Você pode usar um projeto Google Cloud atual, se já tiver um.
Ações
- Revise a página Antes de começar e confirme se você concluiu as etapas.
Entenda como um app de pesquisa de sites (um tipo de app de pesquisa genérica) funciona e os pré-requisitos para incluir sites em um repositório de dados de sites.
Ações
Consulte as informações sobre a relação entre apps genéricos e repositórios de dados em Sobre apps e repositórios de dados e o que constitui dados do site. Quando a indexação avançada de sites estiver ativada para um repositório de dados, você poderá usar esse repositório para pesquisa combinada, em que vários repositórios de dados são conectados a um app.
Prepare os dados do site de acordo com os requisitos em Dados do site.
Crie um repositório de dados informando os padrões de URL do site a serem incluídos e os padrões de URL a serem excluídos. O processo de criação do repositório de dados envolve etapas para ativar a indexação avançada de sites, que exige a verificação de domínio.
Ações
Siga as instruções em Criar um repositório de dados usando URLs de sites.
Se a criação do repositório de dados e a verificação de domínio forem bem-sucedidas, o Vertex AI Agent Builder vai gerar um índice inicial, que será atualizado automaticamente de acordo com o melhor esforço.
O processo de indexação inicial pode levar várias horas.
Opcional: crie um repositório de dados que permita a indexação e atualização somente do sitemap. Para fazer isso, siga as instruções em Ativar a atualização somente do sitemap em um repositório de dados.
Para entender a indexação e atualização com base no sitemap, consulte Indexar e atualizar páginas da Web usando o sitemap.
Crie o app de pesquisa do site e conecte-o ao novo repositório de dados.
Ações
- Crie um app de pesquisa. Ative a edição Enterprise.
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 o widget de pesquisa padrão ou integrar as chamadas da API de pesquisa ao seu próprio código, a Vertex AI para Pesquisa oferece várias opções de configuração.
É possível incorporar um widget de pesquisa no seu site que ofereça automaticamente uma barra de pesquisa e uma interface de pesquisa expansível. Se você planeja implantar o widget de pesquisa, configure o seguinte:
Resultados da pesquisa do widget. Consulte Configurar resultados para o widget de pesquisa.
Facets do widget de pesquisa (pré-lançamento). Consulte Configurar facetas para o widget de pesquisa.
Preenchimento automático. Consulte Atualizar as configurações de preenchimento automático.
Ajuste da pesquisa (pré-lançamento). Consulte Melhorar os resultados da pesquisa com a sintonia.
Se você planeja integrar as chamadas da API de pesquisa ao seu servidor ou aplicativo em vez de usar o widget, configure as configurações de pesquisa usando as seguintes opções:
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. Controle quando os resultados da pesquisa são otimizados, ocultos, filtrados ou redirecionados ou se determinadas consultas são sinônimos de outras. Consulte Configurar controles de veiculação para pesquisa.
Ajuste da pesquisa (pré-lançamento). Ajuste o modelo de pesquisa com seus próprios dados de treinamento. Consulte Melhorar os resultados da pesquisa com a sintonia.
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:
Você pode conferir os resultados da pesquisa para verificar se as configurações do app estão funcionando conforme o esperado.
Ações
Para conferir 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 as instruções do Console em Receber resultados da pesquisa.
API. Se você estiver integrando chamadas de API ao seu aplicativo, poderá fazer chamadas curl para conferir uma prévia das configurações de pesquisa. Consulte as instruções do REST em Pegar resultados da pesquisa.
Enriqueça o índice do repositório de dados usando os dados estruturados adicionados às páginas da Web.
Ações
A adição de dados estruturados às suas páginas da Web é um processo iterativo:
- Modifique os dados estruturados nas páginas da Web. Para mais informações, consulte Usar dados estruturados para a indexação avançada de sites.
- Atualize o esquema do repositório de dados com os atributos de dados estruturados conforme necessário.
- Reconfigure seus resultados da pesquisa. Consulte a etapa 6 desta lista de verificação.
- Visualize os resultados da pesquisa. Consulte a etapa 7 desta lista de verificação.
- Repita esse processo conforme necessário para alcançar o comportamento de pesquisa necessário antes de implantar o app de pesquisa.
Quando estiver satisfeito com a versão de pré-lançamento do app de pesquisa, compartilhe com os usuários implantando-o no seu site.
Ações
É possível implantar o app de pesquisa de duas maneiras:
Incorpore o widget de pesquisa ao seu site. A Vertex AI Search oferece 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 servidor ou aos aplicativos. Para mais informações sobre como fazer chamadas de API, consulte Receber resultados da pesquisa. Para recursos de biblioteca de cliente, consulte Bibliotecas de cliente do Vertex AI Agent Builder.
Você pode manter seu app para garantir que os dados mais recentes e necessários estejam disponíveis no armazenamento de dados.
Ações
- Atualize os dados.
- Opcional: se o repositório de dados tiver indexação e atualização com base em sitemaps, envie os sitemaps ou os índices de sitemap e mantenha-os atualizados. O índice da loja de dados é atualizado automaticamente, e os URLs incluídos são renovados diariamente. Para entender a indexação e atualização com base no sitemap, consulte Indexar e atualizar páginas da Web usando o sitemap.