Vercel UI SDK 登場:AI 用行為組合介面,為什麼不只需要漂亮元件?

UI SDK 讓 AI 以焦點、選取、彈出視窗等行為組合介面,支援五種框架。解析代理技能、直接操作、無障礙驗收與 beta 導入條件。

Share
Vercel UI SDK官方封面,以選單拆解彈出選取與文字尋找三種行為
Vercel UI SDK 官方主視覺,將 Select 分成 createPopup、createSelection 與 createTypeahead 三種行為。 圖片來源:官方原文。

UI SDK 把鍵盤移動、選取與彈出視窗拆成可重用行為,讓 AI 組合介面。畫面能生成只是起點,按鍵、焦點與狀態也要跟著運作。

Vercel 在 2026 年 11 月 12 日發布 UI SDK,官方儲存庫仍將它標為 beta。本文依 11 月 16 日可見的官方介紹與文件整理。

同一組行為可以組成選單、輸入提示或新的自訂控制項,並接到 React、Vue、Svelte、Solid 與 Web Components。它提供互動基礎,不是替每個專案決定外觀。

產品同時希望讓代理更會使用介面,不只更會生成。官網稱直接讀取頁面與操作控制項,比截圖路徑更快、更省,但這是原廠描述,尚不是本文獨立重跑的比較。

我會先選一個團隊常用、又容易漏掉鍵盤操作的控制項試做。若需求只是套用現成樣式,先確認導入行為層是否真的減少維護,不必為新工具重寫整個網站。

要知道它增加了哪一層能力,先把元件的外觀與互動規則分開,再看代理如何把規則組回可操作的介面。

UI SDK 把互動拆成行為,元件不再只是一塊外觀

行為描述控制項怎麼回應鍵盤、滑鼠與狀態變化,外觀則由應用決定。

一個選單可以只有幾行畫面程式,互動規則卻不只幾行。使用者按方向鍵時,焦點應該移到哪裡?按 Escape 關閉後,鍵盤要回到哪個按鈕?這些動作不會因為外觀正確就自動成立。

UI SDK 的做法是把規則拆成行為。SDK 可以理解為提供給開發者與代理的一組工具。這次重點不是替網站選顏色,而是讓控制項有可依循的操作方式。

官方把鍵盤導覽、焦點、選取、彈出、拖放與螢幕閱讀器需要的資訊放進核心。這讓代理生成介面時,可以重用既有規則,而不是每做一個畫面,就重新拼湊一套類似但稍有差異的程式。

例如焦點代表鍵盤目前操作的對象,與滑鼠游標位置不是同一回事。畫面看起來選中了項目,鍵盤焦點卻跑到別處,使用者就可能不知道下一次按鍵會改變什麼,這是需要處理的互動問題。

官方稱已建立五十種以上行為,首頁列出移動焦點、依輸入尋找、調整尺寸與虛擬化清單等例子。數量可以說明涵蓋方向,實際適用與否,仍要看某項控制需要的狀態和規則是否能由它表達。

行為可以重用之後,一個選單就不必從頭實作每一種互動。

Vercel UI SDK官方封面,以選單拆解彈出選取與文字尋找三種行為
Vercel UI SDK 官方主視覺,將 Select 分成 createPopup、createSelection 與 createTypeahead 三種行為。 圖片來源:官方原文。
官方發布示範。 來源:官方原文。

從 Select 拆開,彈出、選取與尋找可以重新組合

官方用 Select 說明,彈出視窗、選取與輸入尋找可以分開組合。

Select 是讓人從選項中選擇的控制項。官方將它拆成 createPopup、createSelection 與 createTypeahead,分別處理彈出位置與關閉、選取狀態,以及輸入幾個字後找到選項。

同一個選擇,不只一種呈現

把這些行為組在一起,可以得到一般選單。加上輸入欄位與不同組合,也可以建立自動完成或組合輸入框。這是產品主張的可組合性,不必每次都受限於一個外觀已固定的成品元件。

官方首頁另以指派同事的選擇器展示組合方式:彈出內容、移動醒目項目、保存已選的人,最後把變更交回應用。這幾件事相關,卻不是同一種狀態,拆開後比較容易知道每個行為負責什麼。

