N C D EI IV ER Y Webhook —— 換 Google 來 call 你。 A gents A P I 的同胞雙生。不要 pol l i ng、不要長連接— — a gent 跑完,Gem i ni 主動 P O S T 結果進來。 0 1 · KIC K O FF 建立 interaction 你的 s er ver 呼叫 A gents A P I , webhookUrl 與 m eta da ta 。立刻拿到 interaction_id。 → 02 · GOOGLE WORKS A gent 背景跑任務 幾秒到幾分鐘。你的 server 不用 等、不用連著。 → 0 3 · C A I I B A C K Gemini POST 到你的 webhook 帶 interaction_id、status、完整結 果。IaA/ 簽章 + timestamp,你 負責驗。 → 04 · FAN-OUT 推回使用者 查 interaction_id 跟蹤的 user, 用 LINE Push API 送結果。 W H Y W EB H O O K, N O T P O I I I N G 低延遲 × 低成本 不用輪詢、不用 keep-alive 長連接 At-least-once delivery——設計冪等 handler 適合上百、上千個並行任務 A R C H I T EC T U R A I P A T T ER N Webhook In · Webhook Out 入口:LINE webhook 送使用者訊息進來 出口:Gemini webhook 送 agent 結果進來 中間不 block,server = event handler。 B ui l di ng a ppl i ca ti ons i n the Gem i ni A P I f a m i l y