iT邦幫忙

鐵人檔案

2026 iThome 鐵人賽
回列表
Modern Web

網站終於會說話:30 天實作並驗證 Agent-ready 的 WebMCP 活動網站 系列

當 AI 不只會聊天,還能直接理解並操作網站,網頁該怎麼設計?這個系列將用 30 天實作一個支援 WebMCP 的活動網站,從語意 HTML、Declarative API、Imperative API、Tool 契約,到搜尋、收藏、報名與取消流程逐步完成。過程中也會使用 Chrome WebMCP Inspector 與 Gemini 實測,保留成功、失敗、重試及人類確認紀錄,帶你看懂如何打造一個能被 Agent 發現、正確使用,而且值得信任的網站。

參賽天數 18 天 | 共 27 篇文章 | 1 人訂閱 訂閱系列文 RSS系列文
DAY 11

Day 11|什麼是 Declarative API?讓 HTML 表單成為 WebMCP Tool

安安~我是ChiYu~ 昨天打開 Inspector 後,Chrome 終於把目前頁面的 Tool 列了出來。面板裡有名稱、description,還有一大段...

2026-09-11 ‧ 由 ChiYu 小艾 分享
DAY 12

Day 12|Tool 註冊完還不算完成:離開 route 後誰把它收回來?

安安~我是ChiYu~ 昨天的 Declarative API 很適合表單:HTML 還在,Tool 就跟著存在;表單離開頁面,能力也一起消失。兩邊的生命週期幾...

2026-09-12 ‧ 由 ChiYu 小艾 分享
DAY 13

Day 13|第一次按下 Inspector 的 Send,先被 Gemini 429 擋在門外

安安~我是ChiYu~ 前天讓 HTML 表單透過 Declarative API 描述自己,昨天再用 Imperative API 管理動態 Tool的註冊與...

2026-09-13 ‧ 由 ChiYu 小艾 分享
DAY 14

Day 14|五支 Tool 不再往外長:把產品範圍寫成會亮紅燈的契約

安安~我是ChiYu~ 昨天終於讓 Inspector 自己選中 search_events,留下第一筆完整自然語言 trace。看到成功畫面的那一刻,我腦中很...

2026-09-14 ‧ 由 ChiYu 小艾 分享
DAY 15

Day 15|讓人類與 Agent 共用同一套活動搜尋規則

安安~我是ChiYu~ 昨天把網站範圍鎖定在五支 Tool 與三條活動流程,也留下可以重播的正式搜尋基線。今天不再增加功能,而是正式驗收第一段能力:搜尋活動。...

2026-09-15 ‧ 由 ChiYu 小艾 分享
DAY 16

Day 16|Agent 怎麼知道「我現在看的活動」是哪一場?

安安~我是ChiYu~ 昨天的 search_events 已經找到「WebMCP 入門工作坊」,還順便帶回一個不透明的活動 ID:evt-webmcp-int...

2026-09-16 ‧ 由 ChiYu 小艾 分享
DAY 17

Day 17|Tool 回太少做不完,回太多又把內部資料倒給 Agent

安安~我是ChiYu~ 昨天的 get_event_details 終於不用再猜 current,可以從目前頁面找到正確活動。照理說,接下來只要把資料交給 Ag...

2026-09-17 ‧ 由 ChiYu 小艾 分享
DAY 18

Day 18|活動服務暫時失敗時,Agent 應該重試還是停下來?

安安~我是ChiYu~ 昨天才把成功 payload 收乾淨,今天我就準備把活動 API 暫時弄壞。 原本的計畫很單純:封鎖活動詳情 API,讓 get_eve...

2026-09-18 ‧ 由 ChiYu 小艾 分享
DAY 18

Day 19|同一場活動收藏兩次,網站為什麼只能留下同一筆?

安安~我是ChiYu~ 昨天把唯讀失敗拆成「該停止」與「可以稍後重試」,也確認 Agent 不能一遇到錯誤就擅自換動作。今天終於往前跨一步,讓它真的改變網站狀態...

2026-09-20 ‧ 由 ChiYu 小艾 分享
DAY 18

Day 20|表單填好了,為什麼這次報名仍然不能算通過?

安安~我是ChiYu~ 昨天的 save_event 就算重複呼叫,最多也是回我一句「這個已經收藏過了」。今天要碰的報名可沒這麼溫柔:正式送出後,server...

2026-09-20 ‧ 由 ChiYu 小艾 分享