CLI de operações do Blueprint

Este guia aborda as operações do Blueprint disponíveis por meio da AWS Command Line Interface (CLI) Amazon Bedrock para automação de dados (BDA).

Criação de plantas

Os blueprints definem a estrutura e as propriedades dos dados que você deseja extrair de seus documentos, imagens, arquivos de áudio ou vídeo. Use o comando create-blueprint para definir um novo Blueprint.

O comando a seguir cria um novo Blueprint personalizado para extrair dados de uma imagem de passaporte.

Sintaxe

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

Referência completa de parâmetros

A tabela a seguir mostra todos os parâmetros disponíveis para o create-blueprint comando:

Parâmetros para create-blueprint

Parameter	Obrigatório	Padrão	Descrição
--blueprint-name	Sim	N/D	Nome do Blueprint
--type	Sim	N/D	Tipo de conteúdo (IMAGEM, DOCUMENTO, ÁUDIO, VÍDEO)
--blueprint-stage	Não	AO VIVO	Etapa do Blueprint (DESENVOLVIMENTO ou AO VIVO)
--schema	Sim	N/D	Esquema JSON definindo a estrutura do Blueprint
--client-token	Não	Gerado automaticamente	Identificador exclusivo para idempotência da solicitação

Visualizando as configurações do Blueprint

Listar todos os projetos

Use o comando list-blueprints para recuperar uma lista de todos os Blueprints associados à sua conta.

Sintaxe

aws bedrock-data-automation list-blueprints

Exibir detalhes do Blueprint

Para ver informações detalhadas sobre um Blueprint específico, incluindo seu esquema e configuração, use o comando get-blueprint.

Sintaxe

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

Inspecione a versão específica

Ao trabalhar com Blueprints versionados, use o comando get-blueprint com a opção --blueprint-version para visualizar uma versão específica.

Sintaxe

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

Inspecione o estágio específico

Para visualizar os Blueprints no estágio DEVELOPMENT ou LIVE, use:

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

Editando especificações do Blueprint

Atualizar configurações do Blueprint

Para modificar o esquema ou as propriedades de um Blueprint existente, use o comando update-blueprint.

Sintaxe

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

Observação: ao atualizar um Blueprint, você deve fornecer o esquema completo, mesmo para campos que não estão sendo alterados.

Promova para LIVE

Para mover um blueprint do estágio DEVELOPMENT para o estágio LIVE para produção, use o comando update-blueprint com a opção --blueprint-stage.

Sintaxe

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

Controle de versão do Blueprint

Crie uma nova versão do seu Blueprint para preservar seu estado atual antes de fazer alterações significativas usando o create-blueprint-version comando.

Sintaxe

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

Gerenciando tags do Blueprint

As tags ajudam os usuários a organizar e categorizar os Blueprints para simplificar o gerenciamento.

Adicionar tags

Aplique metadados ao seu Blueprint adicionando tags.

Sintaxe

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

Remover etiquetas

Remova tags específicas do seu Blueprint com o comando untag-resource.

Sintaxe

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

Exibir tags

Liste todas as tags associadas ao seu Blueprint usando o list-tags-for-resource comando.

Sintaxe

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

Excluindo blueprints

Excluir um blueprint inteiro

Use o comando delete-blueprint para remover permanentemente um Blueprint e todas as suas versões.

Sintaxe

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

Cuidado: Esse comando exclui permanentemente um Blueprint e não pode recuperá-lo.

Importante: você não pode excluir um Blueprint que esteja sendo usado atualmente por nenhum projeto. Antes de excluir, certifique-se de que o Blueprint não seja referenciado na configuração de saída personalizada de nenhum projeto.