Vercel Perplexity 套件 5.0.0 改接 Agent API，搜尋與串流整合須遷移

Vercel 於 9 月 26 日發布 `@ai-sdk/perplexity` 5.0.0，將語言生成從 Sonar Chat Completions 切換至 Perplexity Agent API，並列為破壞相容性的更新。既有 Sonar 模型識別碼與供應商選項，須改用新介面的預設配置、模型與工具設定；請求、回應及用量資料的格式也有變動。[發布說明](https://github.com/vercel/ai/releases/tag/%40ai-sdk/perplexity%405.0.0)

技術上的主要差異是一次請求能包含多步工具執行。在底層 API，原本的 `messages` 改為 `input`，回傳內容由 `choices` 改為帶型別的 `output` 陣列，分別承載答案、搜尋結果及其他執行步驟。這讓應用程式可以檢查中間過程，也代表直接解析原始回應的程式碼需要調整。[官方介面比較](https://docs.perplexity.ai/docs/agent-api/migrate-from-sonar/overview)

搜尋設定同樣需要搬移。官方指南指出，時效與網域篩選參數改放在 `web_search` 工具的 `filters` 內；直接指定模型時，必須另加搜尋工具。原始串流則改為依事件型別處理，文字增量、工具呼叫與推理各有事件。這些是底層協定變更；使用套件統一介面的應用，仍須核對自行存取的供應商中繼資料。[遷移指南](https://docs.perplexity.ai/docs/agent-api/migrate-from-sonar/how-to)

這次套件更新也補強串流完整性：從結束事件補回漏收的文字，避免重複已收到的增量，並保留引用註記與搜尋結果識別碼，同一來源網址僅送出一次。不過，發布說明明列新介面不支援原有 Sonar PDF 輸入及圖片、影片結果，使用這些功能的產品須另行處理。[版本變更](https://github.com/vercel/ai/releases/tag/%40ai-sdk/perplexity%405.0.0)

停用時程仍有官方資料不一致的限制。Perplexity 八月公告將 Sonar 端點退役日訂為 9 月 27 日，但本次查閱的遷移總覽仍寫著持續支援 Sonar，因此不能僅憑公告斷言舊端點已全面停止服務。[原公告](https://community.perplexity.ai/t/sonar-is-moving-to-the-agent-api/5802)、[現行文件](https://docs.perplexity.ai/docs/agent-api/migrate-from-sonar/overview)

從上述變更判斷，升級驗證應涵蓋完整答案、引用對應、搜尋限制及成本紀錄，並測試未完成回應與多種工具事件。例如，引用元件若以舊陣列位置對應來源，或帳務系統固定讀取舊成本欄位，即使畫面仍有文字，也不能視為遷移完成。工程團隊接下來應確認官方是否統一支援時程，以及套件在實際工作負載中能否保留原有搜尋品質與可追溯性。