Changelog

Nuevas rutas de API

ElevenAgents

• Se han añadido nueve rutas de API para tickets de triaje de conversaciones:
  • Crear ticket de conversación - 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 - GET /v1/convai/agents/{agent_id}/triage-tickets, con paginación mediante cursor.
  • Crear ticket manual - POST /v1/convai/agents/{agent_id}/triage-tickets. La solicitud requiere qa_comment (cadena, de 1 a 10.000 caracteres).
  • Listar usuarios asignables - 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 - GET /v1/convai/triage-tickets/{agentqa_ticket_id}.
  • Actualizar ticket - PATCH /v1/convai/triage-tickets/{agentqa_ticket_id}. La solicitud acepta status opcional y assignee_user_id anulable.
  • Eliminar ticket - DELETE /v1/convai/triage-tickets/{agentqa_ticket_id}.
  • Añadir comentario - 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 - 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 - 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 - 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 - 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 - 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 - 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 (GET /v1/convai/agents/{agent_id}/branches/{branch_id}/procedures) y Obtener procedimiento (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 y Actualizar prueba
  • 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, Crear tarea de rastreo y Crear carpeta
  • 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 - 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 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.