> ## Documentation Index > Fetch the complete documentation index at: https://help.cloudtalk.io/llms.txt > Use this file to discover all available pages before exploring further. # Modo experto de VoiceAgent > Desbloquea la configuración avanzada de VoiceAgent para el modelo de IA, la voz y la gestión de llamadas. Este artículo explica cómo usar el modo experto para ver, editar e importar la configuración completa de tu VoiceAgent a través de la pestaña *Avanzado*. **Nivel de usuario:** Admin *** **El modo experto** te da acceso directo a la configuración completa de tu VoiceAgent como archivo JSON. Desbloquea la pestaña *Avanzado* en la configuración de VoiceAgent, donde puedes ver, editar e importar configuraciones con acceso a campos y opciones de ajuste avanzado que no están disponibles en la pestaña *Formulario*.

Qué puedes hacer con el modo experto

El modo experto es útil cuando necesitas actualizar un ajuste que no está disponible en la pestaña *Formulario*, como cambiar a un modelo de IA específico, ajustar el comportamiento de la voz o perfeccionar la gestión de llamadas. Abre la pestaña *Avanzado*, localiza el campo correspondiente, actualiza el valor y guarda.

Cómo se relaciona el modo experto con la pestaña Formulario

La pestaña Formulario y la pestaña *Avanzado* muestran la misma configuración de dos formas distintas. Cualquier ajuste que configures en la pestaña *Formulario* también está presente en el JSON, y los cambios realizados en una pestaña se reflejan en la otra. El modo experto amplía lo que ofrece la pestaña *Formulario*. La pestaña *Avanzado* expone campos adicionales para ajustar el comportamiento del modelo de IA, la calidad de la voz y la gestión de llamadas que no aparecen en la pestaña *Formulario*.

Campos disponibles en las dos pestañas

Los siguientes campos se pueden configurar tanto en la pestaña *Formulario* como en la pestaña *Avanzado*. **Personalidad** | **Etiqueta de la pestaña *Formulario*** | **Campo JSON** | **Qué configura** | | - | - | - | | Nombre | `agentName` | El nombre visible del VoiceAgent | | Dirección | `direction` | Indica si el agente gestiona llamadas entrantes o salientes. Valores aceptados: `"inbound"` o `"outbound"`. | | Idioma | `language` | El idioma en el que habla el VoiceAgent | | Idiomas adicionales | `secondaryLanguages` | Idiomas adicionales que el VoiceAgent puede detectar y a los que puede cambiar durante una llamada. Opcional. | | Voz | `voice` | La voz que utiliza el VoiceAgent | | Saludo | `greeting` | La frase exacta que dice el VoiceAgent al inicio de la llamada. Si se deja vacío, los agentes para llamadas entrantes recurren a un mensaje predeterminado genérico; los agentes para llamadas salientes empiezan en silencio. | **Fuentes de conocimiento** | **Etiqueta de la pestaña *Formulario*** | **Campo JSON** | **Qué configura** | | - | - | - | | Bases de conocimiento | `knowledgeBaseIds` | Bases de conocimiento que el VoiceAgent puede usar para responder preguntas | **Comportamiento** | **Etiqueta de la pestaña *Formulario*** | **Campo JSON** | **Qué configura** | | - | - | - | | Prompt de objetivo | `goalPrompt` | Las instrucciones principales que definen el comportamiento del VoiceAgent durante una llamada | | Habilidades | `skills` | Funciones estructuradas: Transferir a persona, Tomar un mensaje, Extraer información, Responder preguntas, Reserva de citas | | Escenarios | `scenarios` | Cómo responde el VoiceAgent a situaciones específicas, incluido el final de la llamada | | Barreras de seguridad | `guardrails` | Respuestas fijas para situaciones que requieren una respuesta coherente sin importar el contexto |

Campos exclusivos del modo experto

Los siguientes campos solo están disponibles en la pestaña *Avanzado*.

Estilo de conversación

