Ir al contenido principal

Configuración avanzada de AI Agents

Configura AI Agents avanzados con tools, knowledge, multimedia, cierre y PDF. Guía clara para llevar tus flujos al siguiente nivel.

Actualizado hace más de una semana

Una vez que ya sabes cómo construir un prompt básico para tu AI Agent, puedes llevarlo al siguiente nivel con funciones más potentes como tools, knowledge, end_function, soporte para PDFs, uso de multimedia y configuración de mensajes iniciales.

Aquí te explicamos cada herramienta paso a paso, con ejemplos claros y sin tecnicismos.

⚙️ 1. Uso de Tools

Las tools permiten a tu AI Agent ejecutar acciones concretas, como enviar botones, consultar precios o lanzar validaciones. Son funciones programables que el modelo puede invocar directamente dentro del prompt.

📌 ¿Cómo se usa una tool?

Solo debes escribir:

Utiliza la herramienta nombre_tool con estos parámetros:
{... parámetros en formato JSON ...}

Ejemplo: enviar mensaje interactivo

Utiliza la herramienta send_interactive_message con estos parámetros: { "caption": "Ver opciones", "text": "¿Qué deseas hacer?", "title": "Menú principal", "options": [ { "title": "Consultar saldo", "description": "Ver tu saldo disponible" }, { "title": "Ver movimientos", "description": "Últimos movimientos de tu cuenta" } ] }

💡 Tips:

  • Si hay 3 opciones o menos, se usa botón.

  • Con más de 3, se convierte en una lista.

  • Más de 10 opciones, se transforma en un texto listado.


📚 2. Uso de documentos (Knowledge)

El AI Agent puede buscar respuestas en documentos de conocimiento cargados en Jelou, como PDFs, FAQs, manuales o políticas.

📌 ¿Cómo se usa?

El modelo usa automáticamente la función search para acceder al contenido cargado.

Solo necesitas escribir en el prompt:

Busca la respuesta en los archivos disponibles y responde con base en esa información.


🛑 3. Cierre de la conversación (end_function)

El AI Agent debe saber cuándo terminar su ejecución. Para esto, se usa la función end_function.

📌 ¿Cómo se indica?

Debes escribirlo así, sin variantes:

jsonCopiarEditarend_function: { "salir": true }

❌ Evita decir cosas como “guarda esto” o “termina aquí”, ya que el modelo no entiende contexto si no usas la función exacta.


📎 4. Soporte para PDFs

El AI Agent puede leer contenido textual de archivos PDF que el usuario haya enviado.

🚫 Limitación importante:

Solo texto. No puede leer imágenes incrustadas ni escaneos dentro del PDF.

Ejemplo práctico:
Si un usuario sube su contrato bancario en PDF, el agente puede buscar cláusulas, fechas o datos dentro del archivo.


💬 5. Configuración de mensaje inicial

¿Quieres que el AI Agent arranque con el mensaje del usuario en lugar de un prompt genérico?


Puedes usar {{$message.text}} para que ese primer mensaje se integre automáticamente al prompt.

Útil para prompts como:
“Con base en lo que el usuario escribió, clasifica su intención en una de estas categorías…”


🖼️ 6. Uso de contenido multimedia (imágenes, audio, etc.)

Tu AI Agent puede trabajar con contenido multimedia enlazado con formato Markdown. El sistema detecta automáticamente archivos válidos y los convierte en contenido nativo del canal (WhatsApp, Web, etc).

Esto sirve si estás generando respuestas que incluyen manuales, tutoriales o contenidos descargables.


✅ En resumen

Función

¿Para qué sirve?

Cómo se usa

Tools

Ejecutar funciones como enviar botones o validar

Utiliza la herramienta nombre_tool con { params }

Knowledge

Buscar respuestas en documentos cargados

El modelo usa search automáticamente

end_function

Cerrar el flujo del AI Agent

end_function: { "salir": true }

PDF

Leer contenido textual en archivos PDF

Lo hace automáticamente

Mensaje inicial

Usar el primer mensaje del usuario como contexto

{{$message.text}}

Multimedia

Mostrar archivos con enlaces Markdown

[Texto](URL-del-archivo)

🧵 ¿Y ahora qué sigue?

Con estas funciones avanzadas puedes diseñar AI Agents más potentes, útiles y adaptados a cada caso de uso.

Te recomendamos probar cada elemento poco a poco en tus flujos y combinar prompts simples con herramientas e información real para lograr una experiencia fluida.

¿Ha quedado contestada tu pregunta?