Migre da API Custom Search Site Restricted JSON

Se usar a API Custom Search Site Restricted JSON do Motor de Pesquisa Programável, pode criar e implementar uma pesquisa restrita a um site com a qualidade da Google em minutos, usando o Vertex AI Search. Para implementar a sua app, pode usar o widget de pesquisa copiando o código da Google Cloud consola diretamente para uma página Web. Não é necessária programação. Em alternativa, pode implementar uma implementação de API para ter controlo sobre o aspeto da funcionalidade de pesquisa no seu Website. Para mais informações sobre a utilização da API, consulte o separador REST de Obtenha resultados da pesquisa para uma app com dados do Website e o método servingConfigs.search na referência REST.

Além dos fragmentos curtos padrão que o Vertex AI Search devolve com os resultados da pesquisa, pode adicionar funcionalidades avançadas à sua pesquisa. Estas incluem resumos gerados dos resultados da pesquisa, pesquisa com seguimentos para uma pesquisa sensível ao contexto que permite perguntas de seguimento e respostas extrativas para texto extraído devolvido com cada resultado da pesquisa. A obtenção destas funcionalidades avançadas para a sua pesquisa Web requer a validação de domínio e implica custos de indexação adicionais.

Também pode filtrar ou ordenar os resultados da pesquisa e aplicar controlos de promoção para apresentar um link como resultado promovido.

Para mais informações, consulte a página Preços das aplicações de IA.

Configure o Vertex AI Search

Para configurar a Pesquisa da Vertex AI, siga estes passos:

  1. Na Google Cloud consola, na página do seletor de projetos, selecione o projeto que tem usado para a API Custom Search Site Restricted JSON.

  2. Ative as aplicações de IA.

Crie uma app de pesquisa

Para criar uma app de pesquisa, siga estes passos:

  1. Na Google Cloud consola, aceda à página Aplicações de IA.

    Aplicações de IA

  2. Clique em Criar app.

  3. Na página Criar app, em Pesquisa no site com o modo de IA, clique em Criar.

  4. Certifique-se de que a opção Funcionalidades da edição Enterprise está ativada. Isto é necessário para a pesquisa no Website. Para mais informações, consulte as funcionalidades da edição Enterprise.

  5. Desative as funcionalidades avançadas de MDIs. Se desativar esta opção, tem uma funcionalidade semelhante à da API Custom Search Site Restricted JSON do Motor de pesquisa programável. Desative esta opção se não precisar do resumo da pesquisa nem da pesquisa com seguimentos. Para mais informações, consulte o artigo Funcionalidades avançadas do MDG.

  6. No campo Nome da sua app, introduza um nome para a app.

  7. No campo Nome externo da sua empresa ou organização, introduza o nome comum da sua empresa ou organização.

  8. Selecione global (Global) como a localização da sua app e, de seguida, clique em Continuar.

  9. Na página Armazenamentos de dados, clique em Criar armazenamento de dados.

  10. No painel Selecione uma origem de dados, selecione Conteúdo do Website.

  11. Desative a indexação Indexação avançada de Websites. Se desativar esta opção, tem acesso a funcionalidades semelhantes às da API Custom Search Site Restricted JSON do Motor de Pesquisa Programável. Desative esta opção se não precisar do resumo da pesquisa nem da pesquisa com seguimentos ou se não for proprietário dos domínios que especificar. Para mais informações, consulte o artigo Indexação avançada de Websites.

  12. No painel Especifique padrões de URL para indexar, no campo Sites a incluir, introduza os padrões de URL dos Websites que quer pesquisar e, de seguida, clique em Continuar.

  13. No painel Configure o seu repositório de dados, introduza um nome a apresentar para o seu repositório de dados e, de seguida, clique em Criar.

  14. Na página Armazenamentos de dados, selecione o novo armazenamento de dados e, de seguida, clique em Criar.

Implemente a app de pesquisa

Decida como planeia autenticar a sua app de pesquisa do Vertex AI Search: através do OAuth 2.0 ou de uma chave da API. Para ver informações sobre as vantagens e as desvantagens de cada método, consulte o artigo Acerca da autenticação.

Implemente a app de pesquisa (OAuth 2.0)

Para implementar a sua app de pesquisa através da autenticação OAuth 2.0, siga estes passos:

  1. Para configurar o OAuth 2.0, consulte a secção Na Google Cloud em Autenticar em aplicações de IA. Certifique-se de que adiciona a função Utilizador do Discovery Engine ou Visualizador do Discovery Engine à conta de serviço.

  2. Implemente a sua app de pesquisa de uma das seguintes formas:

Implemente a app de pesquisa (chave da API)

Para implementar a sua app de pesquisa através de uma chave da API para autenticação, siga estes passos:

  1. Crie a chave da API:

    1. Na Google Cloud consola, aceda à página Credenciais.

      Credenciais

    2. Se ainda não estiver no seu projeto, na lista de projetos na parte superior da página da Google Cloud consola, selecione o seu projeto.

    3. Clique em Criar credenciais e, de seguida, selecione Chave de API. Não adicione restrições de referenciadores. Algumas definições de privacidade do utilizador não transmitem o URL de referência.

      • Tome nota da chave da API gerada, que vai usar quando chamar o método searchLite.

    4. Para aumentar a segurança, adicione uma restrição HTTP à sua chave da API para restringir o acesso ao serviço de aplicações de IA em https://discoveryengine.googleapis.com/*.

  2. Implemente a sua app de pesquisa através da API. Consulte o artigo Obtenha resultados da pesquisa para uma app com dados do Website (chave da API) e o método servingConfigs.searchLite na referência REST. Para ordenar os resultados das suas consultas de pesquisa na Web, consulte o artigo Ordenar resultados da pesquisa na Web.

Acerca da autenticação

A API Custom Search Site Restricted JSON do Motor de Pesquisa Programável autentica-se através de uma chave API. No entanto, com algumas exceções, o Vertex AI Search requer o OAuth 2.0. Se quiser continuar a usar uma chave da API para autenticação, tem de usar o método searchLite através de chamadas API.

Se optar por autenticar através do OAuth 2.0, tem de usar o método search e o método answer para consultar o seu Website. Além disso, pode implementar a sua app de pesquisa através do widget de pesquisa sem código.

A tabela seguinte apresenta as diferenças entre a utilização do método searchLite com a autenticação por chave de API e os métodos search e answer com a autenticação OAuth 2.0.

Funcionalidade/métodos searchLite método search método
Autenticação Chave da API OAuth 2.0
Widget de pesquisa disponível ✘ ✔
Resumos de pesquisa ✔ ✔
Pesquise Websites públicos ✔ ✔

Passos seguintes