Estos dos campos controlan cómo habla el VoiceAgent. Son opcionales: si no los configuras, CloudTalk aplica valores predeterminados que coinciden con el comportamiento actual del VoiceAgent. Después de la próxima vez que guardes, los dos campos aparecerán automáticamente en el JSON con sus valores predeterminados. Esto es normal.
**Campo** **Qué configura** **Valores**
`tone` Cómo suena el VoiceAgent. Una lista de estilos predefinidos; se pueden combinar, pero lo mejor es usar uno o dos (cada estilo adicional diluye los demás). El orden no importa, los duplicados se eliminan automáticamente y no se aceptan valores de texto libre. `"professional"`, `"friendly"`, `"casual"`, `"calm"`, `"empathetic"`, `"direct"`. Opcional; el valor predeterminado es `["friendly", "direct"]`.
`verbosity` Cuánto dice el VoiceAgent en cada respuesta. `"concise"` = la respuesta útil más breve. `"standard"` = una o dos frases, con más información si es necesario. `"thorough"` = respuestas más completas con contexto útil (aun así breves; es una llamada telefónica). `"concise"` / `"standard"` / `"thorough"`. Opcional; el valor predeterminado es `"standard"`.
**Guía de estilos predefinidos:** | **Estilo predefinido** | **Efecto** | | - | - | | `professional` | Mesurado, preciso y respetuoso | | `friendly` | Cálido y cercano | | `casual` | Relajado e informal, como un compañero dispuesto a ayudar | | `calm` | Estable, tranquilo y paciente | | `empathetic` | Reconoce los sentimientos de la persona que llama antes de pasar a las soluciones | | `direct` | Va directo a la respuesta y reduce las formalidades al mínimo | Independientemente del tono y la extensión de las respuestas, el VoiceAgent siempre es breve en los momentos operativos: confirmaciones, repeticiones de datos, despedidas y pasos de transferencia o reserva. Si estableces un valor no admitido, se muestra un mensaje de validación con los valores permitidos y la configuración no se guarda.

Modelo de IA

| **Campo** | **Qué configura** | | - | - | | `llmOverride` | Fija un modelo de IA específico en lugar de usar la selección automática. Consulta la lista de modelos admitidos más abajo. | | `providerOverride` | Fuerza un proveedor de voz específico (`"elevenlabs"` o `"deepgram"`). En la mayoría de los casos no es necesario configurarlo manualmente, ya que el idioma determina el proveedor automáticamente. | | `temperature` | Controla la variedad de las respuestas del VoiceAgent. Acepta valores de `0.0` a `1.0`. Para agentes profesionales o estructurados, se recomienda un valor entre `0.1` y `0.3`. Obligatorio. | **Modelos admitidos para `llmOverride`** | **Modelo** | **Valor** | | - | - | | GPT-4o Mini | `openai - gpt-4o-mini` | | GPT-4o | `openai - gpt-4o` | | GPT-4.1 | `openai - gpt-4.1` | | GPT-4.1 Mini | `openai - gpt-4.1-mini` | | GPT-4.1 Nano | `openai - gpt-4.1-nano` | | GPT-5 | `openai - gpt-5` | | GPT-5 Mini | `openai - gpt-5-mini` | | GPT-5 Nano | `openai - gpt-5-nano` | | GPT-5.1 | `openai - gpt-5.1` | | Claude 3 Haiku | `anthropic - claude-3-haiku` | | Claude Haiku 4.5 | `anthropic - claude-haiku-4-5` | | Claude 3.7 Sonnet | `anthropic - claude-3-7-sonnet` | | Gemini 2.0 Flash Lite | `google - gemini-2.0-flash-lite` | | Gemini 1.5 Pro | `google - gemini-1.5-pro` |

Ajuste de voz

| **Campo** | **Qué configura** | **Valores** | | - | - | - | | `stability` | Controla la consistencia de la voz del VoiceAgent durante la llamada. Los valores más altos producen una voz más estable. | `0.0`–`1.0`. Obligatorio. | | `similarity` | Controla cuánto se parece la voz al modelo de voz original. | `0.0`–`1.0`. Obligatorio. | | `optimizeStreamingLatency` | Sacrifica calidad de voz a cambio de menor latencia de respuesta. Los valores más altos reducen la latencia, pero pueden afectar a la calidad. No establezcas este valor en `4`, ya que desactiva la normalización de texto y provoca que los números y las fechas se pronuncien mal. | `0`–`4`. Obligatorio. |

Comportamiento de la llamada

| **Campo** | **Qué configura** | **Valores** | | - | - | - | | `maxCallDuration` | Establece un límite estricto para la duración de la llamada en minutos. | Recomendado: de 3 a 5 minutos para llamadas salientes, de 15 a 30 minutos para llamadas entrantes. Obligatorio. | | `dialTime` | Cuánto tiempo espera el VoiceAgent a que se conteste en llamadas salientes antes de darse por vencido. | `5`–`120` segundos. Opcional. |

Ajuste avanzado de ElevenLabs

