建立及更新串流影片倉儲

Vision Warehouse 是可以新增至應用程式的元件，用於儲存模型輸出內容和串流資料。

建立串流影片倉儲

如要將應用程式圖表的其他元件節點連結至倉庫，請先建立串流影片倉庫。

控制台

  1. 開啟 Gemini Enterprise Agent Platform Vision 資訊主頁的「倉庫」分頁。

    前往「倉庫」分頁

  2. 選取「建立」。

  3. 為倉儲新增名稱，然後選擇倉儲中儲存資產的存留時間 (TTL)。這些值稍後可以修改。

    建立倉庫後，即可將倉庫新增至應用程式圖表。

REST 和指令列

在指定專案下建立新的 corpus 資源，並可選擇指定 corpus 顯示名稱、說明和 TTL。

使用任何要求資料之前，請先修改下列項目的值：

  • REGIONALIZED_ENDPOINT：端點可能包含與 LOCATION_ID 相符的前置字串，例如 europe-west4-。進一步瞭解 地區化端點。
  • PROJECT_NUMBER：您的 Google Cloud 專案編號。
  • LOCATION_ID：您使用 Agent Platform Vision 的區域。例如：us-central1、europe-west4。請參閱可用區域。
  • DISPLAY_NAME：資料倉儲的顯示名稱。
  • WAREHOUSE_DESCRIPTION：倉庫的說明 (corpus)。
  • TIME_TO_LIVE：語料庫中所有資產的存留時間 (TTL)，或特定資產的 TTL。舉例來說，如果語料庫的資產 TTL 為 100 天，請提供 8640000 (秒) 這個值。

HTTP 方法和網址：

POST https://warehouse-visionai.googleapis.com/v1/projects/PROJECT_NUMBER/locations/LOCATION_ID/corpora

JSON 要求內文：

{
  "display_name": "DISPLAY_NAME",
  "description": "WAREHOUSE_DESCRIPTION",
  "type": "STREAM_VIDEO",
  "default_ttl": {
    "seconds": TIME_TO_LIVE
  }
}

如要傳送要求，請選擇以下其中一個選項：

curl

將要求主體儲存在名為 request.json 的檔案中，然後執行下列指令：

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/corpora"

PowerShell

將要求主體儲存在名為 request.json 的檔案中，然後執行下列指令：

$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/corpora" | Select-Object -Expand Content

您應該會收到如下的 JSON 回覆：

{
  "name": "projects/PROJECT_NUMBER/locations/LOCATION_ID/warehouseoperations/OPERATION_ID",
  "metadata": {
    "@type": "type.googleapis.com/google.cloud.visionai.v1.CreateCorpusMetadata"
  },
  "done": true,
  "response": {
    "@type": "type.googleapis.com/google.cloud.visionai.v1.Corpus",
    "name": "projects/PROJECT_NUMBER/locations/LOCATION_ID/corpora/CORPUS_ID",
    "displayName": "DISPLAY_NAME",
    "description": "WAREHOUSE_DESCRIPTION",
    "type": "STREAM_VIDEO",
    "defaultTtl": "TIME_TO_LIVE"
  }
}

更新串流影片倉庫

更新指定專案下的現有語料庫，可選擇更新顯示名稱、說明、預設 TTL，或更新所有可用欄位。

REST 和指令列

更新指定專案下的現有 corpus 資源。這個範例 說明如何更新corpus顯示名稱，但您也可以使用相同的網址格式和更新的要求主體，一次更新說明、存留時間或所有欄位。

使用任何要求資料之前，請先修改下列項目的值：

  • REGIONALIZED_ENDPOINT：端點可能包含與 LOCATION_ID 相符的前置字串，例如 europe-west4-。進一步瞭解 地區化端點。
  • PROJECT_NUMBER：您的 Google Cloud 專案編號。
  • LOCATION_ID：您使用 Agent Platform Vision 的區域。例如：us-central1、europe-west4。請參閱可用區域。
  • CORPUS_ID：目標語料庫的 ID。
  • ?updateMask=fieldToUpdate：可套用 updateMask 的可用欄位之一。在要求主體中指定對應的新欄位值。這個新值會取代現有的欄位值。可用欄位：
    • 顯示名稱：?updateMask=display_name
    • 說明：?updateMask=description
    • 預設存留時間 (TTL)：?updateMask=default_ttl
    • 更新所有欄位：?updateMask=*
  • UPDATED_FIELD_VALUE：指定欄位的新值。在這個範例中，倉庫資源會使用使用者提供的新顯示名稱。

HTTP 方法和網址：

PATCH https://warehouse-visionai.googleapis.com/v1/projects/PROJECT_NUMBER/locations/LOCATION_ID/corpora/CORPUS_ID?update_mask=display_name

JSON 要求內文：

{
  "displayName": "UPDATED_FIELD_VALUE",
  "description": "Original description",
  "defaultTtl": {
    "seconds": "7800"
  }
}

如要傳送要求，請選擇以下其中一個選項：

curl

將要求主體儲存在名為 request.json 的檔案中，然後執行下列指令：

curl -X PATCH \
     -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/corpora/CORPUS_ID?update_mask=display_name"

PowerShell

將要求主體儲存在名為 request.json 的檔案中，然後執行下列指令：

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

Invoke-WebRequest `
    -Method PATCH `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://warehouse-visionai.googleapis.com/v1/projects/PROJECT_NUMBER/locations/LOCATION_ID/corpora/CORPUS_ID?update_mask=display_name" | Select-Object -Expand Content

您應該會收到如下的 JSON 回覆：

{
  "name": "projects/PROJECT_ID/locations/LOCATION_ID/corpora/CORPORA_ID",
  "displayName": "UPDATED_FIELD_VALUE",
  "description": "Original description",
  "defaultTtl": "7800s"
}