PulbotDocumentación

Tool Agent (IA)

Ejecuta un modelo de lenguaje (LLM) con un prompt configurable. El agente recibe el contexto del flow (variables), razona y genera una respuesta de texto. Puede acceder a tu Knowledge Base o encadenar otras tools.

¿Cuándo usarlo?

Cuando necesitas que el bot entienda lenguaje natural, genere respuestas inteligentes, clasifique intenciones o procese texto complejo.

Pasos

  1. 1Crea una tool → elige tipo «Agent».
  2. 2Selecciona el modelo (OpenAI GPT-4o, Claude, etc.) via el conector configurado con tu API key.
  3. 3Escribe el system prompt. Define el rol, el tono y las restricciones del agente.
  4. 4En el user prompt, usa {{...}} para inyectar el mensaje del usuario y otras variables del flow.
  5. 5Configura max_tokens para controlar el costo y evitar respuestas excesivamente largas (recomendado: ≤1024 en Telegram/WhatsApp).
  6. 6Opcionalmente, activa el acceso a Knowledge Base para que el agente consulte tus archivos.
  7. 7Guarda y prueba con un mensaje de ejemplo.

Referencia

System prompt
Instrucciones permanentes para el modelo. Define quién es el agente, en qué idioma responde y qué puede y no puede hacer.
User prompt
Mensaje que el agente recibe como input. Normalmente: «El usuario dijo: {{mensaje_usuario}}»
max_tokens
Límite de tokens en la respuesta. 1 token ≈ 0.75 palabras. Para WhatsApp/Telegram recomendamos ≤1024.
Temperatura
Controla la creatividad del modelo. 0 = determinista. 1 = creativo. Para soporte al cliente: 0.3–0.5.
Conector
API Key del proveedor de IA (OpenAI, Anthropic, etc.). Almacenada de forma segura como conector.
Knowledge Base
Si está activada, el agente busca semánticamente en tus archivos PDF/txt antes de responder.

Errores comunes

Respuesta cortada a mitad
El modelo alcanzó el límite de max_tokens. Auméntalo o ajusta el prompt para respuestas más cortas.
«API key inválida»
La API key del conector es incorrecta o fue revocada. Actualiza el conector con una key válida.
Agente repite la respuesta 4 veces
El buffer de contexto de memoria del agente guardó una respuesta duplicada y la reinyecta. Desconecta el Window Buffer y usa KV Store para la sesión.
Respuesta muy larga / corta en Telegram
Telegram rechaza mensajes >4096 chars. Añade al system prompt: «Máximo 3500 caracteres. Máximo 5 ítems en listas.»

Siguiente paso

Aprende Tool Code para lógica completamente personalizada.

¿Necesitas ayuda?