스트리밍 동영상 창고 만들기 및 업데이트

Vision 웨어하우스는 모델 출력과 스트리밍 데이터를 저장하기 위해 앱에 추가할 수 있는 구성요소입니다.

스트리밍 동영상 웨어하우스 만들기

앱 그래프의 다른 구성요소 노드를 웨어하우스에 연결하려면 먼저 스트리밍 동영상 웨어하우스를 만들어야 합니다.

콘솔

  1. Gemini Enterprise 에이전트 플랫폼 Vision 대시보드의 창고 탭을 엽니다.

    웨어하우스 탭으로 이동

  2. 만들기를 선택합니다.

  3. 웨어하우스 이름을 추가하고 웨어하우스에 저장된 애셋의 TTL (수명) 기간을 선택합니다. 이러한 값은 나중에 수정할 수 있습니다.

    창고를 만든 후 애플리케이션 그래프에 창고를 추가할 수 있습니다.

REST 및 명령줄

corpus 표시 이름, 설명, TTL을 지정하는 옵션을 사용하여 지정된 프로젝트에 새 corpus 리소스를 만듭니다.

요청 데이터를 사용하기 전에 다음을 바꿉니다.

  • 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 메서드 및 URL: 

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 표시 이름을 업데이트하는 방법을 보여주지만 동일한 URL 형식과 업데이트된 요청 본문을 사용하여 설명, 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 메서드 및 URL: 

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