# 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).

<figure><img src="/files/XoXsKu6HCpT0mFR9e7ID" alt=""><figcaption></figcaption></figure>

#### 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**.

{% hint style="warning" %}
**¡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.
{% endhint %}

#### **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

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

{% hint style="info" %}
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.
{% endhint %}

***

#### 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.

<figure><img src="/files/vi4Ty6g6XpvhirItWssa" alt=""><figcaption></figcaption></figure>

***

#### 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.

<figure><img src="/files/7BPDH8XnmVzFhoJDYB3M" alt=""><figcaption></figcaption></figure>

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:**

```json
{
  "CEP": "01000-000"
}
```

3. Ejecuta la prueba.
4. 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.

<figure><img src="/files/zdYcPwUGwfrpOye3vgtL" alt=""><figcaption></figcaption></figure>

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

### FAQ

<details>

<summary>¿Para qué sirven las herramientas (tools)?</summary>

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

</details>

<details>

<summary>¿Cuál es la diferencia entre una herramienta personalizada y una estándar?</summary>

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

</details>

<details>

<summary>¿Puedo usar parámetros dinámicos en cualquier tool?</summary>

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

</details>

<details>

<summary>¿Es obligatorio probar la tool antes de usarla en el agente?</summary>

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

</details>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.skyone.cloud/espanol/skyone-studio/inteligencia-artificial/voxone/tools-en-voxone.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.