Esta página foi traduzida pela API Cloud Translation.

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

Obtenha resultados da pesquisa para uma app de multimédia

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:

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

Aplicações de IA
Clique no nome da app de pesquisa de multimédia.
Clique em Configurações.
Clique no separador IU.
No separador IU, defina as Configurações gerais e as opções de Apresentação de dados.
No painel Pré-visualização, comece a escrever uma consulta.
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:

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.

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

Adicione o widget de pesquisa a uma página Web