VoiceAgentRealtimeClientConnectOptions interface

Opções para conectar o cliente em tempo real a um agente de voz.

Extends

Propriedades

abortSignal

Cancela a tentativa de conexão.

agentSessionId

Identificador usado para correlacionar a sessão de voz.

agentVersionOverride

Seleciona uma versão específica do agente imutável.

connectionTimeoutInMs

Anula o tempo limite da conexão do cliente em milissegundos.

onConnectionStateChange

Recebe transições de estado de conexão.

query

Parâmetros adicionais de consulta para a URL de atualização do WebSocket desta conexão. Forneça um objeto simples, incluindo um objeto protótipo nulo. Valores substituem parâmetros undefined de consulta de endpoint; remove um parâmetro. Os valores são codificados automaticamente por URL. Os números devem ser finitos. Parâmetros gerenciados por SDK, parâmetros de autenticação e nomes começando com h- são reservados (insensíveis a maiúsculas e minúsculas) e causam um TypeError. Use as opções digitadas correspondentes para entradas, versão, armazenamento, transporte e prompts estruturados. Ambos structured_input e structured_inputs são reservados. Não inclua segredos: parâmetros de consulta podem aparecer em logs de servidores ou proxy.

store

Anula se a conversa criada por esta sessão foi mantida.

structuredInputs

Valores usados para renderizar as entradas estruturadas de prompt do agente. Serializado quando connect() é chamado, antes da autenticação.

transport

Seleciona o transporte usado para a conexão em tempo real. Usa "websocket" como padrão. Configurado para "webrtc" negociar uma conexão entre pares WebRTC; o chamador é responsável por completar a troca de oferta/resposta SDP usando os rtc.call.sdp.create eventos e rtc.call.sdp.created (veja VoiceAgentRealtimeEvent).

Propriedades herdadas

onResponse

Uma função a ser chamada sempre que uma resposta é recebida do servidor durante a execução da operação solicitada. Pode ser chamado várias vezes.

requestOptions

Opções usadas ao criar e enviar solicitações HTTP para esta operação.

tracingOptions

Opções usadas quando o rastreamento está habilitado.

Detalhes da propriedade

abortSignal

Cancela a tentativa de conexão.

abortSignal?: AbortSignalLike

Valor da propriedade

agentSessionId

Identificador usado para correlacionar a sessão de voz.

agentSessionId?: string

Valor da propriedade

string

agentVersionOverride

Seleciona uma versão específica do agente imutável.

agentVersionOverride?: string

Valor da propriedade

string

connectionTimeoutInMs

Anula o tempo limite da conexão do cliente em milissegundos.

connectionTimeoutInMs?: number

Valor da propriedade

number

onConnectionStateChange

Recebe transições de estado de conexão.

onConnectionStateChange?: VoiceAgentConnectionStateChangedHandler

Valor da propriedade

query

Parâmetros adicionais de consulta para a URL de atualização do WebSocket desta conexão. Forneça um objeto simples, incluindo um objeto protótipo nulo. Valores substituem parâmetros undefined de consulta de endpoint; remove um parâmetro. Os valores são codificados automaticamente por URL. Os números devem ser finitos. Parâmetros gerenciados por SDK, parâmetros de autenticação e nomes começando com h- são reservados (insensíveis a maiúsculas e minúsculas) e causam um TypeError. Use as opções digitadas correspondentes para entradas, versão, armazenamento, transporte e prompts estruturados. Ambos structured_input e structured_inputs são reservados. Não inclua segredos: parâmetros de consulta podem aparecer em logs de servidores ou proxy.

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

Valor da propriedade

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

store

Anula se a conversa criada por esta sessão foi mantida.

store?: boolean

Valor da propriedade

boolean

structuredInputs

Valores usados para renderizar as entradas estruturadas de prompt do agente. Serializado quando connect() é chamado, antes da autenticação.

structuredInputs?: Record<string, unknown>

Valor da propriedade

Record<string, unknown>

transport

Seleciona o transporte usado para a conexão em tempo real. Usa "websocket" como padrão. Configurado para "webrtc" negociar uma conexão entre pares WebRTC; o chamador é responsável por completar a troca de oferta/resposta SDP usando os rtc.call.sdp.create eventos e rtc.call.sdp.created (veja VoiceAgentRealtimeEvent).

transport?: VoiceAgentTransport

Valor da propriedade

Detalhes das propriedades herdadas

onResponse

Uma função a ser chamada sempre que uma resposta é recebida do servidor durante a execução da operação solicitada. Pode ser chamado várias vezes.

onResponse?: RawResponseCallback

Valor da propriedade

herdado de OperationOptions.onResponse

requestOptions

Opções usadas ao criar e enviar solicitações HTTP para esta operação.

requestOptions?: OperationRequestOptions

Valor da propriedade

Herdado de OperationOptions.requestOptions

tracingOptions

Opções usadas quando o rastreamento está habilitado.

tracingOptions?: OperationTracingOptions

Valor da propriedade

herdado de OperationOptions.tracingOptions