As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

CLI de operações do esquema

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).

Criar esquemas

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

O comando a seguir cria um esquema 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 de parâmetro completa

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

Visualizar configurações do esquema

Listar todos os esquemas

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

Sintaxe

aws bedrock-data-automation list-blueprints

Visualizar detalhes do esquema

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

Sintaxe

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

Inspecionar uma versão específica

Ao trabalhar com esquemas 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"

Inspecionar um estágio específico

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

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

Editar especificações do esquema

Atualizar configurações do esquema

Para modificar o esquema ou as propriedades de um esquema 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 esquema, você deve fornecer o esquema completo, mesmo para campos que não estão sendo alterados.

Promover para LIVE

Para mover um esquema 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"

Controlar a versão do esquema

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

Gerenciar as tags do esquema

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

Adicionar tags

Aplique metadados ao esquema 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 esquema 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)"

Excluir esquemas

Excluir um esquema inteiro

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

Sintaxe

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

Cuidado: esse comando exclui permanentemente um esquema e não é possível recuperá-lo.

Importante: não é possível excluir um esquema que esteja sendo usado no momento por algum projeto. Antes de excluir, verifique se não há referência ao esquema na configuração de saída personalizada de algum projeto.

Otimização do blueprint

Invocando a otimização do Blueprint

Inicie um trabalho assíncrono de otimização do blueprint para melhorar as instruções do blueprint de cada um dos campos do blueprint e a precisão dos resultados.

Sintaxe

aws bedrock-data-automation invoke-blueprint-optimization-async \
    --blueprint blueprintArn="arn:aws:bedrock:<region>:<account_id>:blueprint/<blueprint_id>",stage="DEVELOPMENT" \
    --samples '[
        {
            "assetS3Object": {
                "s3Uri": "s3://my-optimization-bucket/samples/document1.pdf"
            },
            "groundTruthS3Object": {
                "s3Uri": "s3://my-optimization-bucket/ground-truth/document1-expected.json"
            }
        }
    ]' \
    --output-configuration s3Object='{s3Uri="s3://my-optimization-bucket/results/optimization-output"}' \
    --data-automation-profile-arn "Amazon Resource Name (ARN):data-automation-profile/default"

Verificando o status de otimização do Blueprint

Monitore o progresso e os resultados de um trabalho de otimização do plano.

Sintaxe

aws bedrock-data-automation get-blueprint-optimization-status \
    --invocation-arn "arn:aws:bedrock:<region>:<account_id>:blueprint-optimization-invocation/opt-12345abcdef"

Use esse comando para rastrear o status do trabalho de otimização. A resposta inclui o status atual (Criado InProgress ServiceError, Sucesso ou ClientError) e os detalhes da configuração de saída quando concluída.

Copiando estágios do Blueprint

Copiar um blueprint de um estágio para outro

Sintaxe

aws bedrock-data-automation copy-blueprint-stage \
    --blueprint-arn "arn:aws:bedrock:<region>:<account_id>:blueprint/<blueprint_id>" \
    --source-stage "DEVELOPMENT" \
    --target-stage "LIVE"

Cuidado: esse comando copia toda a configuração do Blueprint do estágio de origem para o estágio de destino, substituindo qualquer configuração existente no estágio de destino.

Importante: Certifique-se de que o Blueprint seja completamente testado no estágio de origem antes de copiar para o estágio de produção (AO VIVO). Essa operação não pode ser desfeita com facilidade.