例如鍵盤移到另一個人,不一定代表已經確認指派。如果把醒目位置與正式選取混在一起,使用者只是瀏覽選項,資料卻可能提前改變。把兩個狀態分清,才能依產品需求決定何時送出變更。

行為組合仍然需要任務定義。選單是單選還是多選、能否清空、確認後是否關閉,會影響整體體驗。代理可以協助組裝,團隊仍應提供這些條件,而非只要求做一個看起來相似的選擇器。

同一種組合能運作,還要看它如何進入不同框架的頁面。

五種框架共用行為,畫面仍交給各自的轉接層

核心保存互動規則,框架轉接層把同一套元件部分接到實際畫面。

官方把互動核心放在 @ui-sdk/core,另提供 React、Vue、Svelte、Solid 與 Web Components 的轉接套件。這些框架負責把程式狀態呈現在網頁上,轉接層則讓行為接進各自的元件方式。

README 的範例先定義 primitive,也就是一個控制項的互動結構,再以 createParts 把輸入框、清除按鈕等部分變成框架元件。五種框架共用部分概念,不表示每一段呈現程式都完全相同。

這個拆分有助於讓團隊保留既有技術。若網站使用 Vue,不必因為想用行為核心就先改成 React。但套件整合、狀態如何傳入與樣式如何套上,仍須在原本專案中確認。

也要分清行為與外觀責任。核心可以處理關閉彈出視窗後的焦點,卻不會因此知道品牌色、字體大小或手機版間距。這些是完整介面的一部分,不能在換用行為套件後忽略。

導入前可以先對照目前的控制項拆成哪些部分,再看轉接層是否容易維護。若團隊已有成熟元件,改用新套件應有明確理由,例如減少重複互動程式,而不是只為了讓技術名稱更新。

框架接好之後,生成介面的代理仍要知道這些行為應該怎麼搭配。

加入代理技能,讓生成程式有可依循的互動結構

官方技能讓代理學習行為及組合方式,目標是少寫重複的互動程式。

官方提供 ui-sdk 技能,讓代理學習可用行為與組合方式。技能在這裡是一份可供代理使用的工作知識,不是讓模型突然擁有原本沒有的工具,也不會取代專案自己的需求與規範。

README 同時列出核心與框架轉接套件,以及加入技能的方式。準備工作因此包含讓專案能使用套件,也讓代理知道該如何使用。只有把技能放進對話,專案仍不會自然出現可執行的依賴。

代理收到需求後,可以選擇彈出、清單導覽、選取和變更回報等行為組合。這比要求它每次從空白重寫所有事件更有結構,也讓維護者有機會把問題對回一個特定行為或狀態。

不過,生成程式仍需要檢查。官方稱代理可少寫程式、提高正確性,並沒有替每個專案提供無錯誤保證。若需求沒有說明取消與確認差異,代理即使正確使用行為,也可能組出不符合工作的流程。

比較有用的要求可以是:保留現有外觀,補齊鍵盤移動、取消與確認,並指出各行為負責的狀態。這是本文建議的試作描述,目的在讓結果容易核對,而非把官方技能當成不必驗收的理由。

生成程式能理解結構,也讓產品把注意力延伸到代理使用介面的方式。

直接讀頁面與操作,速度宣稱仍需同條件比較

官方描述代理可直接讀取頁面並操作控制項,效能數字仍屬原廠說法。

UI SDK 官網不只談生成,也描述代理如何使用完成的介面:直接讀取頁面與操作控制項,避免完全依靠截圖判斷下一步。這讓產品同時面向「建造介面」和「操作介面」兩種工作。

直接讀取可提供文字、狀態與結構等資訊,減少從像素猜測控制項的步驟。但能拿到哪些資訊,仍取決於介面如何表達與工具如何整合。不能因此宣稱任意網站都能獲得相同效果。

官網稱這條路徑速度超過兩倍、成本不到一半。這些是原廠比較描述,本文沒有取得可獨立重建所有條件的完整基準,也沒有重跑,因此不能把它當成所有代理工作都會實現的節省比例。

比較要保留相同任務

