Preskoči na glavni sadržaj
Hrvatski— Odaberite jezik
Izbornik

Događaji od klijenta prema poslužitelju

Lekcija 9 od 16 Ažurirano 30. srpnja 2026. Programer
Na ovoj stranici
  1. Poruke koje šalješ
  2. conversation.item.create
  3. conversation.item.delete
  4. response.create i response.cancel
  5. Ključne točke

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.update konfigurira sesiju i može se poslati više puta
  • conversation.item.create omogućuje dodavanje teksta, povijesti ili rezultata funkcija
  • response.create je obavezan u ručnom načinu rada, a automatski u VAD načinu rada
  • response.cancel omogućuje prekidanje agenta kada korisnik ponovno počne govoriti