前言¶
DeepSeek Harness (DSH) 插件 xby-toronto-open-data-server 是一個通過 CKAN API 直接訪問多倫多開放數據的工具，由 xby-skill 維護。該插件專爲 LLM 代理設計，旨在解決在智能體開發中獲取結構化開放數據時面臨的 API 複雜性、數據集發現困難以及格式處理繁瑣的問題。它通過封裝多倫多開放數據集的接口，提供了從發現、查詢到預覽的完整工作流。
安裝¶
使用官方提供的命令進行安裝：
dsh plugin --profile web add github:xby_skill/xby-toronto-open-data-server
核心能力¶
插件提供了以下核心功能，覆蓋了數據查詢的全流程：
- set_xby_apikey
用於在對話中設置 API 密鑰。該設置會自動持久化，並在重啓後保持有效。 - toronto_start_here
這是任何多倫多數據查詢的起點。它會解釋如何有效地使用該服務器，並提供訪問多倫多開放數據的完整工作流指南。 - toronto_smart_data_helper
這是處理數據最推薦的方式。它是一個智能輔助工具，接收數據集 ID 和查詢描述，自動判斷數據是 API 可訪問還是需要 CSV 下載，並返回相關數據或下一步建議。 - 數據集發現
包括toronto_list_datasets（列出所有數據集）、toronto_search_datasets（通過關鍵詞搜索）和toronto_popular_datasets（獲取熱門數據集列表）。 - 數據查詢與結構
包括toronto_get_dataset_schema（獲取數據集的字段名、ID 和類型）以及toronto_query_dataset_data（執行精確過濾、排序和字段選擇的高級查詢）。 - 數據獲取
包括toronto_get_dataset_stats（獲取數據集的記錄數、字段信息和資源概覽）以及toronto_fetch_csv_data（下載並返回 CSV 文件的內容或下載鏈接）。
使用示例¶
1. 初始化與發現¶
首先，在對話中調用 set_xby_apikey 設置你的密鑰。然後，使用 toronto_start_here 瞭解工作流，或使用 toronto_search_datasets 查找特定主題的數據。
2. 智能查詢¶
對於大多數使用場景，直接調用 toronto_smart_data_helper。它接受數據集 ID 和目標描述，自動處理後續邏輯。
3. 高級查詢流程¶
如果需要更精細的控制，請遵循以下步驟：
- 使用
toronto_get_dataset_schema(dataset_id)獲取字段名稱和類型。 - 使用
toronto_query_dataset_data進行查詢，傳入精確的字段名。
// 示例：查詢特定條件的記錄
{
"filters": {
"establishment_status": "Pass",
"inspection_date": "2024-01-01"
},
"sorts": "inspection_date desc",
"fields": ["name", "address", "score"]
}
4. 處理 CSV 數據¶
對於 CSV 格式的數據集，toronto_query_dataset_data 會返回下載鏈接而非查詢結果。此時應使用 toronto_fetch_csv_data 來獲取文件內容或直接下載。
注意事項¶
- 優先使用智能助手：
toronto_smart_data_helper是處理大多數用例的推薦方法，它能簡化流程並處理複雜的格式判斷。 - CSV 文件特性：針對 CSV 文件，查詢操作返回的是下載鏈接，而非直接的數據結果。
- 高級查詢依賴：在使用
toronto_query_dataset_data進行高級過濾、排序或字段選擇前，必須先調用toronto_get_dataset_schema獲取正確的字段名。
結語¶
該插件爲 LLM 代理提供了與多倫多開放數據交互的標準接口。通過智能助手和結構化查詢的結合，開發者可以高效地獲取和處理多倫多的公共數據。更多詳情可參考插件目錄或 GitHub 倉庫。
