apify-generate-output-schema 是做什麼的?
通過分析原始碼為 Apify Actor 生成輸出結構(dataset_schema.json、output_schema.json、key_value_store_schema.json)。在建立或更新 Actor 輸出結構時使用。
說明
此技能允許開發人員從 Apify Actor 的原始碼自動推斷並生成輸出結構。它掃描原始碼中的輸出欄位與對應的資料類型,然後產出三個標準結構檔案:
dataset_schema.json:定義 Actor 資料集的輸出結構。output_schema.json:定義 Actor 主要輸出的結構。key_value_store_schema.json:定義 Actor 鍵值儲存輸出的結構。
使用方式
必要條件
- 您的專案中需要有有效的 Apify Actor 原始碼。
- Apify CLI 或 Apify SDK 需已安裝。
執行技能
使用以下 CLI 命令(假設 Apify CLI 已安裝):
apify run . --skill apify/generate-output-schema
或者,如果使用 Apify SDK:
import { Actor } from 'apify';
await Actor.init();
// 技能邏輯將自動執行
await Actor.exit();
輸出
技能完成後,會在 Actor 目錄中生成以下檔案:
./dataset_schema.json./output_schema.json./key_value_store_schema.json
如果檔案已存在,系統會提示是否覆寫。
支援的平台
- Apify Console
- Apify CLI
- Apify SDK
技術細節
技能會解析 Actor 的原始碼,尋找輸出欄位與資料類型宣告。它支援常見的 JavaScript 與 TypeScript 模式,並能處理複雜的巢狀結構。生成的結構遵循 Apify 的標準格式,確保與其他工具和服務相容。
常見問題
問:我的 Actor 沒有明確的輸出宣告怎麼辦? 答:技能會盡可能推斷輸出結構,但若無法偵測到任何輸出,將生成空的結構檔案。
問:生成的結構不完整怎麼辦? 答:您可以手動編輯產生的 JSON 檔案來補充缺少的欄位。