若團隊想驗證差異,可以固定代理、任務與成功條件,分別記錄完成時間、模型用量與失敗原因。只有速度變快,但控制項狀態讀錯,並不代表原工作已經更有效率。

測試也應包含失敗與恢復。例如選項更新或彈出內容移動後,代理是否仍然知道目前狀態。這比只讓它在已知畫面完成一次操作,更能確認直接讀取是否有助於真實工作。

操作方式變了,對使用者而言,鍵盤和輔助工具的行為仍必須成立。

鍵盤與螢幕閱讀器支援,需要在完整流程驗收

核心處理焦點、選取與 ARIA 等互動資訊,不能據此保證整個網站無障礙。

ARIA 是網頁向輔助技術描述角色、狀態與關係的一組資訊。它能讓螢幕閱讀器更理解一個自訂控制項,但資料必須和實際行為一致,不能只在元素上加幾個名稱就認定可用。

例如控制項宣告已展開,畫面卻已關閉,螢幕閱讀器使用者接收到的狀態就會不同。焦點移動也可能讓使用者離開目前工作,因此鍵盤和可存取資訊需要一起檢查,而非分別看起來正確即可。

官方列出的 createRovingFocus 讓一組項目以方向鍵移動,只保留一個 Tab 停留點。createTypeahead 則以輸入文字尋找項目。這些規則能減少自訂清單常見的操作負擔,但仍需和實際選取流程配合。

完整網站還有標籤、錯誤訊息、閱讀順序與內容結構等問題。核心提供相關行為,不等於整站取得無障礙認證,也不能省略手機觸控與不同輸入方式的檢查。

驗收可以讓測試者只用鍵盤完成選取、取消與再次開啟,再用輔助工具核對名稱與狀態。

驗收範圍清楚後,才適合決定beta套件要放進哪一段工作。

先替換一個難維護的控制項,再決定是否擴大

小範圍試作可同時檢查互動、框架整合與代理操作,不必一次搬動全站。

第一次試作可以選擇目前最容易出錯的一個控制項,而不是整頁重做。例如自訂指派選單常在關閉後丟失焦點,就可以先限制需求,保留外觀,只更換互動方式,方便比較差異。

應先寫出可觀察的條件:方向鍵能否移動、確認前是否保留原資料、取消是否返回原位置,以及重新開啟是否呈現目前選取。這些都可以用相同案例對照修改前後結果。

代理操作也可以用同一個控制項驗證,但應與人的操作分開記錄。兩者使用的資訊和錯誤類型不同。代理完成一次,不代表鍵盤使用者一定能完成,反過來也一樣。

README 仍將 UI SDK 標為 beta,並提醒框架、介面、文件與行為在正式普遍供應前可能變動,也適用 Vercel 的 beta 條款。因此導入時應記錄版本,避免未核對就把最新變動套進正式服務。

我會先用一個可回復的小改動,確認互動程式是否更清楚、測試是否更容易。若原本的元件已能穩定完成工作,就讓試作結果決定擴大範圍,不必因為代理能生成新畫面,就立刻替換整個網站。

當可操作性與維護成本都有改善,再逐步增加共用行為的範圍。

UI SDK 常見問題

UI SDK 的beta狀態、框架轉接與代理技能,應分別確認。

UI SDK 是現成外觀主題嗎?

重點是可重用的互動行為與框架轉接,團隊仍要決定外觀及工作流程,不能把它視為一套固定品牌樣式。

一定要使用 React 嗎?

官方還提供 Vue、Svelte、Solid 與 Web Components 的轉接層。採用前仍需依專案確認套件與整合方式。

官方速度與費用數字是獨立評測嗎?

本篇報導的是原廠描述,沒有重新執行完整比較。自己的任務仍應用相同成功條件驗證時間、費用與可靠性。

目前可以當穩定正式版本嗎?

README 明示 beta,介面與行為可能變動。先固定版本、小範圍驗證,再決定是否擴大導入。

先選一個能重現問題的控制項,讓試作結果回答是否值得導入。

延伸閱讀:Vercel 設計規範實驗:程式掃描零違規,手機頁面為何仍多出 12 像素?

延伸閱讀:Open Intelligent UI 開源:讓 AI 回答變成能操作的圖表與工具

原始資料來源