Documentación: Acción Claude (Análisis con IA de Anthropic)¶

Descripción General¶

La Acción Claude es un nodo de automatización que permite utilizar los modelos de inteligencia artificial Claude de Anthropic para procesar y analizar contenido: texto, imágenes, audio y video. Pertenece a la familia de nodos de AI Models y comparte la misma estructura que las acciones de otros proveedores (Gemini, GPT, Grok).

En entornos IoT y de seguridad, es ideal para analizar con IA las imágenes de cámaras ante un evento (identificar personas, vehículos, objetos en zonas restringidas), así como para procesar texto con alta calidad de razonamiento.

¿Cuándo usar esta acción?¶

Utiliza esta acción cuando necesites:

Analizar imágenes de cámaras (detectar personas/vehículos, leer texto, describir escenas).
Analizar video para extraer información o detectar eventos.
Procesar texto (resumir, clasificar, extraer datos) con los modelos Claude.
Integrar las capacidades de Anthropic en tus automatizaciones.

Configuración del Nodo¶

La configuración se divide en dos secciones, conmutables con el selector superior: Basic Configuration y Prompt Configuration. Además, dispone de la pestaña JSON Editor.

Configuración básica vacía del nodo Claude

Sección: Basic Configuration (Configuración Básica)¶

1. API Key *Requerido¶

Selecciona la credencial de Anthropic que autentica el acceso (gestionada de forma centralizada y segura).

2. Tipo de Recurso (Resource Type) *Requerido¶

El tipo de contenido a procesar: Text, Image, Audio o Video.

3. Modelo (Model) *Requerido¶

El modelo Claude a utilizar:

Modelo	Valor
Claude 3.5 Sonnet	`claude-3-5-sonnet-20241022`
Claude 3.5 Haiku	`claude-3-5-haiku-20241022`
Claude 3 Opus	`claude-3-opus-20240229`
Claude 3 Sonnet	`claude-3-sonnet-20240229`
Claude 3 Haiku	`claude-3-haiku-20240307`

Configuración básica del nodo Claude con recurso Imagen

Sección: Prompt Configuration (Configuración del Prompt)¶

4. Operación (Operation) *Para Imagen y Video¶

Para Image: Analyze Image.
Para Video: Analyze Video.

5. URLs de Imágenes / Videos¶

Para análisis, ingresa las URLs (una por línea). Admite expresiones de plantilla (por ejemplo, {{get_snapshot_node.url}}).

6. Prompt *Requerido¶

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

Configuración del prompt del nodo Claude

Vista Editor de JSON¶

Vista JSON Editor del nodo Claude

Estructura JSON (Parámetros de entrada)¶

{
  "api_key": "",
  "resource": "image",
  "operation": "analyze",
  "model_id": "claude-3-5-sonnet-20241022",
  "image_urls": [
    "{{get_snapshot_node.url}}"
  ],
  "video_urls": [],
  "prompt": "Analyze this camera image and describe whether there are vehicles or unauthorized people in the restricted area."
}

Campos del JSON¶

Campo	Tipo	Descripción
`api_key`	string	Referencia a la credencial de Anthropic (gestionada de forma segura).
`resource`	string	Tipo de recurso: `text`, `image`, `audio`, `video`.
`operation`	string	Operación (imagen: `analyze`; video: `analyze_video`).
`model_id`	string	ID del modelo Claude (ej. `claude-3-5-sonnet-20241022`).
`image_urls`	array (string)	URLs de imágenes a analizar.
`video_urls`	array (string)	URLs de videos 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 Claude) queda disponible en la salida del nodo y puede usarse en nodos posteriores con {{node_key}}.

Ejemplos de uso¶

Ejemplo 1: Detección de vehículos/personas no autorizadas¶

Caso de uso: Al detectar movimiento en una zona restringida, se captura la imagen y Claude la analiza para determinar si hay vehículos o personas no autorizadas.

Resource Type: Image | Model: claude-3-5-sonnet-20241022
Operation: Analyze Image
Image URLs: {{get_snapshot_node.url}}
Prompt: Analyze this camera image and describe whether there are vehicles or unauthorized people in the restricted area.

(ver estructura JSON anterior)

Ejemplo 2: Clasificación de un reporte de texto¶

Caso de uso: Clasificar la severidad de un reporte recibido.

Resource Type: Text
Prompt: Classify the severity (low/medium/high) of the following report and justify it: {{trigger.body.text}}

Validación y errores¶

Condición	Causa / Solución habitual
Error de autenticación	La credencial de Anthropic es inválida o sin permisos/saldo.
Las URLs no funcionan	Asegúrate de que las URLs sean accesibles públicamente (convierte URLs internas de Docker a su ruta pública).
Límite de uso excedido	Revisa los límites de tu cuenta de Anthropic; considera un modelo más ligero (Haiku).

Buenas prácticas¶

Usar credenciales centralizadas: No escribas la API key en el nodo.
Elegir el modelo adecuado: Usa Sonnet para equilibrio calidad/costo; Haiku para tareas simples/rápidas; Opus para máxima capacidad.
Prompts específicos: Haz preguntas concretas para confirmar/descartar eventos de seguridad.
Encadenar con la captura: Patrón típico: Obtener captura → Claude (Analyze Image) → condición/notificación.