Estos ajustes solo se aplican cuando tu VoiceAgent usa ElevenLabs, que es la opción predeterminada para la mayoría de las configuraciones de idioma. | **Campo** | **Qué configura** | **Valores** | | - | - | - | | `speculativeTurn` | El VoiceAgent empieza a preparar su respuesta antes de que la persona que llama termine de hablar, lo que reduce la latencia de respuesta percibida. | `true` / `false` | | `turnEagerness` | Controla con qué rapidez toma el turno el VoiceAgent cuando la persona que llama hace una pausa. | `"patient"` / `"normal"` / `"eager"` | | `turnModel` | Define la versión del modelo de detección de turnos que se utiliza. | `"turn_v2"` / `"turn_v3"` | | `vad` | Filtra el ruido de fondo para que no provoque una respuesta involuntaria. | `true` / `false` | | `asrKeywords` | Palabras o frases que se priorizan en el reconocimiento de voz. Útil para nombres de producto o terminología técnica. | Lista de cadenas de texto | | `interruptionIgnoreTerms` | Expresiones breves de confirmación de la persona que llama (por ejemplo, sonidos de asentimiento) que no deben contar como interrupción, de modo que el VoiceAgent siga hablando a pesar de ellas. Se escriben en el idioma de la persona que llama. | Lista de cadenas de texto. Opcional. | | `interruptionIgnoreTermLanguages` | Los idiomas en los que se buscan estas expresiones. | Lista de códigos de idioma. Opcional. | | `backgroundSound` | Reproduce un sonido ambiente de fondo mientras habla el VoiceAgent. | Objeto: `preset` (obligatorio cuando se configura backgroundSound; uno de `"office"`, `"office2"`, `"restaurant"`, `"city"`, `"typing"`, `"elevator"`, `"elevator2"`, `"elevator3"`, `"elevator4"`), `volume` (`0.0`–`1.0`, opcional), `crossfadeLoop` (`true`/`false`, opcional; repite el sonido en bucle sin cortes). | En la pestaña *Avanzado*, estos campos deben colocarse dentro de un objeto `elevenLabsSettings`. No van en el nivel raíz de la configuración. A continuación tienes un ejemplo de cómo anidarlos: ```json theme={"system"} { "agentName": "Clinic Reception", "direction": "inbound", "language": "es", "temperature": 0.2, "elevenLabsSettings": { "speculativeTurn": true, "turnEagerness": "patient", "turnModel": "turn_v3", "vad": true, "asrKeywords": ["Capil Clinic", "injerto capilar", "Barcelona"], "interruptionIgnoreTerms": ["vale", "sí", "ajá"], "interruptionIgnoreTermLanguages": ["es"], "backgroundSound": { "preset": "office", "volume": 0.3, "crossfadeLoop": true } } } ``` Cuando una configuración guardada incluye `elevenLabsSettings`, el objeto enviado sustituye al que estaba guardado. Para borrar un único subcampo, omítelo del objeto enviado. Si omites `elevenLabsSettings` por completo, se conserva la configuración guardada. Estos campos deben colocarse dentro de `elevenLabsSettings`; en el nivel raíz no se reconocen y el guardado falla con un error de validación.

Importar y exportar configuraciones

Puedes exportar una configuración desde la pestaña *Avanzado* e importarla en otro VoiceAgent, o compartirla con otro usuario para que la importe en su cuenta. La mayoría de las configuraciones se importan de inmediato sin necesidad de ninguna configuración adicional. La excepción es cuando una configuración hace referencia a recursos específicos de tu cuenta, como una base de conocimiento, una herramienta personalizada, un número de teléfono o una integración de calendario. Estas conexiones deben configurarse manualmente después de la importación. Después de cualquier importación correcta, guarda el VoiceAgent dos veces. Hay un conjunto conocido de casos límite que solo aparece después de la segunda vez que guardas. Las configuraciones exportadas ahora incluyen `tone` y `verbosity`. Si una configuración importada contiene un valor no admitido para estos campos (o cualquier otro), la importación se rechaza con un mensaje que indica el campo y los valores permitidos. *** *¿Necesitas ayuda o tienes alguna pregunta?* Ponte en contacto con nosotros a través de nuestro [Portal de atención al cliente](https://support.cloudtalk.io/hc/en-us/requests/new?ticket_form_id=26305535257884) — estamos aquí para ayudarte. ## Related topics - [Plantillas de VoiceAgent: Recepcionista IA](/es/articles/14057883-voiceagent-templates-ai-receptionist.md) - [Cómo activar una llamada de VoiceAgent desde Freshdesk](/es/articles/15457387-triggering-a-voiceagent-call-from-freshdesk.md) - [Base de conocimiento para VoiceAgents](/es/articles/11204159-knowledge-base-for-voiceagents.md) This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.