Obtenha resultados da pesquisa para apps de multimédia

Esta página mostra como pré-visualizar os resultados da pesquisa para apps de multimédia através da consola e como obter resultados da pesquisa através da API.Google Cloud

Para implementar a app de pesquisa, pode criar um widget de pesquisa para adicionar à sua página Web ou pode fazer chamadas de API e integrar essas chamadas na sua página Web ou aplicação.

Acerca dos modos de pesquisa

Existem vários modos de consulta de pesquisa para apps de multimédia:

  • Consultas completas: quando os utilizadores finais pretendem que todo o termo ou frase de pesquisa seja pesquisado. Por exemplo, numa app de streaming de música, os utilizadores escrevem o título completo da música e pesquisam-na de uma só vez. Esta é uma forma preferencial de pesquisar quando se usa uma interface de entrada que permite aos utilizadores pesquisar de uma só vez, como a entrada de áudio ou a entrada de teclado.

    Nas consultas completas, se a entrada incluir um erro ortográfico, os utilizadores esperam que o erro seja corrigido.

    Este é o mesmo comportamento que a pesquisa de apps que não sejam de multimédia (personalizadas). Consulte o artigo Obtenha resultados da pesquisa para uma app com dados estruturados ou não estruturados.

  • Consultas parciais (ou de pesquisa à medida que escreve): quando os utilizadores finais recebem dinamicamente um novo conjunto de resultados da pesquisa à medida que escrevem cada letra. Por exemplo, numa app de streaming de música, os utilizadores começam a introduzir o nome da música que estão a pesquisar e, com cada letra que escrevem, os resultados da pesquisa são atualizados dinamicamente e restringidos.

  • Modo automático: o modo automático é uma combinação dos modos completo e parcial. Com o modo automático, permite que a pesquisa de multimédia decida se deve devolver resultados da consulta como parciais ou completos.

    Para determinar a provável intenção dos utilizadores finais, a pesquisa de multimédia analisa e pondera vários sinais, como o número de letras introduzidas, a velocidade de introdução e se a entrada é uma entidade reconhecida, por exemplo, o nome de um ator ou um filme.

Que modo usar

O modo predefinido para consultas de pesquisa de multimédia é o modo automático. No entanto, existem cenários em que pode optar por substituir o modo predefinido e especificar o modo de consulta completo ou parcial. Seguem-se alguns exemplos de utilização:

Cenário Modo
Tem muita confiança de que as consultas dos seus utilizadores finais são consultas completas. Por exemplo, tem uma caixa de pesquisa que inclui uma função Enter para marcar a consulta como concluída e o utilizador prime Enter. Consultas completas
Tem muita confiança de que as consultas dos seus utilizadores finais se destinam a ser consultas parciais, ou seja, esperam que a lista de resultados seja atualizada após cada letra introduzida. Consultas parciais
Nenhum dos cenários acima se aplica. Permitir que a pesquisa de multimédia decida se deve devolver resultados da consulta como parciais ou completos. Automático

Pode pré-visualizar os resultados da pesquisa a partir da Google Cloud consola ou obter resultados da pesquisa através da API. Para obter resultados da pesquisa de uma app de multimédia:

Consola

Para usar a Google Cloud consola para pré-visualizar a pesquisa de multimédia e configurar um widget:

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

    Aplicações de IA

  2. Clique no nome da app de pesquisa de multimédia.

  3. Clique em Configurações.

  4. Clique no separador IU.

  5. No separador IU, defina as Configurações gerais e as opções de Apresentação de dados.

  6. No painel Pré-visualização, comece a escrever uma consulta.

  7. Para guardar as configurações e disponibilizá-las no separador Integração, clique em Guardar e publicar.

REST

