Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.
# CLI de operaciones con esquemas
En esta guía se describen las operaciones de blueprint disponibles a través de la interfaz de línea de comandos (CLI) de AWS para la automatización de Amazon Bedrock datos (BDA).
## Creación de esquemas
Los esquemas definen la estructura y las propiedades de los datos que desea extraer de sus documentos, imágenes, archivos de audio o vídeo. Utilice el comando create-blueprint para definir un nuevo esquema.
El siguiente comando crea un nuevo esquema adaptado para extraer datos de la imagen de un pasaporte.
**Sintaxis**
```
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"
}
}
}'
```
## Referencia de parámetros completa
El ejemplo de código siguiente muestra todos los parámetros disponibles para el comando `create-blueprint`:
**Parámetros de create-blueprint**
| Parámetro | Obligatorio | Predeterminado | Description (Descripción) |
| --- | --- | --- | --- |
| --blueprint-name | Sí | N/A | Nombre del esquema |
| --type | Sí | N/A | Tipo de contenido (IMAGEN, DOCUMENTO, AUDIO, VÍDEO) |
| --blueprint-stage | No | ACTIVA | Etapa del esquema (EN DESARROLLO o EN DIRECTO) |
| --schema | Sí | N/A | Esquema JSON que define la estructura del esquema |
| --client-token | No | Generado automáticamente | Identificador único para la idempotencia de la solicitud |
## Consulta de las configuraciones de esquemas
**Enumeración de todos los esquemas**
Utilice el comando list-blueprints para recuperar una lista de todos los esquemas asociados a su cuenta.
**Sintaxis**
```
aws bedrock-data-automation list-blueprints
```
**Consulta de los detalles del esquema**
Para ver información detallada sobre un esquema específico, incluidos su estructura y configuración, utilice el comando get-blueprint.
**Sintaxis**
```
aws bedrock-data-automation get-blueprint \
--blueprint-arn "Amazon Resource Name (ARN)"
```
**Inspección de una versión específica**
Cuando trabaje con esquemas con control de versiones, utilice el comando get-blueprint con la opción --blueprint-version para ver una versión concreta.
**Sintaxis**
```
aws bedrock-data-automation get-blueprint \
--blueprint-arn "Amazon Resource Name (ARN)" \
--blueprint-version "version-number"
```
**Inspección de una etapa específica**
Para ver los esquemas en la etapa EN DESARROLLO o EN DIRECTO, utilice:
```
aws bedrock-data-automation get-blueprint \
--blueprint-arn "Amazon Resource Name (ARN)" \
--blueprint-stage "LIVE"
```
## Edición de especificaciones del esquema
**Actualización de la configuración del esquema**
Para modificar la estructura o las propiedades de un esquema existente, utilice el comando update-blueprint.
**Sintaxis**
```
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"
}
}
}'
```
**Nota:** Al actualizar un esquema, debe proporcionar la estructura completa, incluso para los campos que no vaya a cambiar.
**Promoción a EN DIRECTO**
Para pasar un esquema de la etapa EN DESARROLLO a EN DIRECTO, utilice el comando update-blueprint con la opción --blueprint-stage.
**Sintaxis**
```
aws bedrock-data-automation update-blueprint \
--blueprint-arn "Amazon Resource Name (ARN)" \
--blueprint-stage "LIVE"
```
**Control de versiones del esquema**
Cree una nueva versión de su Blueprint para conservar su estado actual antes de realizar cambios importantes mediante el create-blueprint-version comando.
**Sintaxis**
```
aws bedrock-data-automation create-blueprint-version \
--blueprint-arn "Amazon Resource Name (ARN)"
```
## Administración de etiquetas de esquemas
Las etiquetas ayudan a los usuarios a organizar y clasificar los esquemas para simplificar la administración.
**Añada etiquetas**
Aplique metadatos a su esquema añadiendo etiquetas.
**Sintaxis**
```
aws bedrock-data-automation tag-resource \
--resource-arn "Amazon Resource Name (ARN)" \
--tags '{"Department":"Finance","Project":"PassportProcessing"}'
```
**Eliminar etiquetas**
Elimine etiquetas específicas de su esquema con el comando untag-resource.
**Sintaxis**
```
aws bedrock-data-automation untag-resource \
--resource-arn "Amazon Resource Name (ARN)" \
--tag-keys '["Department","Project"]'
```
**Consulta de etiquetas**
Haz una lista de todas las etiquetas asociadas a tu Blueprint mediante el list-tags-for-resource comando.
**Sintaxis**
```
aws bedrock-data-automation list-tags-for-resource \
--resource-arn "Amazon Resource Name (ARN)"
```
## Creación de esquemas
**Eliminación de un esquema completo**
Utilice el comando delete-blueprint para eliminar permanentemente un esquema y todas sus versiones.
**Sintaxis**
```
aws bedrock-data-automation delete-blueprint \
--blueprint-arn "Amazon Resource Name (ARN)"
```
**Precaución:** Este comando elimina un esquema de forma permanente y no lo puede recuperar.
**Importante:** No puede eliminar un esquema que esté siendo utilizado actualmente en algún proyecto. Antes de eliminarlo, asegúrese de que no se haga referencia al esquema en la configuración de salida personalizada de ningún proyecto.
## Optimización del plano
### Invocando la optimización de planos
Inicie un trabajo de optimización asíncrona del plan para mejorar las instrucciones del plano para cada uno de los campos del plan y la precisión de los resultados.
**Sintaxis**
```
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"
```
### Comprobación del estado de la optimización del plano
Supervise el progreso y los resultados de un trabajo de optimización de planos.
**Sintaxis**
```
aws bedrock-data-automation get-blueprint-optimization-status \
--invocation-arn "arn:aws:bedrock:::blueprint-optimization-invocation/opt-12345abcdef"
```
Utilice este comando para realizar un seguimiento del estado del trabajo de optimización. La respuesta incluye el estado actual (Creado InProgress ServiceError, Éxito o ClientError) y los detalles de la configuración de salida una vez completada.
### Copiar las etapas del plano
Copie un plano de una etapa a otra
**Sintaxis**
```
aws bedrock-data-automation copy-blueprint-stage \
--blueprint-arn "arn:aws:bedrock:::blueprint/" \
--source-stage "DEVELOPMENT" \
--target-stage "LIVE"
```
**Precaución:** Este comando copia toda la configuración del blueprint desde la etapa de origen a la etapa de destino y sobrescribe cualquier configuración existente en la etapa de destino.
**Importante:** Asegúrese de que el blueprint se haya probado exhaustivamente en la fase de origen antes de copiarlo a la fase de producción (LIVE). Esta operación no se puede deshacer fácilmente.