> This is a page from the ElevenLabs documentation. For a complete page index, fetch https://elevenlabs.io/docs/llms.txt. For the full documentation in a single file, fetch https://elevenlabs.io/docs/llms-full.txt.

### ElevenAgents

- **API de variables de entorno**: Nuevas rutas de API de [variables de entorno](/docs/es/eleven-agents/integrate/environment-variables) para gestionar la configuración a nivel de espacio de trabajo a la que los agentes pueden hacer referencia en tiempo de ejecución mediante plantillas `{{system_env__<label>}}`. Admite tipos de variables de cadena, secretas y de conexión de autenticación, con anulaciones de valores por entorno. Las rutas incluyen [crear](/docs/es/api-reference/environment-variables/create), [listar](/docs/es/api-reference/environment-variables/list), [obtener](/docs/es/api-reference/environment-variables/get) y [actualizar](/docs/es/api-reference/environment-variables/update).

- **Gestión de conexiones de autenticación**: Nueva API de conexiones de autenticación a nivel de espacio de trabajo para gestionar las credenciales de autenticación que usan las herramientas e integraciones de los agentes. Admite varios métodos de autenticación, como credenciales de cliente OAuth2, JWT, autenticación básica, tokens bearer, encabezados personalizados y flujos de código de autorización OAuth2 gestionados por integraciones. Las rutas incluyen operaciones de creación, listado y eliminación.

- **Actualización de URL de la base de conocimientos**: Nueva ruta de [actualización](/docs/es/api-reference/knowledge-base/refresh) (`POST /v1/convai/knowledge-base/{documentation_id}/refresh`) para volver a obtener y actualizar el contenido de los documentos de la base de conocimientos procedentes de URL. Los documentos de la base de conocimientos también admiten ahora la configuración de sincronización automática con los campos `enable_auto_sync`, `auto_remove` y `auto_sync_info`.

- **Reintento de guardrail con comentarios**: Los guardrails personalizados y de contenido ahora admiten [acciones de activación](/docs/es/eleven-agents/best-practices/guardrails) configurables con las opciones `EndCallTriggerAction` y `RetryTriggerAction`. Al configurarlo para reintentar, el agente vuelve a generar su respuesta con comentarios del sistema inyectados, hasta un máximo de 3 intentos. Los marcadores disponibles incluyen `{{trigger_reason}}` y `{{agent_message}}` para ofrecer indicaciones contextuales durante el reintento.

- **Variable del sistema de historial de conversación**: Se ha añadido una nueva variable dinámica `system__conversation_history` que proporciona un historial de conversación evaluado de forma diferida y serializado en JSON durante la ejecución. Resulta útil para pasar el contexto completo de la conversación a herramientas, webhooks o transferencias a subagentes.

- **Tipo de contenido de herramientas de webhook**: Las herramientas de servidor ahora admiten un [tipo de contenido](/docs/es/eleven-agents/customization/tools/server-tools) configurable para los parámetros del cuerpo de los webhooks, lo que te permite elegir entre los formatos `application/json` y `application/x-www-form-urlencoded`. El formato codificado en URL resulta útil para integrarse con sistemas heredados, rutas de tokens OAuth y procesadores de pagos.

- **Mensajes salientes de WhatsApp**: Hemos actualizado la integración de WhatsApp con un nuevo [cuadro de diálogo de mensajes salientes](/docs/es/eleven-agents/whatsapp) en el panel, que permite a los agentes enviar mensajes salientes además de realizar llamadas a través del canal de WhatsApp.

- **Filtros para listar agentes y recursos**: Las rutas para [listar agentes](/docs/es/api-reference/agents/list), [listar documentos de la base de conocimientos](/docs/es/api-reference/knowledge-base/list) y [listar herramientas](/docs/es/api-reference/tools/list) ahora admiten un parámetro de consulta `created_by_user_id` (usa `@me` para el usuario actual). Los parámetros anteriores `show_only_owned_agents` y `show_only_owned_documents` están obsoletos.

- **Expresiones condicionales de workflows**: Se ha añadido un nuevo nodo AST `conditional_operator` al esquema de expresiones de workflows, lo que permite lógica de ramificación en las definiciones de workflows de agentes.

### Música

- **Music Marketplace**: Nueva documentación de [Music Marketplace](/docs/es/overview/capabilities/music/marketplace) que explica el mercado para licenciar música generada con IA, incluidos los tipos de uso, los pagos a creadores y los detalles de las licencias.

### Lanzamientos de SDK

#### SDK de Python

