블루프린트 작업 CLI

이 가이드에서는 Amazon Bedrock 데이터 자동화(BDA)를 위한 AWS 명령줄 인터페이스(CLI)를 통해 사용할 수 있는 블루프린트 작업을 다룹니다.

블루프린트 생성

블루프린트는 문서, 이미지, 오디오 또는 비디오 파일에서 추출하려는 데이터의 구조와 속성을 정의합니다. create-blueprint 명령을 사용하여 새 블루프린트를 정의합니다.

다음 명령은 여권 이미지에서 데이터를 추출하도록 조정된 새 블루프린트를 생성합니다.

구문

aws bedrock-data-automation create-blueprint \
      --blueprint-name "passport-blueprint" \
      --type "IMAGE" \
      --blueprint-stage "DEVELOPMENT" \
      --schema '{
        "class": "Passport",
        "description": "Blueprint for processing passport images",
        "properties": {
          "passport_number": {
            "type": "string",
            "inferenceType": "explicit",
            "instruction": "The passport identification number"
          },
          "full_name": {
            "type": "string",
            "inferenceType": "explicit",
            "instruction": "The full name of the passport holder"
          },
          "expiration_date": {
            "type": "string",
            "inferenceType": "explicit",
            "instruction": "The passport expiration date"
          }
        }
      }'

전체 파라미터 참조

다음 표에는 create-blueprint 명령에 사용할 수 있는 모든 파라미터가 나와 있습니다.

create-blueprint에 대한 파라미터

파라미터	필수	기본값	설명
--blueprint-name	예	N/A	블루프린트의 이름
--type	예	N/A	콘텐츠 유형(IMAGE, DOCUMENT, AUDIO, VIDEO)
--blueprint-stage	아니요	LIVE	블루프린트 단계(개발 또는 라이브)
--schema	예	N/A	블루프린트 구조를 정의하는 JSON 스키마
--client-token	아니요	자동 생성	요청 멱등성을 위한 고유 식별자

블루프린트 구성 보기

모든 블루프린트 나열

list-blueprints 명령을 사용하여 계정에 연결된 모든 블루프린트 목록을 검색합니다.

구문

aws bedrock-data-automation list-blueprints

블루프린트 세부 정보 보기

스키마 및 구성을 포함하여 특정 블루프린트에 대한 자세한 정보를 보려면 get-blueprint 명령을 사용합니다.

구문

aws bedrock-data-automation get-blueprint \
      --blueprint-arn "Amazon Resource Name (ARN)"

특정 버전 검사

버전이 지정된 블루프린트로 작업할 때는 get-blueprint 명령을 --blueprint-version 옵션과 함께 사용하여 특정 버전을 확인합니다.

구문

      aws bedrock-data-automation get-blueprint \
      --blueprint-arn "Amazon Resource Name (ARN)" \
      --blueprint-version "version-number"

특정 단계 검사

개발 또는 라이브 단계에서 블루프린트를 보려면 다음을 사용합니다.

      aws bedrock-data-automation get-blueprint \
      --blueprint-arn "Amazon Resource Name (ARN)" \
      --blueprint-stage "LIVE"

블루프린트 사양 편집

블루프린트 설정 업데이트

기존 블루프린트의 스키마 또는 속성을 수정하려면 update-blueprint 명령을 사용합니다.

구문

aws bedrock-data-automation update-blueprint \
      --blueprint-arn "Amazon Resource Name (ARN)" \
      --schema '{
        "class": "Passport",
        "description": "Updated blueprint for processing passport images",
        "properties": {
          "passport_number": {
            "type": "string",
            "inferenceType": "explicit",
            "instruction": "The passport identification number"
          },
          "full_name": {
            "type": "string",
            "inferenceType": "explicit",
            "instruction": "The full name of the passport holder"
          },
          "expiration_date": {
            "type": "string",
            "inferenceType": "explicit",
            "instruction": "The passport expiration date"
          }
        }
      }'

참고: 블루프린트를 업데이트할 때는 변경하지 않는 필드에도 전체 스키마를 제공해야 합니다.

라이브로 승격

프로덕션을 위해 블루프린트를 개발 단계에서 라이브 단계로 이동하려면 update-blueprint 명령을 --blueprint-stage 옵션과 함께 사용합니다.

구문

aws bedrock-data-automation update-blueprint \
      --blueprint-arn "Amazon Resource Name (ARN)" \
      --blueprint-stage "LIVE"

블루프린트 버전 관리

create-blueprint-version 명령을 사용하여 크게 변경하기 전에 블루프린트의 새 버전을 생성하여 현재 상태를 유지합니다.

구문

aws bedrock-data-automation create-blueprint-version \
      --blueprint-arn "Amazon Resource Name (ARN)"
      

블루프린트 태그 관리

태그는 사용자가 단순화된 관리를 위해 블루프린트를 구성하고 분류하는 데 도움이 됩니다.

태그 추가

태그를 추가하여 블루프린트에 메타데이터를 적용합니다.

구문

aws bedrock-data-automation tag-resource \
      --resource-arn "Amazon Resource Name (ARN)" \
      --tags '{"Department":"Finance","Project":"PassportProcessing"}'

태그 제거

untag-resource 명령을 사용하여 블루프린트에서 특정 태그를 제거합니다.

구문

aws bedrock-data-automation untag-resource \
      --resource-arn "Amazon Resource Name (ARN)" \
      --tag-keys '["Department","Project"]'

태그 보기

list-tags-for-resource 명령을 사용하여 블루프린트와 연결된 모든 태그를 나열합니다.

구문

aws bedrock-data-automation list-tags-for-resource \
      --resource-arn "Amazon Resource Name (ARN)"

블루프린트 삭제

전체 블루프린트 삭제

delete-blueprint 명령을 사용하여 블루프린트와 모든 버전을 영구적으로 제거합니다.

구문

aws bedrock-data-automation delete-blueprint \
          --blueprint-arn "Amazon Resource Name (ARN)"
              

주의:이 명령은 블루프린트를 영구적으로 삭제하고 복구할 수 없습니다.

중요: 현재 프로젝트에서 사용 중인 블루프린트는 삭제할 수 없습니다. 삭제하기 전에 프로젝트의 사용자 지정 출력 구성에서 블루프린트가 참조되지 않았는지 확인합니다.