Događaji od klijenta prema poslužitelju
Na ovoj stranici
Poruke koje šalješ
Voice Agent API funkcionira razmjenom JSON događaja putem WebSocket veze. U ovoj lekciji proći ćeš kroz svaki događaj koji tvoja aplikacija može poslati poslužitelju. Svaki od njih ima specifičnu ulogu u ciklusu razgovora.
| Događaj | Opis | Kada ga koristiti |
|---|---|---|
| session.update | Konfiguriranje sesije | Prilikom pokretanja i za promjenu konfiguracije |
| input_audio_buffer.append | Slanje audio isječka u base64 formatu | Kontinuirano tijekom snimanja |
| input_audio_buffer.commit | Potvrđivanje audio međuspremnika | U načinu rada „pritisni za govor“ (push-to-talk) |
| input_audio_buffer.clear | Pražnjenje međuspremnika bez obrade | Za otkazivanje snimanja |
| conversation.item.create | Dodavanje poruke ili rezultata funkcije | Povijest, kontekst, rezultati funkcija |
| conversation.item.delete | Brisanje stavke po ID-u | Čišćenje povijesti razgovora |
| response.create | Zahtijevanje odgovora | U ručnom načinu rada (automatski s VAD-om) |
| response.cancel | Otkazivanje odgovora u tijeku | Kada korisnik prekine agenta |
conversation.item.create
Ovaj događaj omogućuje ti ubacivanje poruka u razgovor bez prolaska kroz audio stream. Pokriva tri glavna slučaja.
Dodavanje tekstualne poruke korisnika
{
"type": "conversation.item.create",
"item": {
"type": "message",
"role": "user",
"content": [
{
"type": "input_text",
"text": "What's the status of my order 12345?"
}
]
}
}
Ubacivanje povijesti razgovora
Prije početka glasovnog razgovora, možeš unaprijed ispuniti povijest ranijim razmjenama kako bi agent dobio kontekst:
{
"type": "conversation.item.create",
"item": {
"type": "message",
"role": "assistant",
"content": [
{
"type": "text",
"text": "Hello, I'm your assistant. How can I help you?"
}
]
}
}
Vraćanje rezultata funkcije
Nakon što se funkcija izvrši, rezultat vraćaš ovim događajem (vidi lekciju 13 o pozivanju funkcija):
{
"type": "conversation.item.create",
"item": {
"type": "function_call_output",
"call_id": "call_abc123",
"output": "{\"status\": \"shipped\", \"tracking\": \"FR123456789\"}"
}
}
conversation.item.delete
Briše stavku razgovora prema njezinom ID-u:
{
"type": "conversation.item.delete",
"item_id": "item_audio_001"
}
Ovo je korisno za uklanjanje netočne poruke ili za sprječavanje prekomjernog rasta povijesti razgovora.
response.create i response.cancel
response.create izričito traži od poslužitelja da generira odgovor. U VAD načinu rada poslužitelj to radi samostalno čim detektira kraj govora:
{
"type": "response.create"
}
response.cancel zaustavlja odgovor koji se generira. Korisno je kada korisnik progovori dok agent govori:
{
"type": "response.cancel"
}
Ključne točke
- Osam vrsta događaja može se poslati od klijenta prema poslužitelju
session.updatekonfigurira sesiju i može se poslati više putaconversation.item.createomogućuje dodavanje teksta, povijesti ili rezultata funkcijaresponse.createje obavezan u ručnom načinu rada, a automatski u VAD načinu radaresponse.cancelomogućuje prekidanje agenta kada korisnik ponovno počne govoriti