- [v2.40.0](https://github.com/elevenlabs/elevenlabs-python/releases/tag/v2.40.0) - Se ha añadido compatibilidad con el parámetro `environment` para las conversaciones de ElevenAgents, lo que permite conexiones de agentes específicas por entorno. Regeneración de Fern para ajustarse al esquema de API más reciente, incluidas variables de entorno, conexiones de autenticación, actualización de la base de conocimientos y acciones de activación de guardrails.

#### SDK de JavaScript

- [v2.40.0](https://github.com/elevenlabs/elevenlabs-js/releases/tag/v2.40.0) - Se ha añadido el tipo de evento WebSocket `multimodal_message` para las conversaciones en tiempo real de ElevenAgents. Regeneración de Fern para ajustarse al esquema de API más reciente, incluidas variables de entorno, conexiones de autenticación, actualización de la base de conocimientos y acciones de activación de guardrails.

#### SDK de iOS

- [v3.1.1](https://github.com/elevenlabs/elevenlabs-swift-sdk/releases/tag/v3.1.1) - Se ha añadido compatibilidad con el parámetro `environment` para conexiones de agentes específicas por entorno. Se ha corregido un error de compilación de visionOS al elevar el requisito de plataforma a v2.

#### Paquetes

- [@elevenlabs/types@0.6.1](https://github.com/elevenlabs/packages/releases/tag/@elevenlabs/types@0.6.1) - Se ha añadido el tipo de evento WebSocket `multimodal_message` para las conversaciones en tiempo real de ElevenAgents.
- [@elevenlabs/client@0.15.2](https://github.com/elevenlabs/packages/releases/tag/@elevenlabs/client@0.15.2) - Se ha añadido compatibilidad con el evento WebSocket `multimodal_message`.
- [@elevenlabs/react@0.14.3](https://github.com/elevenlabs/packages/releases/tag/@elevenlabs/react@0.14.3) - Se ha añadido compatibilidad con el evento WebSocket `multimodal_message`.
- [@elevenlabs/convai-widget-core@0.10.4](https://github.com/elevenlabs/packages/releases/tag/@elevenlabs/convai-widget-core@0.10.4), [@elevenlabs/convai-widget-core@0.10.5](https://github.com/elevenlabs/packages/releases/tag/@elevenlabs/convai-widget-core@0.10.5) - Actualizado a `@elevenlabs/client@0.15.2`.
- [@elevenlabs/convai-widget-embed@0.10.4](https://github.com/elevenlabs/packages/releases/tag/@elevenlabs/convai-widget-embed@0.10.4), [@elevenlabs/convai-widget-embed@0.10.5](https://github.com/elevenlabs/packages/releases/tag/@elevenlabs/convai-widget-embed@0.10.5) - Actualizado a `@elevenlabs/client@0.15.2`.

#### Candidato a lanzamiento de paquetes v1.0.0

Ya está disponible el primer candidato a lanzamiento de la versión v1.0.0 de los SDK de cliente de ElevenAgents. Es una versión principal con cambios incompatibles que mejoran la superficie de la API, añaden hooks granulares de React para un mejor rendimiento de renderizado y unifican el SDK de React Native con el SDK de React.

Para probar el candidato a lanzamiento:

```bash
npm install @elevenlabs/client@next @elevenlabs/react@next @elevenlabs/react-native@next
```

Hay disponible una skill [`elevenlabs:sdk-migration`](https://github.com/elevenlabs/packages/blob/main/.agents/skills/elevenlabs%3Asdk-migration/SKILL.md) para ayudar a los asistentes de programación con IA a migrar automáticamente tu base de código a las nuevas API. Añádela a tu proyecto de Claude Code, Cursor o Windsurf para recibir ayuda guiada durante la migración.

Cambios principales en v1.0.0:

- **`@elevenlabs/client`**: `Conversation` ahora es un objeto de espacio de nombres y un alias de tipo para `TextConversation | VoiceConversation`, en lugar de una clase. Las clases `Input` y `Output` se sustituyen por las interfaces `InputController` y `OutputController`, con nuevos métodos prácticos en la instancia de conversación (`setMicMuted()`, `setVolume()`, `getInputByteFrequencyData()`, `getOutputByteFrequencyData()`). `changeInputDevice()` y `changeOutputDevice()` ahora devuelven `void`.
- **`@elevenlabs/react`**: `useConversation` ahora requiere un antecesor `ConversationProvider`. Nuevos hooks granulares para una renderización detallada: `useConversationControls()`, `useConversationStatus()`, `useConversationInput()`, `useConversationMode()`, `useConversationFeedback()`. Nuevo hook `useConversationClientTool()` para registrar dinámicamente herramientas de cliente desde componentes de React con total seguridad de tipos.
- **`@elevenlabs/react-native`**: Reescritura completa de la API que sustituye `ElevenLabsProvider` y `useConversation` por `ConversationProvider` y los mismos hooks granulares de `@elevenlabs/react`. Los polyfills de WebRTC y la configuración nativa de AudioSession se aplican automáticamente al importar.

Consulta las notas completas de lanzamiento y las guías de migración:

- [@elevenlabs/client@1.0.0-rc.1](https://github.com/elevenlabs/packages/releases/tag/@elevenlabs/client@1.0.0-rc.1)
- [@elevenlabs/react@1.0.0-rc.1](https://github.com/elevenlabs/packages/releases/tag/@elevenlabs/react@1.0.0-rc.1)
- [@elevenlabs/react-native@1.0.0-rc.1](https://github.com/elevenlabs/packages/releases/tag/@elevenlabs/react-native@1.0.0-rc.1)
- [@elevenlabs/types@0.7.0-rc.0](https://github.com/elevenlabs/packages/releases/tag/@elevenlabs/types@0.7.0-rc.0)

### API

<Accordion title="Ver cambios de la API">

## Nuevas rutas

### ElevenAgents

- [Crear variable de entorno](/docs/es/api-reference/environment-variables/create) - `POST /v1/convai/environment-variables` - Crea una nueva variable de entorno de tipo cadena, secreto o conexión de autenticación
- [Listar variables de entorno](/docs/es/api-reference/environment-variables/list) - `GET /v1/convai/environment-variables` - Lista todas las variables de entorno del espacio de trabajo
- [Obtener variable de entorno](/docs/es/api-reference/environment-variables/get) - `GET /v1/convai/environment-variables/{env_var_id}` - Obtiene una variable de entorno específica
- [Actualizar variable de entorno](/docs/es/api-reference/environment-variables/update) - `PATCH /v1/convai/environment-variables/{env_var_id}` - Actualiza una variable de entorno, incluida la eliminación de valores por entorno mediante `null`
- [Actualizar contenido de documento URL](/docs/es/api-reference/knowledge-base/refresh) - `POST /v1/convai/knowledge-base/{documentation_id}/refresh` - Vuelve a obtener contenido para documentos de la base de conocimientos procedentes de URL

### Espacios de trabajo

- `POST /v1/workspace/auth-connections` - Crea una conexión de autenticación del espacio de trabajo con compatibilidad con métodos de autenticación OAuth2, JWT, básica, bearer, encabezado personalizado y gestionados por integraciones
- `GET /v1/workspace/auth-connections` - Lista todas las conexiones de autenticación del espacio de trabajo con información de dependencias (herramientas, servidores MCP y conexiones de integración)
- `DELETE /v1/workspace/auth-connections/{auth_connection_id}` - Elimina una conexión de autenticación del espacio de trabajo

### Voz a Texto

- `GET /v1/speech-to-text/evaluation/eval-criteria` - Lista criterios de evaluación
- `POST /v1/speech-to-text/evaluation/eval-criteria` - Crea un criterio de evaluación
- `GET /v1/speech-to-text/evaluation/eval-criteria/{criterion_id}` - Obtiene un criterio de evaluación específico
- `PATCH /v1/speech-to-text/evaluation/eval-criteria/{criterion_id}` - Actualiza un criterio de evaluación
- `DELETE /v1/speech-to-text/evaluation/eval-criteria/{criterion_id}` - Elimina un criterio de evaluación
- `POST /v1/speech-to-text/evaluation/evaluations` - Activa una evaluación
- `GET /v1/speech-to-text/evaluation/evaluations` - Lista evaluaciones
- `GET /v1/speech-to-text/evaluation/evaluations/{evaluation_id}` - Obtiene una evaluación específica
- `GET /v1/speech-to-text/evaluation/human-agents` - Lista agentes humanos
- `GET /v1/speech-to-text/evaluation/human-agents/{agent_id}` - Obtiene un agente humano
- `DELETE /v1/speech-to-text/evaluation/human-agents/{agent_id}` - Elimina un agente humano
- `GET /v1/speech-to-text/evaluation/analytics` - Obtiene analíticas de evaluación
- `GET /v1/speech-to-text/evaluation/eval-criteria/{criterion_id}/analytics` - Obtiene analíticas de un criterio específico
- `GET /v1/speech-to-text/evaluation/human-agents/{agent_id}/analytics` - Obtiene analíticas de un agente humano específico

## Rutas actualizadas

### ElevenAgents

- [Obtener URL firmada](/docs/es/api-reference/conversations/get-signed-url), [Obtener token de conversación](/docs/es/api-reference/conversations/get-webrtc-token)

  - Se ha añadido el parámetro de consulta `environment` (cadena, opcional) para la resolución específica por entorno

- [Listar agentes](/docs/es/api-reference/agents/list)

  - Se ha añadido el parámetro de consulta `created_by_user_id` (cadena, opcional, admite `@me`)
  - `show_only_owned_agents` está obsoleto en favor de `created_by_user_id`

- [Listar documentos de la base de conocimientos](/docs/es/api-reference/knowledge-base/list)

  - Se ha añadido el parámetro de consulta `created_by_user_id` (cadena, opcional, admite `@me`)
  - `show_only_owned_documents` está obsoleto en favor de `created_by_user_id`

- [Listar herramientas](/docs/es/api-reference/tools/list)

  - Se ha añadido el parámetro de consulta `created_by_user_id` (cadena, opcional, admite `@me`)
  - `show_only_owned_documents` está obsoleto en favor de `created_by_user_id`

- [Obtener fragmento de la base de conocimientos](/docs/es/api-reference/knowledge-base/get-chunk)

  - Se ha añadido el parámetro de consulta `embedding_model` (cadena, opcional) para especificar el modelo de embeddings para recuperar fragmentos

- [Crear agente](/docs/es/api-reference/agents/create), [Actualizar agente](/docs/es/api-reference/agents/update), [Crear borrador](/docs/es/api-reference/agents/drafts/create)

  - Se ha añadido compatibilidad con `guardrail_trigger_action` mediante los esquemas `EndCallTriggerAction` y `RetryTriggerAction`
  - Se ha añadido el nodo AST `conditional_operator` a las definiciones de expresiones de workflows
  - Los esquemas de agentes ahora admiten `ConvAIEnvVarLocator` y `EnvironmentAuthConnectionLocator` para hacer referencia a variables de entorno en configuraciones de herramientas

- [Llamada saliente de troncal SIP](/docs/es/api-reference/sip-trunk/outbound-call)

  - Se ha actualizado el esquema de solicitud para incluir nuevos campos relacionados con el entorno

- [Simular conversación](/docs/es/api-reference/agents/simulate-conversation), [Simular flujo de conversación](/docs/es/api-reference/agents/simulate-conversation-stream)

  - Se ha añadido el campo `simulation_environment` al esquema de solicitud

## Cambios de esquema

### Nuevos esquemas

- `ConvAIEnvironmentVariable`, `ConvAIEnvironmentVariableCreate`, `ConvAIEnvironmentVariableUpdate` - Modelos de variables de entorno compatibles con tipos de cadena, secreto y conexión de autenticación
- `ConvAIEnvVarLocator`, `EnvironmentAuthConnectionLocator` - Localizadores para hacer referencia a variables de entorno en configuraciones de herramientas y servidores MCP
- `EndCallTriggerAction`, `RetryTriggerAction` - Esquemas de acciones de activación de guardrails para los comportamientos de finalizar llamada y reintentar con comentarios
- `ConditionalOperator` - Nuevo nodo AST para expresiones condicionales en workflows de agentes
- `AuthConnectionCreateRequest`, `AuthConnectionResponse`, `AuthConnectionDependencies` - Esquemas de gestión de conexiones de autenticación de espacios de trabajo compatibles con métodos de autenticación OAuth2, JWT, básica, bearer, encabezado personalizado, WhatsApp y gestionados por integraciones
- `SpeechToTextEvaluation*` - Conjunto de esquemas para criterios de evaluación de voz a texto, evaluaciones, agentes humanos y analíticas

### Esquemas modificados

- `MCPServerConfig`, `MCPServerConfigOutput` - Se ha añadido compatibilidad con referencias `ConvAIEnvVarLocator` en la configuración del servidor
- `CustomGuardrailConfig` - Se ha añadido el campo `trigger_action` para configurar el comportamiento de finalizar llamada o reintentar
- `Contributor` - Se han añadido los campos opcionales `bio` (cadena) y `profile_id` (cadena)
- `ASTLLMNode` - Se ha añadido el campo `value_schema`; el campo `prompt` está obsoleto en favor de `value_schema`
- `TelephonyDirection` - Se ha refactorizado como una enumeración compartida a la que hacen referencia varios modelos de conversación y telefonía

</Accordion>