Un AI Task es una tarea conversacional que envía una petición a un modelo de lenguaje (LLM) como OpenAI. A diferencia de un nodo AI Agent, el AI Task tiene un solo propósito: cumplir lo que le pidas en el prompt y devolver un resultado en formato JSON.
No necesitas usar end_function ni gestionar flujos. Solo redactar el prompt correctamente, y el modelo hará el resto.
🧩 ¿Qué hace diferente a un AI Task?
Característica | AI Agent | AI Task |
Requiere | ✅ Sí | ❌ No |
Tiene rol o personalidad | ✅ Sí | ❌ No |
Ejecuta lógica compleja | ✅ Flujos, condiciones, decisiones | ⚡ Prompt simple, directo |
Devuelve JSON | Opcional (si se especifica) | ✅ Siempre debe devolver JSON |
Usa tools | ✅ Sí | ✅ Sí (con ciertas recomendaciones) |
✍️ ¿Cómo escribir un buen prompt para AI Task?
El secreto está en la claridad, estructura y consistencia. Aquí te guiamos paso a paso.
1. 🎯 Sé claro con lo que esperas
Tu prompt debe indicar exactamente qué resultado esperas. Por ejemplo:
textCopiarEditarClasifica el siguiente mensaje del usuario según estas 5 categorías: tarjetas, cuentas, documentos, consultas u otro. Devuelve el resultado en el siguiente formato: { "flujo": "[categoría]" }
2. 🧾 Especifica el formato de salida
Siempre indica que necesitas un JSON como respuesta.
Evita frases vagas como “responde con la categoría”. Mejor sé específico:
jsonCopiarEditar{ "flujo": "documentos" }
3. 🧠 Usa el mismo lenguaje en todo el prompt
Si vas a hablar de "herramienta", no cambies después a "tool", "función" o "módulo". El modelo no adivina, sigue las instrucciones literalmente.
❌ Incorrecto:
Ejecuta la herramienta calcular_precio... luego ejecuta esta función...
✅ Correcto:
Ejecuta la herramienta calcular_precio... luego, si es necesario, vuelve a ejecutar otra herramienta.
4. 🔧 Uso de herramientas (tools)
Cuando pidas que se ejecute una tool, utiliza su nombre exacto, reemplazando los espacios por guiones bajos (_).
Ejemplo:
Ejecuta la herramienta consultar_precio_producto para recuperar la información.
🧪 Ejemplo completo:
Clasificador de flujos bancarios
Debes procesar el mensaje del usuario, para decidir a qué flujo se envía. El mensaje del usuario es: {{$message.text}} Existen 5 flujos: 1. Tarjetas de crédito 2. Cuentas de ahorro y cuentas corrientes 3. Documentos 4. Consultas generales 5. Otro Ubica el mensaje en alguno de los 5 flujos y devuelve solo un JSON como este: { "flujo": "[valor]" } Opciones: tarjetas, cuentas, documentos, consultas, otro🧾 Resultado esperado:
jsonCopiarEditar{ "flujo": "cuentas" }
✅ Resumen de buenas prácticas
Aspecto | Recomendación |
Claridad | Usa prompts directos y estructurados |
Lenguaje | Sé consistente (ej. usa solo "herramienta" en todo el texto) |
Formato JSON | Especifica con claridad el formato de salida |
Cierre | En AI Tasks, no uses |
Contexto | Si usas tools o archivos, explica cómo deben usarse |