Esta página mostra como visualizar os resultados da pesquisa de apps de mídia usando o Google Cloud console e como receber resultados da pesquisa usando a API.
Para implementar o app de pesquisa, você pode criar um widget de pesquisa para adicionar à página da Web ou fazer chamadas de API e integrar essas chamadas à página da Web ou ao aplicativo.
Sobre os modos de pesquisa
Há vários modos de consulta de pesquisa para apps de mídia:
Consultas completas: quando os usuários finais querem que todo o termo ou frase de pesquisa seja pesquisado. Por exemplo, em um app de streaming de música, os usuários digitam o título completo da música e a pesquisam de uma só vez. Essa é uma maneira preferencial de pesquisar ao usar uma interface de entrada que permite que os usuários pesquisem de uma só vez, como entrada de áudio ou de teclado.
Em consultas completas, se a entrada incluir um erro de ortografia, os usuários esperam que esse erro seja corrigido.
Esse é o mesmo comportamento da pesquisa de apps que não são de mídia (personalizados). Consulte Receber resultados da pesquisa de um app com dados estruturados ou não estruturados dados.
Consultas parciais (ou de pesquisa conforme você digita): quando os usuários finais recebem dinamicamente um novo conjunto de resultados da pesquisa à medida que digitam cada letra. Por exemplo, em um app de streaming de música, os usuários começam a inserir o nome da música que estão procurando e, a cada letra digitada, os resultados da pesquisa são atualizados e refinados dinamicamente.
Modo automático: o modo automático é uma combinação de modos completos e parciais. Com o modo automático, você permite que a pesquisa de mídia decida se vai retornar resultados de consulta parciais ou completos.
Para determinar a intenção provável dos usuários finais, a pesquisa de mídia analisa e pondera vários indicadores, como o número de letras inseridas, a velocidade de entrada e se a entrada é uma entidade reconhecida, por exemplo, o nome de um ator ou filme.
Qual modo usar
O modo padrão para consultas de pesquisa de mídia é o automático. No entanto, há cenários em que você pode substituir o modo padrão e especificar o modo de consulta completo ou parcial. Confira alguns exemplos de casos de uso:
| Cenário | Modo |
|---|---|
| Você tem muita confiança de que as consultas dos usuários finais são completas consultas. Por exemplo, você tem uma caixa de pesquisa que inclui uma função "Enter" para marcar a consulta como concluída, e o usuário pressiona "Enter". | Consultas completas |
| Você tem muita confiança de que as consultas dos usuários finais são parciaas parciais, ou seja, eles esperam que a lista de resultados seja atualizada após cada letra inserida. | Consultas parciais |
| Nenhum dos cenários acima se aplica. Permita que a pesquisa de mídia decida se vai retornar resultados de consulta parciais ou completos. | Automático |
Receber resultados da pesquisa de um app de mídia
Você pode visualizar os resultados da pesquisa no Google Cloud console ou receber resultados da pesquisa usando a API. Para receber resultados da pesquisa de um app de mídia:
Console
Para usar o Google Cloud console para visualizar a pesquisa de mídia e configurar um widget:
No Google Cloud console, acesse a página Aplicativos de IA.
Clique no nome do app de pesquisa de mídia.
Clique em Configurations.
Clique na guia interface.
Na guia interface, defina as opções Configurações gerais e Exibição de dados.
No painel Visualização, comece a digitar uma consulta.
Para salvar as configurações e disponibilizá-las na guia Integração, clique em Salvar e publicar.
REST
Use o método engines.servingConfigs.search para
receber resultados da pesquisa de um app de mídia:
Encontre o ID do app. Se você já tiver o ID do app, pule para a próxima etapa.
No Google Cloud console, acesse a página Aplicativos de IA.
Na página Apps, encontre o nome do seu app e receba o ID dele na coluna ID.
Execute o seguinte comando curl para receber resultados de pesquisa conforme você digita.
Todos os campos, exceto
contentSearchSpec, podem ser usados em conjunto com o camposearchAsYouTypeSpec. Para fins de esclarecimento, os campos opcionais foram omitidos do comando curl. Para os campos opcionais, consulte Receber resultados da pesquisa de um app com dados estruturados ou não estruturados dados.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:
PROJECT_ID: o ID do Google Cloud projeto.PROJECT_ID: o ID do Google Cloud projeto.APP_ID: o ID do app Pesquisa do agente que você quer consultar.QUERY: o texto da consulta a ser pesquisado.SPEC_CONDITION: a especificação de pesquisa conforme você digita pode ter um dos seguintes valores:ENABLED: para consultas parciaisDISABLED: para consultas completasAUTO: para parcial ou completo, conforme considerado apropriado. Se você deixar o campoSPEC_CONDITIONvazio ou não especificar, o modo de pesquisa padrão seráAUTO.
Exemplo de comando 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": {} }