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

import { YoutubeEmbed } from "../../../components/YoutubeEmbed";

### CLI de ElevenLabs

Ya está disponible la [CLI de ElevenLabs v1.0.0](https://github.com/elevenlabs/cli/releases/tag/v1.0.0). Todas las operaciones de la API de ElevenLabs están disponibles como subcomandos, con salida en JSON, tabla, YAML y CSV, paginación automática y completado de shell.

La CLI también ofrece flujos de trabajo de configuración local para ElevenAgents. Guarda las configuraciones de agentes, herramientas y pruebas como archivos, sincronízalas con comandos push y pull, gestiona ramas, ejecuta pruebas, instala componentes de interfaz de ElevenLabs y selecciona una región de residencia de datos.

<YoutubeEmbed id="MuORAEVtJIQ" />

<CardGroup cols={1}>
  <Card
    title="Documentación de la CLI"
    icon="duotone book"
    href="/docs/es/eleven-agents/operate/cli"
  >
    Instala la CLI, autentícate y gestiona agentes como código.
  </Card>
</CardGroup>

### Procedimientos

Los procedimientos ya están disponibles de forma general en ElevenAgents. Un procedimiento contiene instrucciones específicas para una tarea y un desencadenante que determina cuándo se aplican. Durante una conversación, el agente carga el procedimiento pertinente, lo que permite a un mismo agente gestionar tareas distintas sin incluir todas las instrucciones en su prompt de sistema.

Usa procedimientos de formato libre cuando el agente pueda adaptar la redacción o el orden de las instrucciones. Usa procedimientos estructurados cuando los pasos deban ejecutarse en un orden definido. Ambos tipos se pueden usar junto con workflows en el mismo agente.

<CardGroup cols={3}>
  <Card
    title="Resumen de procedimientos"
    icon="duotone book"
    href="/docs/es/eleven-agents/customization/procedures"
  >
    Descubre cuándo usar procedimientos y cómo se comparan con prompts y workflows.
  </Card>
  <Card
    title="Procedimientos de formato libre"
    icon="duotone code"
    href="/docs/es/eleven-agents/customization/procedures/free-form-procedures"
  >
    Escribe instrucciones en lenguaje natural que el agente pueda adaptar a la conversación.
  </Card>
  <Card
    title="Procedimientos estructurados"
    icon="duotone list-check"
    href="/docs/es/eleven-agents/customization/procedures/structured-procedures"
  >
    Define pasos tipados que el agente seguirá en un orden coherente.
  </Card>
</CardGroup>

### ElevenAgents

- **Tickets de triaje de conversaciones**: Se han añadido API para crear tickets sobre el rendimiento de los agentes, crear tickets manuales de seguimiento, listar tickets, asignar miembros del espacio de trabajo, actualizar el estado y la persona asignada, y añadir comentarios a nivel de ticket o de turno.
- **Observabilidad de conversaciones**: Los clientes en tiempo real pueden recibir un evento `context_usage` después de cada turno del agente completado. El evento informa del modelo, el número de tokens del prompt y el límite de contexto del modelo.

### Lanzamientos de SDK

#### SDK de JavaScript

- [v2.65.0](https://github.com/elevenlabs/elevenlabs-js/releases/tag/v2.65.0) - Se han añadido clientes y tipos para tickets de triaje de conversaciones y resúmenes ligeros de conversaciones. Las API de conversaciones añaden filtros de procedimiento, llamada a herramienta no válida y ordenación; las API de procedimientos añaden selección de versión del agente; las API de temas añaden controles de detalles de evaluación y ordenación por frustración. El lanzamiento también añade campos de frecuencia de actualización de la base de conocimientos, entorno de pruebas e integración de alertas, además de tipos de mensajes de Doblaje en tiempo real.

#### SDK de Python

- [v2.65.0](https://github.com/elevenlabs/elevenlabs-python/releases/tag/v2.65.0) - Se han añadido clientes y tipos para tickets de triaje de conversaciones y resúmenes ligeros de conversaciones. Las API de conversaciones añaden filtros de procedimiento, llamada a herramienta no válida y ordenación; las API de procedimientos añaden selección de versión del agente; las API de temas añaden controles de detalles de evaluación y ordenación por frustración. El lanzamiento también añade campos de frecuencia de actualización de la base de conocimientos, entorno de pruebas e integración de alertas, y conserva campos multipartes repetidos para `keyterms` de Voz a Texto y `webhook_ids` de Doblaje.

#### SDK de Swift

- [v3.3.0](https://github.com/elevenlabs/elevenlabs-swift-sdk/releases/tag/v3.3.0) - Se han añadido análisis tipado de errores de cliente, gestión de `expects_response` y resultados de herramientas con seguridad de tipos. El inicio de WebRTC ahora está listo cuando se une el agente, en lugar de esperar a la suscripción de la pista de audio. El lanzamiento también refuerza la gestión de URL, elimina el ruido de eventos desconocidos y elimina la asignación de hilos en tiempo real del procesamiento de silencio por software.

#### Paquetes

- [@elevenlabs/client@1.19.1](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fclient%401.19.1), [@elevenlabs/react@1.12.3](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Freact%401.12.3), [@elevenlabs/react-native@1.2.21](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Freact-native%401.2.21), [@elevenlabs/convai-widget-core@0.16.2](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fconvai-widget-core%400.16.2) y [@elevenlabs/convai-widget-embed@0.16.2](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fconvai-widget-embed%400.16.2) - La captura de salida de WebRTC ahora utiliza rutas de AudioWorklet alojadas por el usuario con políticas estrictas de seguridad de contenido. La caché de worklets incluye la fuente solicitada, lo que evita que una URL en línea anterior sustituya una ruta alojada por el usuario. Los errores de configuración de React Native ahora apuntan a `@elevenlabs/react-native`.
- [@elevenlabs/client@1.20.0](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fclient%401.20.0), [@elevenlabs/react@1.12.4](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Freact%401.12.4), [@elevenlabs/react-native@1.2.22](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Freact-native%401.2.22), [@elevenlabs/convai-widget-core@0.16.3](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fconvai-widget-core%400.16.3) y [@elevenlabs/convai-widget-embed@0.16.3](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fconvai-widget-embed%400.16.3) - Se ha añadido `webRtc.iceTransportPolicy` opcional. Establécelo en `relay` para restringir los candidatos ICE de WebRTC a relés TURN en redes que bloquean el tráfico UDP directo.
- [@elevenlabs/client@1.21.0](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fclient%401.21.0), [@elevenlabs/react@1.13.0](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Freact%401.13.0), [@elevenlabs/types@0.21.1](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Ftypes%400.21.1), [@elevenlabs/react-native@1.2.23](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Freact-native%401.2.23), [@elevenlabs/convai-widget-core@0.16.4](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fconvai-widget-core%400.16.4) y [@elevenlabs/convai-widget-embed@0.16.4](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fconvai-widget-embed%400.16.4) - Se han añadido la devolución de llamada `onContextUsage` y el tipo `ContextUsageEvent`. React expone la devolución de llamada mediante `useConversation`. React Native ahora se resuelve mediante la condición de exportación de su paquete en lugar de la detección de variables globales del navegador.
- [@elevenlabs/client@1.22.0](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fclient%401.22.0), [@elevenlabs/react@1.14.0](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Freact%401.14.0), [@elevenlabs/types@0.22.0](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Ftypes%400.22.0), [@elevenlabs/react-native@1.2.24](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Freact-native%401.2.24), [@elevenlabs/convai-widget-core@0.17.0](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fconvai-widget-core%400.17.0) y [@elevenlabs/convai-widget-embed@0.17.0](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fconvai-widget-embed%400.17.0) - Se ha añadido contenido enriquecido en el primer mensaje con respuestas de botón atribuidas, `onExternalAgentDisconnected` y `onMCPToolApprovalRequest`. WebRTC ahora utiliza el dispositivo de entrada seleccionado, conserva el estado de silencio al cambiar de micrófono y falla la configuración si no se pueden enviar datos de inicio. El widget añade el estado de la cola de concurrencia, selección de idioma opcional en el activador contraído y representación del primer mensaje para agentes compatibles con texto y voz.

### API

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

## Nuevas rutas de API

### ElevenAgents

- Se han añadido nueve rutas de API para tickets de triaje de conversaciones:
  - [Crear ticket de conversación](/docs/es/api-reference/triage-tickets/create-agent-conversation-ticket-route) - `POST /v1/convai/triage-tickets`. La solicitud requiere `conversation_id` (cadena) y acepta `qa_comment` (cadena anulable, de 1 a 10.000 caracteres) y hasta 200 comentarios de turno.
  - [Listar tickets](/docs/es/api-reference/triage-tickets/list-agent-conversation-tickets-route) - `GET /v1/convai/agents/{agent_id}/triage-tickets`, con paginación mediante cursor.
  - [Crear ticket manual](/docs/es/api-reference/triage-tickets/create-manual-agent-ticket-route) - `POST /v1/convai/agents/{agent_id}/triage-tickets`. La solicitud requiere `qa_comment` (cadena, de 1 a 10.000 caracteres).
  - [Listar usuarios asignables](/docs/es/api-reference/triage-tickets/get-assignable-users-route) - `GET /v1/convai/agents/{agent_id}/triage-tickets/assignable-users`. La respuesta lista los miembros del espacio de trabajo que no son cuentas de servicio e indica si cada miembro tiene acceso al agente.
  - [Obtener ticket](/docs/es/api-reference/triage-tickets/get-agent-conversation-ticket-route) - `GET /v1/convai/triage-tickets/{agentqa_ticket_id}`.
  - [Actualizar ticket](/docs/es/api-reference/triage-tickets/update-agent-conversation-ticket-route) - `PATCH /v1/convai/triage-tickets/{agentqa_ticket_id}`. La solicitud acepta `status` opcional y `assignee_user_id` anulable.
  - [Eliminar ticket](/docs/es/api-reference/triage-tickets/delete-agent-conversation-ticket-route) - `DELETE /v1/convai/triage-tickets/{agentqa_ticket_id}`.
  - [Añadir comentario](/docs/es/api-reference/triage-tickets/add-ticket-comment-route) - `POST /v1/convai/triage-tickets/{agentqa_ticket_id}/comments`. La solicitud requiere `comment` (cadena, de 1 a 10.000 caracteres).
  - [Añadir comentario de turno](/docs/es/api-reference/triage-tickets/add-turn-comment-route) - `POST /v1/convai/triage-tickets/{agentqa_ticket_id}/turn-comments`. La solicitud requiere `turn_index` de índice cero (entero) y `comment` (cadena, de 1 a 10.000 caracteres).

## Rutas de API actualizadas

### ElevenAgents

- [Obtener URL firmada](/docs/es/api-reference/conversations/get-signed-url) - `GET /v1/convai/conversation/get-signed-url`
  - Se ha añadido `debug_events_request` opcional (booleano, valor predeterminado `false`). Los eventos de depuración requieren acceso de editor al agente.
- [Obtener token de WebRTC](/docs/es/api-reference/conversations/get-webrtc-token) - `GET /v1/convai/conversation/token`
  - Se ha añadido `debug_events_request` opcional (booleano, valor predeterminado `false`). La ruta heredada `GET /v1/convai/conversation/get_signed_url` acepta el mismo parámetro.
- [Listar conversaciones](/docs/es/api-reference/conversations/list) - `GET /v1/convai/conversations`
  - Se ha añadido `triggered_procedure_ids` opcional (matriz de cadenas anulable, máximo 50) para encontrar conversaciones en las que se ejecutó alguno de los procedimientos especificados.
  - Se ha añadido `include_invalid_tool_calls` opcional (booleano, valor predeterminado `false`) para incluir llamadas a herramientas que no se ejecutaron.
  - Se ha añadido `sort_direction` opcional (`asc` o `desc`, valor predeterminado `desc`) para la hora de inicio de la llamada.
- [Buscar mensajes de conversación por texto](/docs/es/api-reference/conversations/messages/text-search) - `GET /v1/convai/conversations/messages/text-search`
  - Se ha añadido `triggered_procedure_ids` opcional (matriz de cadenas anulable, máximo 50).
  - Se ha añadido `include_invalid_tool_calls` opcional (booleano, valor predeterminado `false`).
- [Obtener temas de conversación del agente](/docs/es/api-reference/conversations/topics/get) - `GET /v1/convai/agents/{agent_id}/topics`
  - Se ha añadido `include_evaluation_criteria` opcional (booleano, valor predeterminado `true`).
  - Se ha añadido `frustration` a `sort_by`.
  - Las respuestas de temas añaden `success_rate` anulable (número), mientras que la respuesta general añade `aggregated_run_count` (entero, valor predeterminado `0`).
  - `from_unix_secs` se redondea hacia abajo al inicio de su día UTC. Un intervalo delimitado agrega ejecuciones diarias de descubrimiento completadas; si se omiten ambos límites, devuelve la última ejecución.
- [Listar procedimientos](/docs/es/api-reference/agents/procedures/list) (`GET /v1/convai/agents/{agent_id}/branches/{branch_id}/procedures`) y [Obtener procedimiento](/docs/es/api-reference/agents/procedures/get) (`GET /v1/convai/agents/{agent_id}/branches/{branch_id}/procedures/{procedure_id}`)
  - Se ha añadido `agent_version_id` opcional y anulable (cadena) para recuperar procedimientos de una versión específica del agente.
- [Crear prueba](/docs/es/api-reference/tests/create) y [Actualizar prueba](/docs/es/api-reference/tests/update)
  - Se ha añadido `environment` opcional y anulable (cadena) a los esquemas de pruebas unitarias de respuesta, simulación y llamada a herramienta. El valor selecciona URL, encabezados y conexiones de autenticación específicos del entorno; el valor predeterminado es `production`.
- [Crear documento desde URL](/docs/es/api-reference/knowledge-base/create-from-url), [Crear tarea de rastreo](/docs/es/api-reference/knowledge-base/create-crawl-job) y [Crear carpeta](/docs/es/api-reference/knowledge-base/create-folder)
  - Se ha añadido `minimum_frequency_days` opcional y anulable (entero, de 1 a 180) para la sincronización automática. El valor predeterminado es `7`, y tiene prioridad una frecuencia más estricta de la carpeta principal.

### Música

- [Listar Finetunes de Música](/docs/es/api-reference/music/finetunes/list) - `GET /v1/music/finetunes`
  - El valor máximo de `page_size` ha aumentado de 100 a 150. El valor predeterminado sigue siendo 50.

## Cambios en los esquemas

### ElevenAgents

- Las solicitudes de actualización de agentes añaden `procedures` opcional y anulable (`object<string, ProcedureVersionRef>`). Cada valor requiere `procedure_id` y `version_id` (cadenas). Un objeto vacío elimina todos los procedimientos.
- La configuración de inicio de conversación añade `enable_procedure_ids_from_client` (booleano, valor predeterminado `false`). Los datos de inicio añaden `procedure_ids` opcional y anulable (matriz de cadenas); una matriz vacía desactiva todos los procedimientos del agente inicial.
- `ClientEvent` añade `context_usage`.
- Las anulaciones de tiempo de espera flexible añaden `additional_soft_timeout_messages` opcional y anulable (matriz de cadenas).
- Los valores constantes en los modelos de análisis y anulación de esquema ahora aceptan `null`.
- Los valores predeterminados de configuración del widget para `mic_muting_enabled` y `transcript_enabled` han cambiado de `false` a `true`. Establécelos explícitamente en `false` para conservar el comportamiento anterior.

### Espacio de trabajo

- Las respuestas de [Obtener usuario](/docs/es/api-reference/user/get) han eliminado `xi_api_key` de `UserResponseModel`.
- `ResourceMetadataResponseModel.role_to_group_ids` ahora acepta ID de roles personalizados como claves, en lugar de restringir las claves a `admin`, `editor`, `commenter` y `viewer`.
- Las respuestas de publicación directa añaden `restricted_to_user_email_domains` opcional y anulable (matriz de cadenas).
- Las respuestas de cambio de suscripción pendiente añaden `go` a `next_tier`.

</Accordion>