DeepSeek Harness (DSH) 採用「一切皆插件」的理念,旨在通過插件機制擴展智能體的能力邊界。在構建需要調用特定外部數據接口的場景時,開發者往往需要自行處理鑑權、數據清洗和 API 對接。xby-the-met 插件封裝了與紐約大都會藝術博物館 (Met Museum) 相關的 API 調用邏輯,爲開發者提供了一套標準化的藏品數據檢索方案。
這是一個專注於大都會博物館藏品數據的聯網檢索工具插件。由 xby-skill 維護,基於 MIT 許可證開源。它主要解決的是如何程序化地訪問 Met Museum 的開放藏品數據庫這一具體需求。
核心功能¶
插件提供以下四個主要能力:
- set_xby_apikey:在對話中設置 API 密鑰。該配置會自動持久化,重啓進程後依然有效。
- list_departments:列出大都會博物館的所有部門信息。
- search_museum_objects:搜索博物館藏品。該接口會首先返回匹配到的總數,隨後是分頁的對象 ID 列表。調用時需使用
page和pageSize參數控制分頁邏輯。 - get_museum_object:根據 Object ID 獲取特定藏品的詳細信息。適用於用戶希望深入瞭解某件具體文物背景的場景。
安裝與啓用¶
使用 DSH 的 CLI 工具安裝該插件。安裝命令需要指定 web profile(基於倉庫配置)。
dsh plugin --profile web add github:xby_skill/xby-the-met
安裝完成後,插件即可在對話中使用。
配置與前置條件¶
在使用插件功能前,需先準備 API 密鑰。插件依賴小笨羊官網提供的 API 服務作爲中轉或數據源。
- 前往 小笨羊官網 註冊賬號。
- 獲取 API 密鑰。
- 在聊天窗口中執行設置命令,將密鑰注入當前會話。
典型用法¶
- 配置環境:在對話中輸入設置密鑰的指令。
- 分頁搜索:若搜索結果較多,需利用
page和pageSize參數逐步獲取 ID 列表。 - 深度查詢:對感興趣的 Object ID 執行詳情獲取,獲取更具體的圖文描述。
適用場景與注意事項¶
- 適用場景:適合需要構建博物館導覽、藝術教育或歷史研究相關應用的開發者。
- 注意事項:插件以當前 DSH 進程的權限運行。使用前建議檢查源碼以確保符合項目規範。插件代碼基於 MIT 協議,可自由使用和修改。