Use o método engines.servingConfigs.search para obter resultados de pesquisa para uma app de multimédia:

  1. Encontre o ID da app. Se já tiver o ID da app, avance para o passo seguinte.

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

      Aceda a Apps

    2. Na página Apps, encontre o nome da sua app e obtenha o ID da app na coluna ID.

  2. Execute o seguinte comando curl para obter resultados de pesquisa instantânea.

    Todos os campos, exceto contentSearchSpec, podem ser usados em conjunto com o campo searchAsYouTypeSpec. Para maior clareza, os campos opcionais foram omitidos do comando curl. Para os campos opcionais, consulte o artigo Obtenha resultados da pesquisa para uma app com dados estruturados ou não estruturados.

    curl -X POST -H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json" \
"https://discoveryengine.googleapis.com/v1/projects/PROJECT_ID/locations/global/collections/default_collection/engines/APP_ID/servingConfigs/default_search:search" \
-d '{
"query": "QUERY",
"searchAsYouTypeSpec": {"condition": "SPEC_CONDITION"}
}'

    Substitua o seguinte:

    • PROJECT_ID: o ID do seu projeto Google Cloud .
    • PROJECT_ID: o ID do seu projeto Google Cloud .
    • APP_ID: o ID da app Vertex AI Search que quer consultar.
    • QUERY: o texto da consulta a pesquisar.

    • SPEC_CONDITION: a especificação de pesquisa à medida que escreve pode ter um dos seguintes valores:

      • ENABLED: para consultas parciais
      • DISABLED: para consultas completas
      • AUTO: para reembolsos parciais ou totais, conforme considerado adequado. Se deixar o campo SPEC_CONDITION vazio ou não o especificar, o modo de pesquisa predefinido é AUTO.

    Comando de exemplo e resultado parcial

    curl -X POST -H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json" \
"https://discoveryengine.googleapis.com/v1/projects/my-project-123/locations/global/collections/default_collection/engines/my-app/servingConfigs/default_search:search" \
-d '{
"query": "Mission Impossible",
"searchAsYouTypeSpec": {"condition": "DISABLED"}
}'

    
{
  "results": [
    {
      "id": "189333",
      "document": {
      "name": "projects/123456/locations/global/collections/default_collection/dataStores/my-data-store/branches/0/documents/189333",
        "id": "189333",
        "structData": {
          "uri": "http://mytestdomain.movie/content/189333",
          "title": "Mission: Impossible - Fallout (2018)",
          "categories": [
            "Action",
            "Adventure",
            "Thriller"
          ],
          "available_time": "2023-01-01T00:00:00Z",
          "media_type": "movie",
          "expire_time": "2033-01-01T00:00:00Z"
        }
      }
    },
    {
      "id": "111781",
      "document": {
      "name": "projects/123456/locations/global/collections/default_collection/dataStores/my-data-store/branches/0/documents/111781",
        "id": "111781",
        "structData": {
          "media_type": "movie",
          "available_time": "2023-01-01T00:00:00Z",
          "uri": "http://mytestdomain.movie/content/111781",
          "title": "Mission: Impossible - Rogue Nation (2015)",
          "categories": [
            "Action",
            "Adventure",
            "Thriller"
          ],
          "expire_time": "2033-01-01T00:00:00Z"
        }
      }
    },
    ...
    {
      "id": "116507",
      "document": {
      "name": "projects/123456/locations/global/collections/default_collection/dataStores/my-data-store/branches/0/documents/116507",
        "id": "116507",
        "structData": {
          "uri": "http://mytestdomain.movie/content/116507",
          "categories": [
            "Comedy"
          ],
          "media_type": "movie",
          "available_time": "2023-01-01T00:00:00Z",
          "title": "Mission London (2010)",
          "expire_time": "2033-01-01T00:00:00Z"
        }
      }
    }
  ],
  "totalSize": 5628,
  "attributionToken": "vgL0PQEKDAiZxMbCBhD2koiqAxIkNjg1MWM3OTUtMDAwMC0yOWVmLThhNzUtZDQzYTJjYzdiYmNmIgVNRURJQSpUtreMLa_WoTGs1qExwvCeFaOAlyKrtZwxxcvzF-7r6TGotZwxkPeyMI6RyTDPv-Iw1L_iMJvWty2Ovp0V1LKdFfHr6THs4K8tkvGsMJXxrDCY1rctMAFKEjB4OTYzYjdjNGE0ZGYwN2FhZlKUAXByb2plY3RzLzc1NjIwNjYwODQ3OS9sb2NhdGlvbnMvZ2xvYmFsL2NvbGxlY3Rpb25zL2RlZmF1bHRfY29sbGVjdGlvbi9lbmdpbmVzL3F1aWNrc3RhcnQtbWVkaWEtcmVjb21tZW5kXzE3NDUwMjUyMjYwNDMvc2VydmluZ0NvbmZpZ3MvZGVmYXVsdF9zZWFyY2g",
  "nextPageToken": "Y2YiJ2NjNmMhNDNk1SN3EGOtYWZ5ITLwADMw0CN5czYxUDO2QiGDI9kgzIEGIs1tmJCMIBM1IgC",
  "summary": {},
  "queryExpansionInfo": {}
}

Passos seguintes