创建和更新在线视频仓库

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 显示名称，但您也可以使用相同的网址格式和更新后的请求正文，同时更新说明、TTL 或所有字段。

在使用任何请求数据之前，请先进行以下替换：

  • 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"
}