Funciones

El módulo Funciones permite conectar tus agentes de Beex AI con servicios externos mediante APIs. Gracias a esta integración, los agentes pueden consultar información en tiempo real, validar datos, ejecutar acciones automáticas o interactuar con otros sistemas durante una conversación.

Este módulo es clave cuando el agente necesita realizar operaciones dinámicas, como consultar estados, registrar información o tomar decisiones basadas en datos externos.

Desde este módulo puedes:

• Crear nuevas funciones
• Editar funciones existentes
• Definir parámetros de entrada
• Configurar endpoints externos
• Reutilizar funciones entre múltiples agentes
• Consultar agentes vinculados a cada función

Estructura del panel Funciones

Al ingresar al módulo encontrarás un listado con todas las funciones registradas en el proyecto. Cada elemento muestra información relevante para su administración y uso dentro de los agentes IA.

A continuación, se describe la información disponible en el panel:

• Nombre de la función: Identificador único utilizado por el agente para ejecutar la integración configurada.
• ID: Código interno asignado automáticamente por la plataforma para identificar la función.
• Agentes vinculados: Indica cuántos agentes están utilizando la función dentro de sus configuraciones.
• Acciones: Permite editar o eliminar la función según sea necesario.

Eliminar una función afecta directamente a los agentes que la utilizan, por lo que se recomienda hacerlo únicamente cuando ya no forme parte de ningún flujo operativo activo.

Crear función

La opción Crear función permite registrar una nueva integración disponible para los agentes IA.

Configuración general

Esta sección contiene los parámetros principales necesarios para que la función pueda ejecutarse correctamente. Los campos marcados con asterisco (*) son obligatorios.

Nombre de la función *

Define el identificador único de la función dentro del proyecto. Este nombre será utilizado por el agente cuando necesite ejecutar la integración durante la conversación.

Características del campo:

• Obligatorio
• Debe ser único dentro del proyecto
• No admite duplicados

Se recomienda utilizar nombres descriptivos relacionados con la acción ejecutada. Ejemplos:

• consultar_stock
• validar_cliente
• consultar_tallas
• cerrar_ticket

Server URL *

Define la dirección del endpoint externo al cual el agente enviará la solicitud. Este endpoint debe estar disponible y preparado para recibir los parámetros definidos en la función. El correcto funcionamiento depende de la disponibilidad del servicio configurado.

Ejemplo: https://api.miempresa.com/consultar-tallas

Descripción *

Permite indicar el propósito de la función y el contexto en el que debe utilizarse. Una descripción clara mejora la precisión del agente al decidir cuándo ejecutar la función.

Ejemplo recomendado: Consultar la disponibilidad de tallas según el número ingresado por el cliente.

Parámetros

La sección Parámetros permite definir las propiedades que serán enviadas al endpoint cuando el agente ejecute la función. Cada propiedad representa un dato necesario para completar la consulta o acción solicitada.

Agregar una propiedad

Para agregar una propiedad:

• Nombre de la propiedad:piedad : Define el identificador del parámetro que será enviado al endpoint. Debe coincidir con el formato esperado por el servicio externo. Ejemplos:

  • talla
  • dni
  • correo_cliente
  • numero_pedido

• Tipo de propiedad:  Indica el tipo de dato que recibirá el parámetro. Seleccionar correctamente el tipo garantiza compatibilidad con el endpoint externo.
  
  Los tipos disponibles son:
  

  • string – Permite enviar valores de texto como nombres, códigos, correos electrónicos e identificadores alfanuméricos.
  • number – Permite enviar valores numéricos como montos, cantidades, tallas e identificadores numéricos.
  • boolean – Permite enviar valores lógicos: true o false.

• Descripción de la propiedad (opcional): Permite documentar el propósito del parámetro dentro de la función. Esto facilita la comprensión del comportamiento de la integración cuando existen múltiples propiedades configuradas.
  
  Ejemplo: Número de talla solicitado por el cliente.
  

• Parámetro requerido: Permite indicar si la propiedad es obligatoria para ejecutar la función.
  
  Cuando un parámetro es requerido:

• • El agente deberá obtener ese valor antes de ejecutar la función
  • La función no podrá ejecutarse si el dato no está disponible
  
  Esto asegura la correcta validación de la información enviada al endpoint.

¿Necesitas ayuda?
Si tienes dudas o necesitas soporte adicional, puedes escribirnos a:
📩 support@beexcc.com

¡Estamos aquí para ayudarte!