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 |
| 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 |
| metadata | Un conjunto de pares clave-valor adjuntos a la conversación. |
| object | Tipo de objeto. Siempre |
| 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 |
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