> ## Documentation Index
> Fetch the complete documentation index at: https://help.chateea.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Captura datos del usuario en Agent Studio

> Pide correo, teléfono, una opción o un texto con las herramientas de captura y úsalos en tu agente.

Las herramientas de captura de información de Agent Studio te permiten pedirle al usuario un dato concreto (su correo, su teléfono, una opción de una lista o una respuesta escrita) y guardarlo para usarlo más adelante en el agente. En lugar de esperar que la IA extraiga el dato de un mensaje abierto, el agente hace una pregunta directa y recibe la respuesta en un formato ordenado.

## Cuándo usarlas

Úsalas cuando el agente necesita un dato claro antes de dar el siguiente paso. Por ejemplo:

* Pedir el correo antes de enviar una confirmación o un seguimiento.
* Pedir el teléfono antes de pasar al prospecto a ventas o soporte.
* Hacer que el usuario elija una opción para enviarlo al camino correcto.
* Recoger un texto libre: un tema, una solicitud, una pregunta o una descripción.
* Reunir los datos necesarios antes de que un nodo Agente de IA genere contenido o responda.

Son ideales cuando el dato es predecible y no hace falta razonamiento de IA para obtenerlo.

## Herramientas disponibles

| Herramienta | Qué captura | Ejemplo de pregunta |
| - | - | - |
| **Correo electrónico** | Un correo válido para confirmaciones, seguimientos o datos del prospecto. | "Déjanos tu correo para enviarte los detalles." |
| **Número de teléfono** | Un teléfono válido para devolver la llamada, calificar o dar seguimiento. Si el número no es válido, vuelve a pedirlo. | "¿A qué número te podemos llamar?" |
| **Opción única** | Una opción de una lista fija: tipo de servicio, nivel de interés, tema de soporte. | "¿En qué te ayudamos? Precios, Agendar una llamada, Soporte, Otra consulta." |
| **Texto libre** | Una respuesta escrita: tema, pregunta, nombre del negocio, objetivo o petición especial. | "¿Sobre qué tema quieres el contenido?" |

## Cómo funcionan

Las herramientas de captura se usan dentro de un [nodo secuencial](https://help.chateea.com/docs/ia/nodo-secuencial-agent-studio.md), que ejecuta cada paso en orden. Cuando el flujo llega a una herramienta de captura, el agente hace la pregunta, espera la respuesta y la guarda en una variable. Luego sigue con el siguiente paso.

Un esquema típico:

1. Un disparador, como **Mensaje de chat** o **Etiqueta del contacto**.
2. Un nodo secuencial con una o varias herramientas de captura.
3. Un enrutador o un nodo Agente de IA que usa los datos capturados para decidir qué sigue.

Por ejemplo, el agente arranca con un mensaje de chat, pasa a un nodo secuencial con una pregunta de **opción única** y, según lo que elija el usuario, un enrutador lo envía a precios, a agendar una llamada o a soporte.

## Cómo configurarlas

**1. Abre el agente**

Ve a **IA → Agent Studio** y abre el agente que quieres editar.

**2. Agrega o abre un nodo secuencial**

Agrega un nodo **Secuencial** al lienzo, o abre uno existente donde quieras recoger la información.

**3. Elige la herramienta de captura**

En el panel izquierdo, abre **Capturar información** y arrastra al nodo secuencial la herramienta que necesites: **Correo electrónico**, **Número de teléfono**, **Opción única** o **Texto libre**.

**4. Escribe la pregunta**

Escribe el mensaje que verá el usuario, por ejemplo: "¿Qué opción describe mejor tu solicitud?". En la opción única, agrega también las opciones.

**5. Guarda la respuesta en una variable**

Asigna un nombre a la variable, como `email`, `phone_number`, `selected_interest` o `topic`, para poder usarla después.

**6. Conecta el siguiente paso**

Une el nodo secuencial con lo que sigue: un enrutador, un nodo Agente de IA, un mensaje de confirmación u otra acción.

**7. Prueba el flujo**

Ejecuta una conversación de prueba y confirma que las preguntas aparecen en orden, que el correo y el teléfono se validan, que las opciones se muestran bien, que las respuestas se guardan en la variable correcta y que el siguiente nodo las usa.

## Usar los datos capturados más adelante

Las respuestas quedan guardadas como variables de ejecución y puedes insertarlas en indicaciones, mensajes o acciones posteriores. Por ejemplo, si capturas:

| Dato | Valor |
| - | - |
| Tema | IA en belleza |
| Público | Adultos mayores |
| Correo | `usuario@ejemplo.com` |
| Teléfono | +1 555 123 4567 |

Un nodo Agente de IA posterior puede recibir la instrucción: "Escribe un artículo de blog sobre el tema capturado para el público elegido e incluye el correo y el teléfono como datos de contacto". Así combinas una recogida de datos predecible con la generación con IA.

## Preguntas frecuentes

> **¿Dónde encuentro estas herramientas?**
>
> En el panel izquierdo de Agent Studio, en la sección **Capturar información**.

> **¿Usan IA para capturar la respuesta?**
>
> No. Están diseñadas para recoger datos estructurados sin necesidad de IA.

> **¿Puedo usarlas dentro de un nodo Agente de IA?**
>
> No, se usan dentro del nodo secuencial. Si necesitas razonamiento, agrega un nodo Agente de IA después de capturar los datos.

> **¿La opción única puede enviar a los usuarios por caminos distintos?**
>
> Sí. Usa la opción elegida en un enrutador para dirigir a cada usuario al camino correcto.

> **¿El teléfono se valida?**
>
> Sí. Si el número no es válido, la herramienta vuelve a pedirlo antes de continuar.

## Artículos relacionados

> **[Nodo secuencial](https://help.chateea.com/docs/ia/nodo-secuencial-agent-studio.md)**
>
> Ejecuta pasos en un orden fijo.

> **[Nodo Agente de IA](https://help.chateea.com/docs/ia/nodo-agente-ia-agent-studio.md)**
>
> Usa los datos capturados con IA.

> **[Nodo enrutador](https://help.chateea.com/docs/ia/nodo-enrutador-agent-studio.md)**
>
> Envía a cada usuario por el camino correcto.

> **[Variables y valores personalizados](https://help.chateea.com/docs/ia/variables-y-valores-personalizados-agent-studio.md)**
>
> Reutiliza los datos en todo el agente.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.