> For the complete documentation index, see [llms.txt](https://docs.dapta.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.dapta.ai/dapta-docs-es/agentes-de-voz-ia/configura-tu-agente-de-voz-ia/usando-variables-dinamicas-en-tu-agente-de-voz.md).

# Usando variables dinámicas en tu agente de voz

Las variables dinámicas son marcadores de posición utilizados en los prompts de nuestros agentes para personalizar las interacciones mediante la inserción dinámica de información específica durante una conversación. Son esenciales para adaptar las respuestas de la IA a las necesidades individuales y al contexto de cada interacción con el cliente.\
\
En este tutorial te mostramos cómo hacerlos

## Estructuración de la Sección de Variables de Entrada

### Propósito

La sección de Variables de Entrada es crucial para definir las variables dinámicas que se utilizarán a lo largo del prompt de IA. Esta sección asegura que cada variable esté claramente documentada, proporcionando claridad sobre su propósito y uso.

### Notación

* Las variables dinámicas siempre se encierran entre dobles llaves, por ejemplo, **{{nombre\_variable}}**.
* Cada variable debe listarse con una breve descripción de su rol en la conversación.

### Ejemplo de Declaración

* **{{nombre\_cliente}}**: El nombre del cliente.
* **{{interes\_producto}}**: El producto en el que el cliente está interesado.
* **{{correo\_cliente}}**: La dirección de correo electrónico del cliente.
* **{{empresa\_cliente}}**: La empresa que representa el cliente.

### Ejemplo de Uso

* Saludo: "Hola {{nombre\_cliente}}, veo que estás interesado en nuestro {{interes\_producto}}."
* Referencia a Empresa: "Entiendo que {{empresa\_cliente}} ha estado experimentando {{problema\_especifico}}."

### Ubicación

Las variables dinámicas deben colocarse en la sección `# Input Variables` del prompt. Se recomienda posicionarlas al final de esta sección para asegurar claridad y organización.

## Variables desde respuestas de acciones

Además de prellenar variables antes de una llamada, tu agente puede crear nuevas variables dinámicas **durante** la llamada a partir de la respuesta de una Acción Personalizada.

Al configurar una Acción Personalizada (**Configuración** → **Acciones del agente** → **Agregar** → **Acción Personalizada**), usa la sección **Guardar campos como variables**:

* "Campo de la respuesta": el campo a leer de la respuesta de la acción, por ejemplo `response.seguimiento`.
* "Nombre de la variable": el nombre de la variable que guardará el valor, por ejemplo `numero_seguimiento`.

<figure><img src="/files/4GGIAIzW06c9xkkT1y7Z" alt=""><figcaption></figcaption></figure>

Cuando la acción se ejecuta durante la llamada, el valor queda disponible como una variable dinámica normal — por ejemplo **{{numero\_seguimiento}}** — y puedes usarla más adelante en la misma llamada, por ejemplo en un mensaje de transferencia.

{% hint style="info" %}
Agrega una fila por cada campo que quieras guardar. Las filas con el campo o el nombre de la variable vacíos se ignoran.
{% endhint %}

## Mejores Prácticas

* Asegúrate de que todas las variables dinámicas estén correctamente pobladas antes de que comience la conversación.
* Actualiza regularmente la lista de variables dinámicas para reflejar cualquier cambio en las necesidades del negocio o las interacciones con clientes.
* Prueba la implementación de variables dinámicas para asegurar que funcionen según lo esperado en varios escenarios.

## Conclusión

Las variables dinámicas son una herramienta poderosa para crear interacciones de IA personalizadas y efectivas. Al entenderlas e implementarlas correctamente, las empresas pueden mejorar significativamente la calidad de sus interacciones con clientes.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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, and the optional `goal` query parameter:

```
GET https://docs.dapta.ai/dapta-docs-es/agentes-de-voz-ia/configura-tu-agente-de-voz-ia/usando-variables-dinamicas-en-tu-agente-de-voz.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.