Pesquisar dados do Armazenamento de vídeos em lote

Pré-requisito: crie um Batch Video Warehouse com um índice implantado.

Pesquisar dados do Video Warehouse em lote no console

Console

  1. Abra a guia Armazéns do painel do Vision da plataforma de agentes do Gemini Enterprise.

    Acesse a guia "Armazéns".

  2. Encontre o endpoint do índice que você quer pesquisar e clique em Pesquisar recursos.

  3. Uma lista de vídeos (cada um correspondendo a um recurso) e uma barra de pesquisa vão aparecer na parte de cima. Clique em um vídeo para assistir ou comece a pesquisar.

  4. Para começar a pesquisar, digite uma consulta de texto ou faça upload de uma imagem como consulta de pesquisa. Uma lista de videoclipes vai aparecer no lado direito da página de resultados da pesquisa. Cada um deles corresponde a um videoclipe contínuo nos recursos. Os clipes de vídeo são classificados por relevância para a consulta de entrada.

  5. Use a seção Filters no lado esquerdo da página de resultados da pesquisa para refinar sua busca. Cada critério de filtro consiste em uma chave de esquema de dados e o valor de anotação que você quer pesquisar. Depois de especificar os critérios de filtro, clique em Pesquisar para executar a pesquisa.

Pesquisar dados do Video Warehouse em lote usando a linha de comando

Para pesquisar os vídeos (assets) no seu corpus (corpus), preencha o corpo da solicitação searchIndexEndpoint com o conteúdo que você quer encontrar. Esse conteúdo pode ter vários formatos:

  1. text_query ou image_query: consulta para pesquisar.
  2. Opcional criteria: critérios de filtro em anotações fornecidas pelo usuário.

No exemplo a seguir, considere um corpus que contém vídeos de paisagens naturais. Para recuperar todos os recursos relevantes para "pôr do sol na praia" e marcados com a anotação "state": "California", envie a seguinte solicitação:

REST e LINHA DE CMD

Antes de usar os dados da solicitação abaixo, faça as substituições a seguir:

  • REGIONALIZED_ENDPOINT: o endpoint pode incluir um prefixo correspondente ao LOCATION_ID, como europe-west4-. Saiba mais sobre os endpoints regionalizados.
  • PROJECT_NUMBER: o número do projeto do Google Cloud.
  • LOCATION_ID: a região em que você está usando o Agent Platform Vision. Por exemplo: us-central1, europe-west4. Consulte as regiões disponíveis.
  • INDEX_ENDPOINT_ID: o ID do endpoint do índice de destino.

Método HTTP e URL: 

POST https://warehouse-visionai.googleapis.com/v1/projects/PROJECT_NUMBER/locations/LOCATION_ID/indexEndpoints/INDEX_ENDPOINT_ID:searchIndexEndpoint

Corpo JSON da solicitação:

{
  "text_query": "sunset at beach",
  "criteria": [
    {
      "field": "state",
      "text_array": {
          "txt_values": [
            "California"
          ]
      }
    }
  ]
}

Para enviar a solicitação, escolha uma destas opções:

curl

Salve o corpo da solicitação em um arquivo com o nome request.json e execute o comando abaixo: 

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://warehouse-visionai.googleapis.com/v1/projects/PROJECT_NUMBER/locations/LOCATION_ID/indexEndpoints/INDEX_ENDPOINT_ID:searchIndexEndpoint"

PowerShell

Salve o corpo da solicitação em um arquivo com o nome request.json e execute o comando abaixo: 

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method POST `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://warehouse-visionai.googleapis.com/v1/projects/PROJECT_NUMBER/locations/LOCATION_ID/indexEndpoints/INDEX_ENDPOINT_ID:searchIndexEndpoint" | Select-Object -Expand Content

Você receberá uma resposta JSON semelhante a esta:

{
  "searchResultItems": [
    {
      "asset": "projects/PROJECT_NUMBER/locations/LOCATION_ID/corpora/CORPUS_ID/assets/ASSET_ID_1"
    },
    {
      "asset": "projects/PROJECT_NUMBER/locations/LOCATION_ID/corpora/CORPUS_ID/assets/ASSET_ID_2"
    }
  ]
}

Se você tiver uma imagem de um pôr do sol em uma praia, também poderá usá-la como uma consulta de pesquisa enviando a seguinte solicitação (a imagem de entrada está no formato de codificação base64):

REST e LINHA DE CMD

Antes de usar os dados da solicitação abaixo, faça as substituições a seguir:

  • REGIONALIZED_ENDPOINT: o endpoint pode incluir um prefixo correspondente ao LOCATION_ID, como europe-west4-. Saiba mais sobre os endpoints regionalizados.
  • PROJECT_NUMBER: o número do projeto do Google Cloud.
  • LOCATION_ID: a região em que você está usando o Agent Platform Vision. Por exemplo: us-central1, europe-west4. Consulte as regiões disponíveis.
  • INDEX_ENDPOINT_ID: o ID do endpoint do índice de destino.

Método HTTP e URL: 

POST https://warehouse-visionai.googleapis.com/v1/projects/PROJECT_NUMBER/locations/LOCATION_ID/indexEndpoints/INDEX_ENDPOINT_ID:searchIndexEndpoint

Corpo JSON da solicitação:

{
  "image_query": {
    "input_image": "IMAGE_BYTES"
  },
  "criteria": [
    {
      "field": "state",
      "text_array": {
          "txt_values": [
            "California"
          ]
      }
    }
  ]
}

Para enviar a solicitação, escolha uma destas opções:

curl

Salve o corpo da solicitação em um arquivo com o nome request.json e execute o comando abaixo: 

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://warehouse-visionai.googleapis.com/v1/projects/PROJECT_NUMBER/locations/LOCATION_ID/indexEndpoints/INDEX_ENDPOINT_ID:searchIndexEndpoint"

PowerShell

Salve o corpo da solicitação em um arquivo com o nome request.json e execute o comando abaixo: 

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method POST `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://warehouse-visionai.googleapis.com/v1/projects/PROJECT_NUMBER/locations/LOCATION_ID/indexEndpoints/INDEX_ENDPOINT_ID:searchIndexEndpoint" | Select-Object -Expand Content

Você receberá uma resposta JSON semelhante a esta:

{
  "searchResultItems": [
    {
      "asset": "projects/PROJECT_NUMBER/locations/LOCATION_ID/corpora/CORPUS_ID/assets/ASSET_ID_1"
    },
    {
      "asset": "projects/PROJECT_NUMBER/locations/LOCATION_ID/corpora/CORPUS_ID/assets/ASSET_ID_2"
    }
  ]
}