GenerateVoiceAgentRequest interface
Las entradas para generar un agente de voz. Solo kind y name siempre son obligatorios.
El servicio de autoría amplía estas entradas en un , completo y editable VoiceAgentDefinition, que luego se crea mediante POST /agents.
Los ajustes generados instructions y de audio/voz se almacenan como campos separados en la definición resultante del agente, por lo que el llamante puede editar o anular cualquiera de ellos posteriormente mediante el versionado estándar del agente.
Propiedades
| description | Una descripción opcional del agente. El servicio de autoría resuelve su respaldo cuando se omite. |
| draft | (Vista previa) Cuando |
| goal | Una descripción opcional en lenguaje natural de lo que debe hacer el agente. Cuando se suministra, siembra las instrucciones generadas. |
| kind | Tipo de agente. Siempre |
| model | Identificador de modelo opcional. Obligatorio cuando |
| model_type | Modo de inferencia opcional. Cuando se omite, el servicio de autoría utiliza |
| name | El nombre único que el agente debe crear. Debe ser un nombre de agente no vacío tipo DNS. |
| tools | Las herramientas opcionales se trasladaron literalmente al agente generado (véase |
| use_case | Un caso de uso opcional de autoría. Se acepta una cadena vacía. |
Detalles de las propiedades
description
Una descripción opcional del agente. El servicio de autoría resuelve su respaldo cuando se omite.
description?: string
Valor de propiedad
string
draft
(Vista previa) Cuando true, el agente de voz generado se crea como un borrador — una versión editable y no publicada que el llamante puede revisar y refinar antes de publicarla a través de la ruta estándar de creación/versión. El servicio se establece por defecto false en si el llamador no especifica un valor, en cuyo caso el agente se crea y publica de forma normal.
draft?: boolean
Valor de propiedad
boolean
goal
Una descripción opcional en lenguaje natural de lo que debe hacer el agente. Cuando se suministra, siembra las instrucciones generadas.
goal?: string
Valor de propiedad
string
kind
Tipo de agente. Siempre voice.
kind: "voice"
Valor de propiedad
"voice"
model
Identificador de modelo opcional. Obligatorio cuando model_type es self_deployed; opcional cuando model_type se está managed o se omite. El servicio nunca inventa un nombre de despliegue para el cliente.
model?: string
Valor de propiedad
string
model_type
Modo de inferencia opcional. Cuando se omite, el servicio de autoría utiliza managed. Cuando se suministre, utilice managed o self_deployed.
model_type?: VoiceModelType
Valor de propiedad
name
El nombre único que el agente debe crear. Debe ser un nombre de agente no vacío tipo DNS.
name: string
Valor de propiedad
string
tools
Las herramientas opcionales se trasladaron literalmente al agente generado (véase VoiceAgentTool).
tools?: VoiceAgentToolUnion[]
Valor de propiedad
use_case
Un caso de uso opcional de autoría. Se acepta una cadena vacía.
use_case?: string
Valor de propiedad
string