Documentación: Acción AWS Bedrock (Análisis con IA)¶

Descripción General¶

La Acción AWS Bedrock es un nodo de automatización que permite analizar imágenes utilizando los modelos de inteligencia artificial disponibles en Amazon Bedrock (el servicio gestionado de modelos fundacionales de AWS, que incluye modelos como Claude de Anthropic, entre otros). Pertenece a la familia de nodos de AI Models.

En entornos IoT y de seguridad, es ideal para organizaciones que ya operan en AWS y desean ejecutar el análisis de imágenes de cámaras a través de Bedrock, aprovechando su infraestructura, gobernanza y facturación centralizada.

¿Cuándo usar esta acción?¶

Utiliza esta acción cuando necesites:

Analizar imágenes de cámaras con IA usando modelos alojados en AWS Bedrock.
Mantener el procesamiento de IA dentro del ecosistema AWS (gobernanza, seguridad, facturación).
Obtener descripciones estructuradas (por ejemplo, en JSON) de lo que ocurre en una imagen.

Configuración del Nodo¶

El nodo cuenta con dos pestañas de configuración en la parte superior: Formulario (Form) y Editor de JSON (JSON Editor).

Configuración vacía del nodo AWS Bedrock

Vista Formulario¶

1. Credenciales de AWS (AWS Credentials) *Requerido¶

Selecciona la credencial de AWS (que contiene access_key_id, secret_access_key y, opcionalmente, session_token) para autenticar el acceso a Bedrock. Se gestiona de forma centralizada y segura.

2. ID del Modelo (Model ID) *Requerido¶

El identificador del modelo de Bedrock a utilizar (por ejemplo, anthropic.claude-3-5-sonnet-20241022-v2:0).

3. URLs de Imágenes (Image URLs)¶

Las URLs de las imágenes a analizar (una por línea). Admite expresiones de plantilla (por ejemplo, {{get_snapshot_node.url}}).

4. Prompt *Requerido¶

La instrucción o pregunta para el modelo. Admite expresiones de plantilla.

Formulario configurado del nodo AWS Bedrock

Vista Editor de JSON¶

Vista JSON Editor del nodo AWS Bedrock

Estructura JSON (Parámetros de entrada)¶

{
  "region": "us-east-1",
  "access_key_id": "",
  "secret_access_key": "",
  "session_token": "",
  "profile": "",
  "model_id": "anthropic.claude-3-5-sonnet-20241022-v2:0",
  "resource": "image",
  "operation": "analyze",
  "image_urls": [
    "{{get_snapshot_node.url}}"
  ],
  "prompt": "Describe in JSON format the objects and people visible in this security image."
}

Campos del JSON¶

Campo	Tipo	Descripción
`region`	string	Región de AWS (por defecto `us-east-1`).
`access_key_id` / `secret_access_key` / `session_token`	string	Referencias a la credencial de AWS (gestionadas de forma segura).
`profile`	string	Perfil de AWS (opcional).
`model_id`	string	ID del modelo de Bedrock (ej. `anthropic.claude-3-5-sonnet-20241022-v2:0`).
`resource`	string	Tipo de recurso (`image`).
`operation`	string	Operación (`analyze`).
`image_urls`	array (string)	URLs de las imágenes a analizar.
`prompt`	string	La instrucción/pregunta para el modelo.

Output: Dónde viene la data del nodo¶

El resultado del análisis (texto generado por el modelo de Bedrock) queda disponible en la salida del nodo y puede usarse en nodos posteriores con {{node_key}}.

Ejemplos de uso¶

Ejemplo 1: Análisis de imagen de seguridad vía AWS¶

Caso de uso: Una organización que opera en AWS analiza la captura de una cámara con un modelo de Bedrock para obtener una descripción estructurada de objetos y personas.

Model ID: anthropic.claude-3-5-sonnet-20241022-v2:0
Image URLs: {{get_snapshot_node.url}}
Prompt: Describe in JSON format the objects and people visible in this security image.

(ver estructura JSON anterior)

Validación y errores¶

Condición	Causa / Solución habitual
Error de autenticación	La credencial de AWS es inválida o sin permisos sobre Bedrock.
Modelo no disponible	Verifica que el `model_id` esté habilitado en tu cuenta y región de AWS Bedrock.
Las URLs no funcionan	Asegúrate de que las URLs de imagen sean accesibles públicamente.

Buenas prácticas¶

Usar credenciales centralizadas: No escribas las claves de AWS en el nodo; selecciona una credencial gestionada de forma segura.
Verificar acceso al modelo: Habilita previamente el modelo deseado en la consola de AWS Bedrock para tu región.
Pedir salidas estructuradas: Solicita JSON en el prompt cuando vayas a procesar el resultado en nodos posteriores.
Encadenar con la captura: Patrón típico: Obtener captura → AWS Bedrock → condición/notificación.