Tools en VoxOne

Las herramientas (Tools) permiten que los agentes de IA accedan a funcionalidades externas, APIs y recursos propios de la plataforma, ampliando lo que el agente puede hacer durante una conversación.

En la práctica, las tools funcionan de manera similar a las habilidades de los agentes tradicionales: permiten consultar información externa, ejecutar acciones específicas y personalizar la experiencia del usuario.

---

Cómo navegar

1. En Skyone Studio, haz clic en VoxOne.

2. Haz clic en la pestaña Herramientas (Tools).

En esta pantalla verás:

• Herramientas personalizadas creadas por ti.

• Herramientas estándar de la plataforma (identificadas con un ícono de un globo terráqueo).

Creación de una herramienta personalizada

Las herramientas personalizadas permiten integrar el agente con servicios externos, como APIs.

Paso a paso

Configuraciones principales

1. Haz clic en Crear nueva herramienta.

2. Define el nombre de la herramienta.

3. Escribe una descripción de la herramienta.

¡Atención! El modelo verá el nombre y la descripción de la herramienta y utilizará esta información para determinar cuándo realizar una llamada a la herramienta.

Integración

1. Selecciona el tipo HTTPS.

2. Configura la URL de la API (puede contener parámetros dinámicos).

3. Selecciona el método HTTP:

• GET

• PUT

• POST

• PATCH

1. Define el timeout, evitando que la plataforma quede bloqueada si la API no responde.

Estará disponible una bandera de “Pre-computable”. Esta permite ejecutar la herramienta de forma simultánea al habla del agente. Úsala solo en operaciones de lectura (por ejemplo, GET) que no modifiquen los datos.

---

Configuración de parámetros de la herramienta

Los parámetros permiten que el valor enviado a la API varíe en cada uso.

Completa los siguientes campos:

• Tipo

  • Dinámico: Siempre cambia

  • Estático: Permanece fijo

  • Automático: El agente identificará si es dinámico o estático

• Nombre del parámetro: Debe coincidir exactamente con la clave

• Método

  • Query

  • Patch

  • Header

• Tipo de esquema

  • Texto

  • Número

  • Entero

  • Booleano

  • Personalizado

• Descripción

Los parámetros dinámicos permiten que el agente utilice valores distintos en cada interacción.

---

Configuraciones avanzadas

Define el comportamiento final del agente, eligiendo entre:

• Predeterminado

• Habla

• Escucha

• Habla una vez

También habrá una bandera de “Respuesta estática”, donde la herramienta siempre devolverá la misma respuesta predefinida al activar la bandera.

Después de guardar, las configuraciones estarán listas para realizar la prueba.

---

Probar la herramienta

1. Haz clic en la opción Probar.

2. Envía un JSON con el parámetro configurado.

Ejemplo:

{
  "CEP": "01000-000"
}

1. Ejecuta la prueba.

2. Verifica si la API devuelve la información esperada.

Si la prueba se ejecuta correctamente, la herramienta estará lista para usarse.

---

Vincular la herramienta a un agente

1. Accede al agente deseado.

2. Ve a la sección Herramientas (Tools) del agente.

3. Selecciona la herramienta creada.

4. Guarda los cambios.

A partir de este momento, el agente podrá acceder a la API externa durante la conversación.

FAQ

¿Para qué sirven las herramientas (tools)?

Permiten que el agente acceda a APIs externas, ejecute acciones específicas y personalice las interacciones.

¿Cuál es la diferencia entre una herramienta personalizada y una estándar?

Las herramientas personalizadas son creadas por el usuario. Las herramientas estándar ya vienen configuradas en la plataforma.

¿Puedo usar parámetros dinámicos en cualquier tool?

Sí, siempre que la API acepte parámetros variables.

¿Es obligatorio probar la tool antes de usarla en el agente?

Sí. La prueba garantiza que la integración funcione correctamente.