VoiceConversation interface

Una conversación persistente de voz. El sobre de Foundry que posee la transcripción almacenada de un agente de voz, respuestas, métricas por turno y audio. Es el límite padre, retención y eliminación: eliminarlo se propaga en cascada a sus respuestas, elementos, métricas y audio. Cuando la finalización falla, cualquier respuesta parcial persistente, elementos y audio del ítem permanecen legibles.

Propiedades

completed_at

La marca de tiempo de Unix (en segundos) para cuando la finalización de sesión y persistencia alcanzaba el terminal completed o failed el estado. Ausente mientras status es in_progress.

created_at

La marca de tiempo de Unix (en segundos) para cuando se creó la conversación.

id

El id único de la conversación.

last_error

El error terminal que impidió la finalización de la persistencia. Presente solo cuando status es failed.

metadata

Un conjunto de pares clave-valor adjuntos a la conversación.

object

Tipo de objeto. Siempre voice.conversation.

status

El estado del ciclo de vida de la conversación.

usage

Uso agregado final de tokens en todas las respuestas de esta conversación. Ausente mientras status es y se rellena tras la finalización exitosacompleted; puede estar ausente cuando status es failed, y los valores no garantizan que se reporten de forma incrementalin_progress.

Detalles de las propiedades

completed_at

La marca de tiempo de Unix (en segundos) para cuando la finalización de sesión y persistencia alcanzaba el terminal completed o failed el estado. Ausente mientras status es in_progress.

completed_at?: Date

Valor de propiedad

Date

created_at

La marca de tiempo de Unix (en segundos) para cuando se creó la conversación.

created_at: Date

Valor de propiedad

Date

id

El id único de la conversación.

id: string

Valor de propiedad

string

last_error

El error terminal que impidió la finalización de la persistencia. Presente solo cuando status es failed.

last_error?: ErrorModel

Valor de propiedad

metadata

Un conjunto de pares clave-valor adjuntos a la conversación.

metadata?: Record<string, string>

Valor de propiedad

Record<string, string>

object

Tipo de objeto. Siempre voice.conversation.

object: "voice.conversation"

Valor de propiedad

"voice.conversation"

status

El estado del ciclo de vida de la conversación.

status: VoiceConversationStatus

Valor de propiedad

usage

Uso agregado final de tokens en todas las respuestas de esta conversación. Ausente mientras status es y se rellena tras la finalización exitosacompleted; puede estar ausente cuando status es failed, y los valores no garantizan que se reporten de forma incrementalin_progress.

usage?: RealtimeResponseUsage

Valor de propiedad