Skip to main content
Las tools nativas son herramientas predefinidas e integradas en la plataforma que permiten al modelo de IA realizar acciones específicas durante una conversación. Estas herramientas extienden las capacidades del agente de IA más allá de la generación de texto, permitiéndole interactuar con el sistema, consultar información, manipular datos y ejecutar acciones concretas. Las tools nativas se encuentran y configuran en el nodo AI Agent. Para acceder a ellas:
  1. Selecciona el nodo AI Agent en tu flujo
  2. Abre la sección TOOLS en la configuración del nodo
  3. Haz clic en el botón ”+ Agregar tools”
  4. En el campo “Selecciona un Tool”, verás la lista de todas las tools disponibles, incluyendo las nativas (marcadas con el texto “(Nativa)”)
Configuración de tools nativas en el nodo AI Agent
A continuación se describen todas las herramientas nativas disponibles en el nodo AI Agent:

​
Búsqueda de productos

Busca productos en el catálogo disponible para recomendar al usuario. Utiliza un motor de búsqueda para encontrar coincidencias basadas en el nombre del producto o términos relacionados. Parámetros:
NombreTipoObligatorioDescripción
productstringSíTérmino de búsqueda o nombre del producto.
top_knumberNoCantidad máxima de resultados a retornar.
score_thresholdnumberNoPuntuación mínima de similitud (0.0 a 1.0) para considerar un resultado relevante.
client_reference_idstringNoID de referencia del cliente para búsquedas personalizadas.
Ejemplo de Prompt:
“Si el usuario pregunta por la disponibilidad de algún artículo o modelo específico, DEBES usar la herramienta search_products para consultar el catálogo antes de responder.”
Ejemplo de Argumentos: 
{
  "product": "iPhone 15 Pro",
  "top_k": 5,
  "score_threshold": 0.85
}
Respuesta: Retorna un listado de productos encontrados o un mensaje indicando que no se encontraron resultados. En caso de error, devuelve un mensaje de sistema descriptivo. Notas:
  • Requiere que el bot tenga un catálogo de productos configurado y accesible.

​
Transferir a asesor

Transfiere la conversación actual del usuario a un agente humano o a una cola de atención. Permite especificar estrategias de enrutamiento y prioridades. Parámetros:
NombreTipoObligatorioDescripción
assignment_typeenumNo (Default: direct)Método de asignación: direct (inmediato) o queue (cola de tickets).
assignment_byenumNo (Default: shuffle)Estrategia de enrutamiento: shuffle (auto), team, operators, general.
teamIdnumberNo*ID del equipo. *Requerido solo si assignment_by es ‘team’.
operatorIdnumberNo*ID del operador. *Requerido solo si assignment_by es ‘operators’.
prioritynumberNo (Default: 0)Prioridad en la cola (0-10), solo relevante para assignment_type='queue'.
Ejemplo de Prompt:
“Cuando el usuario exprese frustración o solicite hablar explícitamente con una persona real, ejecuta la función transfer_to_agent inmediatamente.”
Ejemplo de Argumentos: Caso: Transferencia a cola general 
{
  "assignment_type": "queue",
  "assignment_by": "shuffle",
  "priority": 1
}
Caso: Transferencia directa a un equipo 
{
  "assignment_type": "direct",
  "assignment_by": "team",
  "teamId": 4501
}
Respuesta: Retorna un objeto JSON con el resultado de la operación indicando si la transferencia se inició correctamente. Notas:
  • Realiza una llamada HTTP externa para ejecutar la transferencia en la plataforma.
  • Puede finalizar el flujo de IA inmediatamente.
  • Importante: No se deben inventar IDs de equipos u operadores; se deben usar los configurados explícitamente.

​
Enviar mensajes interactivos

Envía un mensaje estructurado o interactivo al usuario. El formato exacto depende del canal (WhatsApp, Web, etc.), pero generalmente incluye botones, listas de opciones o tarjetas. Parámetros:
NombreTipoObligatorioDescripción
textstringSíTexto principal del mensaje.
captionstringNoPie de foto o texto secundario (depende del canal).
titlestringNoTítulo del mensaje o cabecera.
optionsarraySíLista de opciones. Ver estructura abajo.
Estructura de options (Array de objetos):
  • title (string, obligatorio): Texto de la opción/botón.
  • description (string, opcional): Descripción adicional de la opción.
Ejemplo de Prompt:
“Si el usuario pregunta qué servicios ofrecemos, NO respondas con texto libre. DEBES usar send_interactive_message para mostrar un menú con el título ‘Servicios Disponibles’ y exactamente estas dos opciones: 1. ‘Soporte Técnico’ (descripción: ‘Ayuda con problemas’) y 2. ‘Ventas’ (descripción: ‘Ver planes y precios’).”
Ejemplo de Argumentos: 
{
  "text": "¿Cómo deseas continuar con tu consulta?",
  "title": "Opciones de Servicio",
  "options": [
    {
      "title": "Hablar con Agente",
      "description": "Transferir a soporte humano"
    },
    {
      "title": "Ver Catálogo",
      "description": "Explorar productos disponibles"
    }
  ]
}
Respuesta: Retorna un mensaje de confirmación si el envío fue exitoso o un mensaje de error en caso contrario. Notas:
  • Envía un mensaje real al usuario.
  • Adapta el mensaje al canal específico del usuario.

​
Fecha y hora actual

Obtiene la fecha y hora actual. Permite especificar una zona horaria para obtener la hora local correcta. Parámetros:
NombreTipoObligatorioDescripción
timezonestringNoZona horaria deseada en formato IANA (ej: “America/Guayaquil”, “UTC”).
Ejemplo de Prompt:
“Antes de procesar cualquier solicitud que dependa de la hora (como ‘buenos días’ o citas para ‘hoy’), llama a get_current_date_time para saber la hora exacta.”
Ejemplo de Argumentos: 
{
  "timezone": "America/Mexico_City"
}
Respuesta: Retorna un string con la fecha y hora formateada, por ejemplo: "Monday, December 08, 2025 10:30 AM". Notas:
  • No tiene efectos secundarios visibles para el usuario.
  • Es puramente informativa para el modelo.

​
Día de la semana

Calcula y retorna el día de la semana correspondiente a una fecha específica proporcionada. Parámetros:
NombreTipoObligatorioDescripción
datestringSíFecha a consultar (formato ISO o legible standard, ej: “2024-12-25”).
Ejemplo de Prompt:
“Si el usuario quiere agendar para una fecha específica, verifica primero qué día de la semana es usando get_weekday_of_a_date para asegurar que sea un día hábil.”
Ejemplo de Argumentos: 
{
  "date": "2025-12-10"
}
Respuesta: Retorna el nombre del día de la semana, por ejemplo: "Wednesday". Notas:
  • Útil para validar citas o agendas.