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`:
**Parâmetros de create-blueprint**
| Parâmetro | Obrigatório | Padrão | Description |
| --- | --- | --- | --- |
| --blueprint-name | Sim | N/D | Nome do esquema |
| --type | Sim | N/D | Tipo de conteúdo (IMAGE, DOCUMENT, AUDIO, VIDEO) |
| --blueprint-stage | Não | AO VIVO | Etapa do esquema (DEVELOPMENT ou LIVE) |
| --schema | Sim | N/D | Esquema JSON definindo a estrutura do esquema |
| --client-token | Não | Gerado automaticamente | Identificador exclusivo de idempotência da solicitação |
## 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:::blueprint/",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:::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:::blueprint/" \
--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.