Eventos de servidor para la API Qwen-Omni-Realtime, incluidos eventos de llamada de herramientas (function calling).
Esta página es la referencia de eventos de Qwen-Omni-Realtime. Las definiciones de eventos se basan en la conexión mediante WebSocket. AOQ y WebRTC usan sus respectivos canales de datos para enviar y recibir eventos del modelo, y pistas de medios para transmitir medios. Primero consulte Conexión mediante WebSocket, Conexión mediante WebRTC o Conexión mediante AOQ.
error
Error del servidor.
event_idstringUn identificador único para este evento.typestringEl tipo de evento. Este valor siempre es error.errorobjectDetalles del error.
Propiedades type stringEl tipo de error.codestringEl código de error.messagestringEl mensaje de error.paramstringEl parámetro asociado con el error, como session.modalities. |
session.created
Se devuelve cuando un cliente se conecta. Contiene la configuración predeterminada de la sesión.
event_idstringUn identificador único para este evento.typestringEl tipo de evento. Este valor siempre es session.created.sessionobjectLa configuración de la sesión.
Propiedades object stringEste valor siempre es realtime.session.modelstringEl modelo utilizado.modalitiesarrayLas modalidades de salida para el modelo.voicestringLa voz para el audio generado por el modelo.input_audio_formatstringFormato de audio de entrada. Solo se admite pcm (frecuencia de muestreo de 16 kHz).output_audio_formatstringFormato de audio de salida. Solo se admite pcm (frecuencia de muestreo de 24 kHz).input_audio_transcriptionobjectLa configuración de transcripción.
Propiedades model stringModelo de transcripción. Siempre qwen3-asr-flash-realtime. No configurable.objectLa configuración de detección de actividad de voz (VAD).
Propiedades type stringEl tipo de VAD. Los valores válidos son server_vad (predeterminado) o semantic_vad. Consulte Eventos del cliente.thresholdfloatEl umbral de detección de VAD.silence_duration_msintegerDuración del silencio (ms) que activa la detección de fin de habla.idle_timeout_msintegerEl tiempo de espera de inactividad en milisegundos. Se devuelve solo en el modo server_vad con los modelos qwen3.5-omni-plus-realtime o qwen3.5-omni-flash-realtime.booleanSi se debe habilitar la búsqueda web. Compatible con los modelos Qwen3.8-Omni-Flash-Realtime y Qwen3.5-Omni-Realtime.search_optionsobjectLas opciones para la búsqueda web.temperaturefloatEl parámetro de temperatura para el modelo. | El siguiente ejemplo es la sesión predeterminada devuelta por qwen3.8-omni-flash-realtime en la región de Beijing. |
session.updated
Se devuelve después de una solicitud session.update exitosa. En caso de fallo, se devuelve un evento error en su lugar.
event_idstringUn identificador único para este evento.typestringEl tipo de evento. Este valor siempre es session.updated.sessionobjectLa configuración de la sesión.
Propiedades temperature floatEl parámetro de temperatura para el modelo.modalitiesarrayLas modalidades de salida para el modelo.voicestringLa voz para el audio generado por el modelo.instructionsstringEl objetivo y rol del modelo.input_audio_formatstringFormato de audio de entrada. Solo se admite pcm (frecuencia de muestreo de 16 kHz).output_audio_formatstringFormato de audio de salida. Solo se admite pcm (frecuencia de muestreo de 24 kHz).input_audio_transcriptionobjectLa configuración de transcripción.
Propiedades model stringModelo de transcripción. Siempre qwen3-asr-flash-realtime. No configurable.objectLa configuración de detección de actividad de voz (VAD).
Propiedades type stringEl tipo de VAD. Los valores válidos son server_vad (predeterminado) o semantic_vad. Consulte Eventos del cliente.thresholdfloatEl umbral de detección de VAD.silence_duration_msintegerDuración del silencio (ms) que activa la detección de fin de habla.idle_timeout_msintegerEl tiempo de espera de inactividad en milisegundos. Se devuelve solo en el modo server_vad con los modelos qwen3.5-omni-plus-realtime o qwen3.5-omni-flash-realtime.boolean (opcional)Si se debe habilitar la búsqueda web. Compatible con los modelos Qwen3.8-Omni-Flash-Realtime y Qwen3.5-Omni-Realtime.search_optionsobject (opcional)Las opciones de búsqueda web.toolsarray (opcional)Definiciones de herramientas. Las propiedades a continuación describen herramientas de Function Calling con type="function". Consulte configuración de herramientas del cliente para los campos MCP de Qwen3.8-Omni-Flash-Realtime; los endpoints y credenciales MCP no se reflejan en session.updated.
Propiedades type string (obligatorio)Este valor siempre es function.function.namestring (obligatorio)El nombre de la función, como get_current_weather o get_current_time.function.descriptionstring (opcional)Descripción del propósito de la función. El modelo usa esto para decidir si llamar a la función.function.parametersobject (opcional)Esquema de parámetros de entrada. El modelo usa esto para extraer parámetros. Omítalo si la función no toma parámetros.
Propiedades type string (obligatorio)Este valor siempre es object.propertiesobject (opcional)Cada clave es un nombre de parámetro asignado a un objeto con type y description.requiredarray (opcional)Especifica qué parámetros de entrada son obligatorios.floatEl umbral de probabilidad para el muestreo de núcleo.top_kintegerTamaño del conjunto de candidatos para el muestreo durante la generación.max_tokensintegerNúmero máximo de tokens que el modelo puede devolver para esta solicitud.repetition_penaltyfloatControla la repetición en secuencias consecutivas durante la generación.presence_penaltyfloatControla la repetición en el contenido generado.seedintegerEl grado de consistencia en la salida del modelo por solicitud. | El siguiente ejemplo usa qwen3.8-omni-flash-realtime en la región de Beijing, con salida solo de texto y max_tokens=32. |
input_audio_buffer.speech_started
En modo VAD, se devuelve cuando el servidor detecta el inicio del habla en el búfer de audio.
Puede activarse cada vez que se agrega audio al búfer antes de que se detecte el habla.
event_idstringUn identificador único para este evento.typestringEl tipo de evento. Este valor siempre es input_audio_buffer.speech_started.audio_start_msintegerTiempo (ms) desde que comienza la escritura en el búfer de audio hasta que se detecta el habla por primera vez.item_idstringID del elemento de mensaje de usuario creado cuando se detecta el fin del habla.Los elementos de mensaje de usuario agregan la entrada del usuario al historial de conversación para la inferencia del modelo. |
input_audio_buffer.speech_stopped
En modo VAD, se devuelve cuando el servidor detecta el fin del habla en el búfer de audio.
También devuelve un evento conversation.item.created con el elemento de mensaje de usuario correspondiente.
event_idstringUn identificador único para este evento.typestringEl tipo de evento. Este valor siempre es input_audio_buffer.speech_stopped.audio_end_msintegerTiempo (ms) desde el inicio de la sesión hasta que se detecta el fin del habla.item_idstringEl ID del elemento de mensaje del usuario que se creará. |
input_audio_buffer.committed
Se devuelve cuando se confirma el búfer de audio de entrada.
- En modo VAD, el servidor confirma automáticamente el búfer cuando detecta el fin del habla.
- En modo Manual, se devuelve después de que el cliente envía un evento
input_audio_buffer.commit.
event_idstringUn identificador único para este evento.typestringEl tipo de evento. Este valor siempre es input_audio_buffer.committed.item_idstringEl ID del elemento de mensaje del usuario que se creará. |
input_audio_buffer.cleared
Se devuelve después de que el cliente envía un evento input_audio_buffer.clear.
event_idstringUn identificador único para este evento.typestringEl tipo de evento. Este valor siempre es input_audio_buffer.cleared. |
conversation.item.created
Devuelto cuando se crea un elemento de conversación.
event_idstringUn identificador único para este evento.typestringEl tipo de evento. Este valor siempre es conversation.item.created.response_idstring (condicionalmente obligatorio)Se devuelve solo cuando item.type es mcp_approval_request; identifica la Respuesta principal que generó la llamada MCP.item_idstring (condicionalmente obligatorio)Se devuelve solo cuando item.type es mcp_approval_request; el ID del elemento de aprobación, igual a item.id.previous_item_idstring (condicionalmente obligatorio)Se devuelve solo cuando item.type es mcp_approval_request; identifica el elemento mcp_call bajo revisión.itemobjectEl elemento de conversación a agregar.
Propiedades id stringEl ID único del elemento de conversación.objectstringPara elementos message y function_call, este campo es realtime.item. Para elementos MCP, tiene el mismo valor cuando se devuelve.statusstringCuando se devuelve, este campo indica el estado del elemento de conversación. Un elemento mcp_call inicial lo requiere con el valor in_progress.rolestringPresente solo en elementos de mensaje; identifica el rol del mensaje.contentarray of objectsEl contenido del mensaje, devuelto cuando el tipo es message. Los siguientes campos describen el elemento de matriz en este ejemplo.
Elemento de matriz type stringEl tipo de parte de contenido; input_audio en este ejemplo.stringEl tipo de elemento de conversación incluye message y function_call. Qwen3.8-Omni-Flash-Realtime también devuelve mcp_list_tools, mcp_call y mcp_approval_request; consulte Ejemplos de elementos MCP.namestringEl nombre de la función que se llama cuando el tipo es function_call.call_idstringCuando type es function_call, este es el ID único de la invocación de la función.argumentsstringCuando type es function_call, este parámetro contiene los argumentos para la invocación de la función como una cadena JSON.
type=mcp_list_tools Para este tipo de elemento, item.id coincide con item_id en los eventos de estado de descubrimiento de herramientas.server_labelstring (obligatorio)Identifica el servidor MCP.toolsarray of objects (obligatorio)Definiciones de herramientas validadas después del filtrado de allowed_tools; vacío si falla el descubrimiento.
Elemento de matriz name string (obligatorio)Nombre original de la herramienta, de 1 a 64 caracteres usando letras, dígitos, guiones bajos, puntos o guiones.descriptionstring (opcional)Descripción de la herramienta del servidor MCP.input_schemaobject (obligatorio)JSON Schema del servidor MCP. El servicio no realiza una validación semántica completa de JSON Schema; el servidor MCP valida los argumentos en última instancia.
Propiedades type string (obligatorio)El valor raíz debe ser object.propertiesobject (opcional)Liste cada parámetro bajo su nombre personalizado. Por ejemplo, city en el ejemplo de mcp_list_tools es un nombre de parámetro; sus type y description describen el tipo de datos y el propósito. El servidor MCP define el JSON Schema de cada parámetro.requiredarray of strings (opcional)Nombres de los parámetros obligatorios.Otros campos estándar de JSON Schema, incluidos additionalProperties, $defs, oneOf, anyOf y allOf, se transfieren desde el esquema original.object (opcional)ToolAnnotations del servidor MCP. Los siguientes campos de sugerencia estándar de MCP son opcionales; el servidor determina qué campos devuelve.
Propiedades title string (opcional)Nombre para mostrar de la herramienta.readOnlyHintboolean (opcional)Indica si la herramienta es de solo lectura.destructiveHintboolean (opcional)Indica si la herramienta puede realizar cambios destructivos.idempotentHintboolean (opcional)Indica si las llamadas repetidas no tienen ningún efecto adicional.openWorldHintboolean (opcional)Indica si la herramienta puede interactuar con sistemas externos. Estos campos son indicaciones y no deben usarse como garantía de seguridad.object (opcional)Devuelto en caso de fallo de descubrimiento.
Propiedades type string (obligatorio)Debe ser tool_execution_error.messagestring (obligatorio)Una descripción segura para el cliente sin contenido sensible de la respuesta ascendente.
type=mcp_call (elemento inicial) object string (obligatorio)Debe ser realtime.item.statusstring (obligatorio)Inicialmente in_progress.server_labelstring (obligatorio)Identifica el servidor MCP que ejecuta la herramienta.namestring (obligatorio)Nombre original de la herramienta.call_idstring (obligatorio)ID único de esta llamada.argumentsstring (obligatorio)Generalmente vacío al principio; use eventos posteriores y el elemento final para obtener los argumentos completos.
type=mcp_approval_request Copie el item.id de este elemento de aprobación sin cambios en approval_request_id al responder.server_labelstring (obligatorio)Identifica el servidor MCP para la herramienta pendiente.namestring (obligatorio)Nombre original de la herramienta pendiente.argumentsstring (obligatorio)Cadena JSON completa de argumentos en espera de aprobación.call_idstring (obligatorio)ID de la llamada en espera de aprobación. | Ejemplo: |
conversation.item.input_audio_transcription.delta
Se envía frecuentemente mientras el usuario habla cuando la transcripción de audio de entrada está habilitada. Proporciona resultados de transcripción intermedios en tiempo real. Concatene text + stash para obtener la vista previa de oración más completa en cualquier momento.
event_idstringUn identificador único para este evento.typestringEl tipo de evento. Este valor siempre es conversation.item.input_audio_transcription.delta.item_idstringEl ID del elemento de conversación asociado.content_indexintegerEl índice de la parte de contenido que contiene el audio.textstringPrefijo de texto confirmado: la parte que el modelo ha finalizado y no cambiará.stashstringSufijo de texto preliminar: un borrador temporal que sigue a la parte confirmada, sujeto a revisión.languagestringEl idioma detectado del audio reconocido.emotionstringLa emoción detectada del audio reconocido. Valores válidos: neutral, happy, sad, angry, surprised, disgusted, fearful. | text + stash.
Haga clic para ver el ejemplo Suponga que el usuario dice: "El clima está agradable hoy, soleado y cálido".Lo siguiente muestra el flujo de eventos que podría recibir y cómo interpretarlos:
|
conversation.item.input_audio_transcription.completed
Indica que el audio del usuario ha sido transcrito por el modelo de reconocimiento de voz integrado (qwen3-asr-flash-realtime). No es configurable.
El texto transcrito del modelo de reconocimiento de voz puede diferir de la interpretación generada por el modelo Qwen-Omni-Realtime. La transcripción es solo para referencia.
event_idstringUn identificador único para este evento.typestringEl tipo de evento. Este valor siempre es conversation.item.input_audio_transcription.completed.item_idstringEl ID del elemento de mensaje del usuario.content_indexintegerEste valor siempre es 0.transcriptstringEl texto transcrito. |
conversation.item.input_audio_transcription.failed
Devuelto cuando la transcripción de audio de entrada está habilitada y la transcripción falla. Independiente del evento error; ayuda a los clientes a identificar fallos de transcripción específicamente.
event_idstringUn identificador único para este evento.typestringEl tipo de evento. Este valor siempre es conversation.item.input_audio_transcription.failed.item_idstringEl ID del elemento de mensaje del usuario.content_indexintegerEste valor siempre es 0.errorobjectLa información del error.
Propiedades code stringEl código de error.message stringEl mensaje de error.param stringEl parámetro relacionado con el error. |
response.created
Se devuelve cuando el servidor comienza a generar una nueva respuesta.
event_idstringUn identificador único para este evento.typestringEl tipo de evento. Este valor siempre es response.created.responseobjectEl objeto de respuesta.
Propiedades id stringEl ID único de la respuesta.conversation_id stringEl ID único de la sesión actual.object stringEl tipo de objeto. Para este evento, este valor siempre es realtime.response.status stringEl estado de la respuesta. Los valores válidos son completed, failed, in_progress, or incomplete.modalities arrayLas modalidades de respuesta.voice stringLa voz para el audio generado por el modelo.output arrayEste campo está vacío para este evento. |
response.done
Se devuelve después de que la respuesta se genera completamente. El objeto response incluye todos los elementos de salida excepto los datos de audio sin procesar.
event_idstringUn identificador único para este evento.typestringEl tipo de evento. Este valor siempre es response.done.responseobjectEl objeto de respuesta.
Propiedades id stringEl ID único de la respuesta.conversation_id stringEl ID único de la sesión actual.object stringEl tipo de objeto. Para este evento, este valor siempre es realtime.response.status stringEl estado de la respuesta.modalities arrayLas modalidades de respuesta.voice stringLa voz para el audio generado por el modelo.output arrayLos elementos de salida de la respuesta. Cada elemento de la matriz es un objeto de elemento de conversación.
Elemento de matriz id stringEl ID de la salida de la respuesta.type stringEl tipo de elemento de salida. Los valores incluyen message y function_call. Qwen3.8-Omni-Flash-Realtime también admite mcp_call; consulte Ejemplos de elementos MCP.object stringPara elementos message y function_call, este campo es realtime.item. Para elementos MCP, tiene el mismo valor cuando se devuelve.status stringEl estado del elemento de salida.role stringPresente solo en elementos de mensaje; identifica el rol del mensaje.content arrayEl contenido del elemento de salida, devuelto solo cuando type es message. Cada elemento de la matriz es un objeto de parte de contenido.
Elemento de matriz type stringEl tipo de contenido. El valor puede ser text para salida de texto sin formato o audio para salida de audio.text stringLa salida de texto.transcript stringLa transcripción de texto del audio.stringEl nombre de la función que se invoca cuando el tipo es function_call.call_id stringCuando type es function_call, este es el ID único de la invocación de la función.arguments stringCuando type es function_call, este campo contiene los argumentos completos para la llamada a la función como una cadena JSON.
type=mcp_call (elemento final) status string (obligatorio)completed o failed.server_labelstring (obligatorio)Identifica el servidor MCP que ejecutó la herramienta.namestring (obligatorio)Nombre original de la herramienta.call_idstring (obligatorio)ID único de esta llamada.argumentsstring (obligatorio)Cadena JSON completa de argumentos.outputstring (opcional)Una cadena JSON serializada desde MCP tools/call.result. También puede aparecer en algunos casos de fallo.errorobject (opcional)Devuelto en caso de fallo.
Propiedades type string (obligatorio)Debe ser tool_execution_error.messagestring (obligatorio)Una descripción segura para el cliente sin contenido sensible de la respuesta ascendente.isError=true, el estado final es failed y el output original también puede estar presente.objectDetalles de uso de tokens para esta respuesta.
Propiedades total_tokens integerTotal de tokens utilizados en esta respuesta.input_tokens integerNúmero de tokens de entrada.output_tokens integerNúmero de tokens de salida.input_tokens_details objectDetalles sobre el uso de tokens de entrada, incluyendo text_tokens y audio_tokens.output_tokens_details objectDetalles sobre el uso de tokens de salida, incluyendo text_tokens y audio_tokens.plugins object (opcional)Métricas de uso de complementos. Se devuelve cuando la búsqueda web (enable_search) está habilitada.
Propiedades search objectDatos de medición de búsqueda.
Propiedades count integerEl número de búsquedas.strategy stringLa estrategia de búsqueda. | Ejemplo: |
response.text.delta
Se devuelve cuando la modalidad de salida es solo texto y el modelo genera nuevo texto incrementalmente.
event_idstringUn identificador único para este evento.typestringEl tipo de evento. Este valor siempre es response.text.delta.deltastringTexto incremental generado por el modelo.response_idstringEl ID de respuesta.item_idstringEl ID del elemento de mensaje.output_indexintegerEl índice del elemento de salida en la respuesta. Este valor siempre es 0.content_indexintegerEl índice de la parte interna dentro del elemento de salida. Este valor siempre es 0. |
response.text.done
Se devuelve cuando la modalidad de salida es solo texto y el modelo termina de generar texto.
También se devuelve si la respuesta se interrumpe, está incompleta o se cancela.
event_idstringUn identificador único para este evento.typestringEl tipo de evento. Este valor siempre es response.text.done.response_idstringEl ID de respuesta.item_idstringEl ID del elemento de mensaje.output_indexintegerEl índice del elemento de salida en la respuesta.content_indexintegerEl índice del elemento de salida en la respuesta.text stringEl texto completo generado por el modelo. |
response.audio.delta
Para la conexión mediante WebSocket, el servidor devuelve este evento cuando las modalidades de salida incluyen audio y el modelo genera datos de audio nuevos de forma incremental. Para la conexión mediante WebRTC, el audio se transmite mediante pistas de audio RTP y este evento no se devuelve.
event_idstringUn identificador único para este evento.typestringEl tipo de evento. Este valor siempre es response.audio.delta.response_idstringEl ID de respuesta.item_idstringEl ID del elemento de mensaje.output_indexintegerEl índice del elemento de salida en la respuesta.content_indexintegerEl índice del elemento de salida en la respuesta.delta stringDatos de audio incrementales, codificados en Base64. |
response.audio.done
Se devuelve cuando la modalidad de salida incluye audio y el modelo termina de generar datos de audio.
También se devuelve si la respuesta se interrumpe, está incompleta o se cancela.
event_idstringUn identificador único para este evento.typestringEl tipo de evento. Este valor siempre es response.audio.done.response_idstringEl ID de respuesta.item_idstringEl ID del elemento de mensaje.output_indexintegerEl índice del elemento de salida en la respuesta.content_indexintegerEl índice del elemento de salida en la respuesta. |
response.audio_transcript.delta
Devuelto cuando la modalidad de salida incluye audio y el modelo genera nuevo texto de transcripción response.audio_transcript.delta de forma incremental.
event_idstringUn identificador único para este evento.typestringEl tipo de evento. Este valor siempre es response.audio_transcript.delta.response_idstringEl ID de respuesta.item_idstringEl ID del elemento de mensaje.output_indexintegerEl índice del elemento de salida en la respuesta.content_indexintegerEl índice del elemento de salida en la respuesta.deltastringEl texto incremental. |
response.audio_transcript.done
Devuelto como un evento response.audio_transcript.done cuando la modalidad de salida incluye audio y el modelo completa la transcripción de audio.
event_idstringUn identificador único para este evento.typestringEl tipo de evento. Este valor siempre es response.audio_transcript.done.response_idstringEl ID de respuesta.item_idstringEl ID del elemento de mensaje.output_indexintegerEl índice del elemento de salida en la respuesta.content_indexintegerEl índice del elemento de salida en la respuesta.transcriptstringEl texto completo de la transcripción. |
response.function_call_arguments.delta
Devuelto a medida que el modelo transmite argumentos de llamada de función. Concatene los campos delta para construir la cadena de argumentos. El contenido completo se proporciona en el evento response.function_call_arguments.done subsiguiente.
event_idstringUn identificador único para este evento.typestringEl tipo de evento. Este valor siempre es response.function_call_arguments.delta.response_idstringEl ID de respuesta.item_idstringEl ID del elemento de mensaje.output_indexintegerEl índice del elemento de salida en la respuesta.call_idstringEl ID único para esta invocación de función. Esto es consistente con el evento done en el mismo turno.deltastringNuevo segmento de la cadena de argumentos. Concatene los segmentos en orden. |
response.function_call_arguments.done
Indica que los argumentos de llamada de función se han generado completamente. El campo arguments contiene la cadena de argumentos completa. Utilice los arguments de este evento —no los resultados concatenados de delta— para analizar y llamar a la función local.
event_idstringUn identificador único para este evento.typestringEl tipo de evento. Este valor siempre es response.function_call_arguments.done.response_idstringEl ID de respuesta.item_idstringEl ID del elemento de mensaje.output_indexintegerEl índice del elemento de salida en la respuesta.call_idstringEl ID único para esta invocación de función.namestringEl nombre de la función que fue llamada.argumentsstringArgumentos completos de la llamada a la función como una cadena JSON. |
response.output_item.added
Devuelto cuando se crea un nuevo elemento durante la generación de respuesta. El tipo de elemento puede ser message o function_call; Qwen3.8-Omni-Flash-Realtime también admite mcp_call; consulte Ejemplos de elementos MCP.
event_idstringUn identificador único para este evento.typestringEl tipo de evento. Este valor siempre es response.output_item.added.response_idstringEl ID de respuesta.output_indexintegerEl índice del elemento de salida en la respuesta.itemobjectInformación sobre el elemento de salida.
Propiedades id stringEl ID único del elemento de salida.objectstringPara elementos message y function_call, este campo es realtime.item. Para elementos MCP, tiene el mismo valor cuando se devuelve.statusstringEl estado del elemento de salida.rolestringPresente solo en elementos de mensaje; identifica el rol del mensaje.contentarrayEl contenido del mensaje, devuelto cuando el tipo es message. La matriz está inicialmente vacía en este ejemplo; consulte el elemento completado en el ejemplo de response.output_item.done.typestringEl tipo de elemento de salida. Los valores incluyen message y function_call. Qwen3.8-Omni-Flash-Realtime también admite mcp_call; consulte Ejemplos de elementos MCP.namestringEl nombre de la función a llamar cuando type es function_call.call_idstringEl ID único de la invocación de función actual cuando el tipo es function_call.argumentsstringArgumentos de llamada a la función como una cadena JSON cuando type es function_call. Inicialmente una cadena vacía en eventos added.
type=mcp_call (elemento inicial) object string (obligatorio)Debe ser realtime.item.statusstring (obligatorio)Inicialmente in_progress.server_labelstring (obligatorio)Identifica el servidor MCP que ejecuta la herramienta.namestring (obligatorio)Nombre original de la herramienta.call_idstring (obligatorio)ID único de esta llamada.argumentsstring (obligatorio)Generalmente vacío al principio; use response.mcp_call_arguments.done y el elemento final para obtener los argumentos completos. |
response.output_item.done
Devuelto cuando un elemento de salida se genera completamente.
event_idstringUn identificador único para este evento.typestringEl tipo de evento. Este valor siempre es response.output_item.done.response_idstringEl ID de respuesta.output_indexintegerEl índice del elemento de salida en la respuesta.itemobjectLa información del elemento de salida.
Propiedades id stringEl ID único del elemento de salida.objectstringPara elementos message y function_call, este campo es realtime.item. Para elementos MCP, tiene el mismo valor cuando se devuelve.statusstringEl estado del elemento de salida.rolestringPresente solo en elementos de mensaje; identifica el rol del mensaje.contentarray of objectsEl contenido del mensaje, devuelto cuando el tipo es message. Los siguientes campos describen el elemento de matriz en este ejemplo.
Elemento de matriz type stringEl tipo de parte de contenido; audio en este ejemplo.textstringContenido de texto en este ejemplo.stringEl tipo de elemento de salida. Los valores incluyen message y function_call. Qwen3.8-Omni-Flash-Realtime también admite mcp_call; consulte Ejemplos de elementos MCP.namestringEl nombre de la función que se llama cuando el tipo es function_call.call_idstringCuando type es function_call, este es el ID único para la invocación de la función.argumentsstringCuando type es function_call, contiene los argumentos completos de la llamada a la función como una cadena JSON.
type=mcp_call (elemento final) status string (obligatorio)completed o failed.server_labelstring (obligatorio)Identifica el servidor MCP que ejecutó la herramienta.namestring (obligatorio)Nombre original de la herramienta.call_idstring (obligatorio)ID único de esta llamada.argumentsstring (obligatorio)Cadena JSON completa de argumentos.outputstring (opcional)Una cadena JSON serializada desde MCP tools/call.result. También puede aparecer en algunos casos de fallo.errorobject (opcional)Devuelto en caso de fallo.
Propiedades type string (obligatorio)Debe ser tool_execution_error.messagestring (obligatorio)Una descripción segura para el cliente sin contenido sensible de la respuesta ascendente.isError=true, el estado final es failed y el output original también puede estar presente. |
response.content_part.added
Se devuelve cuando se agrega una nueva parte de contenido a un elemento de mensaje del asistente durante la generación de la respuesta.
event_idstringUn identificador único para este evento.typestringEl tipo de evento. Este valor siempre es response.content_part.added.response_idstringEl ID de respuesta.item_idstringEl ID del elemento de mensaje.output_indexintegerEl índice del elemento de salida en la respuesta. Este valor siempre es 0.content_indexintegerEl índice de la parte interna dentro del elemento de salida. Este valor siempre es 0.partobjectLa información del elemento de salida.
Propiedades type stringEl tipo de la parte de contenido.textstringEl texto de la parte de contenido. |
response.content_part.done
Se devuelve cuando finaliza la transmisión de una parte de contenido dentro de un elemento de mensaje del asistente.
event_idstringUn identificador único para este evento.typestringEl tipo de evento. Este valor siempre es response.content_part.done.response_idstringEl ID de respuesta.item_idstringEl ID del elemento de mensaje.output_indexintegerEl índice del elemento de salida en la respuesta. Este valor siempre es 0.content_indexintegerEl índice de la parte de contenido en la matriz de contenido. Este valor siempre es 0.partobjectLa información del elemento de salida.
Propiedades type stringEl tipo de la parte de contenido.textstringEl texto de la parte de contenido. |
Eventos de MCP
Esta sección describe eventos y campos de WebSocket para qwen3.8-omni-flash-realtime. Otros eventos y campos base utilizan el protocolo común documentado anteriormente. Los campos obligatorios son necesarios cuando su objeto contenedor está presente. Los IDs son cadenas opacas; no confíe en sus longitudes, prefijos o reglas de generación. arguments y output son cadenas cuyo contenido requiere análisis JSON. Las conexiones MCP, el descubrimiento y las llamadas están sujetos a cuotas de servicio y tiempos de espera.
mcp_list_tools.*
| Tipo de evento | Cuándo se emite |
|---|---|
mcp_list_tools.in_progress | Comienza el descubrimiento de herramientas para un servidor MCP. |
mcp_list_tools.completed | El descubrimiento tiene éxito y allowed_tools el filtrado se completa. |
mcp_list_tools.failed | El descubrimiento falla, excede el tiempo de espera o supera los límites del servicio. |
event_id (ID de evento único), type (tipo de evento anterior) y item_id (elemento mcp_list_tools asociado). in_progress puede llegar antes que session.updated. Para completed y failed, conversation.item.created que contiene la lista final de herramientas o error llega primero, seguido por el evento de estado con el mismo item_id.
response.mcp_call_arguments.delta
| Campo | Tipo | Obligatorio | Significado |
|---|---|---|---|
event_id | string | Sí | ID de evento único. |
type | string | Sí | response.mcp_call_arguments.delta |
response_id | string | Sí | ID de Response principal. |
item_id | string | Sí | Actual mcp_call ID de elemento. |
output_index | integer | Sí | Índice basado en cero en la matriz de salida Response principal. |
delta | string | Sí | Fragmento de cadena JSON incremental; concatene en orden de evento. |
obfuscation | string | No | Cadena de ofuscación opcional; ignore al ensamblar y analizar argumentos. |
response.mcp_call_arguments.done
Requiere event_id, type, response_id y item_id (cadenas), output_index (entero, mismo significado que arriba) y arguments (cadena). type es response.mcp_call_arguments.done. arguments contiene los argumentos completos codificados en JSON y es autoritativo.
response.mcp_call.*
| Tipo de evento | Cuándo se emite |
|---|---|
response.mcp_call.in_progress | Los argumentos están completos y la aprobación se ha concedido o no es necesaria; comienza la llamada MCP. |
response.mcp_call.completed | La llamada MCP tiene éxito. |
response.mcp_call.failed | Error de conexión, protocolo o negocio de herramienta; rechazo de aprobación o tiempo de espera agotado; tiempo de espera de llamada agotado; o cancelación. |
event_id, type y item_id (cadenas), y output_index (entero). item_id identifica el mcp_call actual; output_index es su índice en la matriz de salida Response principal.
Elementos de conversación MCP
Estos objetos son tipos del campo item en eventos, aplicables a Qwen3.8-Omni-Flash-Realtime.
Elemento mcp_list_tools
Devuelto como conversation.item.created.item; consulte la rama type=mcp_list_tools en conversation.item.created para ver sus campos.
Ejemplo:
Elemento mcp_call inicial
Cuando el modelo selecciona una herramienta MCP, este elemento aparece en response.output_item.added.item y también puede aparecer en conversation.item.created.item; consulte las ramas correspondientes de item bajo response.output_item.added y conversation.item.created.
Ejemplo de response.output_item.added:
Elemento mcp_approval_request
Devuelto en conversation.item.created; consulte conversation.item.created para los campos de evento y aprobación item.
Ejemplo:
Elemento mcp_call final
Después de que una llamada alcanza un estado terminal, el elemento aparece en response.output_item.done.item y en la instantánea final principal de response.done.response.output; consulte las ramas correspondientes bajo response.output_item.done y response.done.
Llamada exitosa:
Errores de MCP
Los errores de MCP pueden ocurrir durante el descubrimiento de herramientas o la ejecución de herramientas. Para errores de descubrimiento, consulte error bajo la rama mcp_list_tools de conversation.item.created; para errores de ejecución, consulte la rama mcp_call de response.output_item.done.
Consulte Qwen-Omni-Realtime.