VoiceAgentRealtimeClientConnectOptions interface

Opciones para conectar el cliente en tiempo real a un agente de voz.

Extends

Propiedades

abortSignal

Cancela el intento de conexión.

agentSessionId

Identificador usado para correlacionar la sesión de voz.

agentVersionOverride

Selecciona una versión de agente inmutable específica.

connectionTimeoutInMs

Anula el tiempo de espera de la conexión del cliente en milisegundos.

onConnectionStateChange

Recibe transiciones de estado de conexión.

query

Parámetros adicionales de consulta para la URL de actualización WebSocket de esta conexión. Proporciona un objeto simple, incluyendo un objeto prototipo nulo. Los valores sobrescriben los parámetros undefined de consulta de endpoint; elimina un parámetro. Los valores se codifican automáticamente por URL. Los números deben ser finitos. Los parámetros gestionados por SDK, parámetros de autenticación y nombres que comienzan con h- se reservan (insensibles a mayúsculas y minúsculas) y causan un TypeError. Utiliza las opciones correspondientes para sesión, versión, almacenamiento, transporte y entradas estructuradas de prompts. Ambos structured_input y structured_inputs son reservados. No incluyas secretos: los parámetros de consulta pueden aparecer en registros de servidores o proxy.

store

Anula si la conversación generada por esta sesión se mantiene en marcha.

structuredInputs

Valores usados para renderizar las entradas estructuradas de prompt del agente. Se serializa cuando connect() se llama, antes de la autenticación.

transport

Selecciona el transporte utilizado para la conexión en tiempo real. Tiene como valor predeterminado "websocket". Configurado para "webrtc" negociar una conexión entre pares WebRTC en su lugar; el llamante es responsable de completar el intercambio de oferta/respuesta SDP usando los rtc.call.sdp.create eventos y rtc.call.sdp.created (véase VoiceAgentRealtimeEvent).

Propiedades heredadas

onResponse

Función a la que se llamará cada vez que se recibe una respuesta del servidor mientras se realiza la operación solicitada. Se puede llamar varias veces.

requestOptions

Opciones que se usan al crear y enviar solicitudes HTTP para esta operación.

tracingOptions

Opciones que se usan al habilitar el seguimiento.

Detalles de las propiedades

abortSignal

Cancela el intento de conexión.

abortSignal?: AbortSignalLike

Valor de propiedad

agentSessionId

Identificador usado para correlacionar la sesión de voz.

agentSessionId?: string

Valor de propiedad

string

agentVersionOverride

Selecciona una versión de agente inmutable específica.

agentVersionOverride?: string

Valor de propiedad

string

connectionTimeoutInMs

Anula el tiempo de espera de la conexión del cliente en milisegundos.

connectionTimeoutInMs?: number

Valor de propiedad

number

onConnectionStateChange

Recibe transiciones de estado de conexión.

onConnectionStateChange?: VoiceAgentConnectionStateChangedHandler

Valor de propiedad

query

Parámetros adicionales de consulta para la URL de actualización WebSocket de esta conexión. Proporciona un objeto simple, incluyendo un objeto prototipo nulo. Los valores sobrescriben los parámetros undefined de consulta de endpoint; elimina un parámetro. Los valores se codifican automáticamente por URL. Los números deben ser finitos. Los parámetros gestionados por SDK, parámetros de autenticación y nombres que comienzan con h- se reservan (insensibles a mayúsculas y minúsculas) y causan un TypeError. Utiliza las opciones correspondientes para sesión, versión, almacenamiento, transporte y entradas estructuradas de prompts. Ambos structured_input y structured_inputs son reservados. No incluyas secretos: los parámetros de consulta pueden aparecer en registros de servidores o proxy.

query?: Readonly<Record<string, string | number | boolean | undefined>>

Valor de propiedad

Readonly<Record<string, string | number | boolean | undefined>>

store

Anula si la conversación generada por esta sesión se mantiene en marcha.

store?: boolean

Valor de propiedad

boolean

structuredInputs

Valores usados para renderizar las entradas estructuradas de prompt del agente. Se serializa cuando connect() se llama, antes de la autenticación.

structuredInputs?: Record<string, unknown>

Valor de propiedad

Record<string, unknown>

transport

Selecciona el transporte utilizado para la conexión en tiempo real. Tiene como valor predeterminado "websocket". Configurado para "webrtc" negociar una conexión entre pares WebRTC en su lugar; el llamante es responsable de completar el intercambio de oferta/respuesta SDP usando los rtc.call.sdp.create eventos y rtc.call.sdp.created (véase VoiceAgentRealtimeEvent).

transport?: VoiceAgentTransport

Valor de propiedad

Detalles de las propiedades heredadas

onResponse

Función a la que se llamará cada vez que se recibe una respuesta del servidor mientras se realiza la operación solicitada. Se puede llamar varias veces.

onResponse?: RawResponseCallback

Valor de propiedad

Heredado de OperationOptions.onResponse

requestOptions

Opciones que se usan al crear y enviar solicitudes HTTP para esta operación.

requestOptions?: OperationRequestOptions

Valor de propiedad

Heredado de OperationOptions.requestOptions

tracingOptions

Opciones que se usan al habilitar el seguimiento.

tracingOptions?: OperationTracingOptions

Valor de propiedad

Heredado de OperationOptions.tracingOptions