AI Complete

AI Complete

Tipo: ai-complete  ·  Paquete: AI Activities v1.0.0  ·  Salida: string

Envía un prompt a un modelo de lenguaje y devuelve su respuesta como texto. Sirve para resumir, redactar, traducir, clasificar o responder preguntas sobre un contenido.

Si lo que necesitas son campos concretos (un número de serie, una fecha, un importe), usa AI Extract: devuelve un objeto en vez de texto que luego tendrías que parsear.

Cómo funciona

Manda system (las reglas y el papel del modelo) y prompt (la tarea concreta), más las images si las hay, y devuelve el texto de la respuesta.

Parámetros requeridos

Parámetro	Editor	Descripción
credential	credencial	Credencial de Zoan Cloud con la API key del proveedor.
prompt	expresión	La pregunta o tarea para el modelo.

Parámetros opcionales

Parámetro	Editor	Descripción
provider	enum	Proveedor de IA. Por defecto, Anthropic (Claude).
model	expresión	Id del modelo. Vacío usa el modelo por defecto del proveedor.
system	expresión	Instrucciones de sistema: papel del modelo, reglas y estilo de la respuesta.
images	lista	Rutas de imágenes a enviar con el prompt (.jpg, .png, .gif, .webp).
effort	enum	Cuánto trabajo dedica el modelo: low, medium, high, xhigh, max.
thinking	booleano	Deja que el modelo razone antes de responder.
maxTokens	expresión	Longitud máxima de la respuesta, en tokens. Por defecto 16000.
timeout	expresión	Segundos de espera. Por defecto 600.

Salida

Devuelve un string con la respuesta del modelo.

System y prompt

La separación importa: system describe quién es el modelo y qué reglas sigue durante toda la petición; prompt es la tarea concreta. Poner las reglas en el prompt funciona, pero se diluyen cuando el contenido es largo.

system → "Eres un clasificador de correos de soporte. Responde solo con una
          de estas palabras: incidencia, consulta, spam."
prompt → = cuerpoDelCorreo

Ejemplo

Clasificar un correo entrante y ramificar:

AI Complete   credential = = credential("anthropic-key")
              system     = "Eres un clasificador…"
              prompt     = = correo["body"]
              maxTokens  = 10
              → output: tipo
If            condition = = tipo == "incidencia"
  ...

Resumir un contrato largo:

PDF Get Text   path = = rutaContrato   → output: texto
AI Complete    credential = = credential("anthropic-key")
               system     = "Resume en viñetas, máximo 5, en español."
               prompt     = = texto
               → output: resumen

Ajusta maxTokens a lo que pides

El valor por defecto (16000) da margen de sobra para una respuesta larga. Si esperas una palabra, bájalo: hace la llamada más barata y evita que el modelo se explaye.

Errores comunes

Mensaje	Qué pasó
The model hit the 'maxTokens' limit before finishing	La respuesta no cabe. Sube maxTokens o pide menos texto.
The credential does not contain an Anthropic API key	La credencial existe pero está vacía o guarda otra cosa.
Claude declined this request for safety reasons	El modelo rechazó el contenido. Es una respuesta del modelo, no un fallo de configuración.

Actividades relacionadas

• AI Extract — cuando quieres campos en vez de texto.
• PDF Get Text — obtener el texto de un documento.