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 2 meses

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?