Lewati ke konten utama

Hooks

Hook client​

Berikan hooks ke AgentChat atau AgentProvider. Model tidak dapat memicu hook atau tindakan client lainnya.

<AgentChat
publishableKey="pk_…"
hooks={{
onTurnEnd: () => track("agent_turn"),
onError: ({ code, message }) => report(code, message),
}}
/>
HookDipicu
onTurnStart()Saat pengguna mengirim pesan
onTurnEnd()Saat turn selesai, gagal, atau dihentikan
onError({ code, message })Saat terjadi error agent. Kode server: step_limit, timeout, error. Kode client: headers_failed, http_<status>, network

Hook yang melempar error akan ditangkap dan dicatat ke konsol sebagai [sideagent] hook threw:. Hook tidak pernah merusak chat. Hook bersifat sinkron: jangan mengandalkan chat untuk menunggu promise yang dikembalikan.

Hook server: onError​

createServer({ onError }) menerima setiap turn yang gagal dengan { agentId, code, threadId, error }. Browser hanya melihat "The agent failed. Try again.", jadi gunakan hook ini untuk mencatat penyebabnya. Hook ini bersifat fire-and-forget, dan error dapat memuat detail dari model provider Anda: catat di server, jangan pernah kirim ke browser. Lihat Server.