指南
用精靈開始運行
提交精靈嘅每一步，由任務到合約檢查。
提交精靈會設定同開始一次運行。佢有四個步驟：任務、輸入、優化器 同 指標同執行。每個步驟有一個或者多個畫面。呢份指南會講解每個畫面，由任務一直到合約檢查同運行開始。
步驟 1：任務
你想最佳化啲乜嘢？
喺 任務訪談 對話入面，向助手描述你嘅任務。助手會幫你寫兩個欄位：
- 目標（引導：目標）：最佳化之後嘅成品一定要做得好嘅嘢。
- 背景（引導：補充資料）：背景資料、限制，同埋好結果應該係點。
兩個欄位你都可以編輯。助手唔會覆寫你改過嘅內容。
優化對象
揀 成品類型：
| 成品類型 | 會改變乜嘢 |
|---|---|
| 提示詞 | 發送畀語言模型嘅指示 |
| 程式碼 | 一個程式嘅原始碼 |
| DSPy 程式 | 一個 DSPy 模組嘅預測器指示 |
| 文字 | 任何其他文字，例如文件或者範本 |
然後提供 起始版本（引導：起點）。貼上目前嘅版本，或者叫助手寫一個草稿。
最佳化一個倉庫
你亦可以最佳化倉庫入面嘅程式碼。設定以下欄位：
- 倉庫：揀一個倉庫，或者寫成
owner/name。 - 提交：一個 40 字元嘅 SHA。留空就會用分支上面最新嘅提交。
- 優化器可以改嘅路徑：每行一個檔案或者資料夾。一個點代表成個倉庫。
- 安裝指令：評分之前，喺每個全新 checkout 入面運行。留空嘅話，Skynet 會自己搵指令。
步驟 2：輸入
資料
為運行加入案例。你可以：
- 上載 CSV、JSON 或者 Excel 檔案。
- 喺你嘅資料庫揀一個數據集。
點樣讀取資料
助手會讀取資料，再建議點樣用。檢查佢嘅選擇：
- 將每個欄位標記為輸入、預期輸出，或者忽略佢。
- 冇輸出欄位嘅時候，Skynet 會將第一列當做一個輸入。
- 設定點樣分成訓練集、驗證集同測試集。劃分比例加埋一定要等於 1。
步驟 3：優化器
喺標準程度，呢個步驟得一個畫面。佢會顯示優化器、預算，同埋有需要時嘅模型。喺引導同專家程度，呢個步驟有三個畫面：優化器、模型 同 預算。
優化器
精靈只會列出適合你任務同輸入嘅優化器。系統會幫你揀咗 Auto。想用其他優化器，就揀另一個。睇 引擎 同 最佳化點樣運作。
模型
- 任務模型：你嘅運行程式碼會呼叫嘅模型。如果你嘅運行程式碼唔會呼叫模型，就留空。DSPy 程式一定要有任務模型。
- 反思模型：讀取分數同回饋，再寫下一批候選版本嘅模型。用編程代理優化器嘅時候，呢個就係代理嘅模型。
預算
設定運行可以試幾耐，同埋最多可以用幾多錢：
- 最多評分器執行次數（引導：最多嘗試次數）：Skynet 最多會評分嘅候選版本數目。有啲優化器需要最低數目。
- 停止分數（引導：分數去到呢個值就提早停）：當一個版本去到呢個分數，運行就會停。
- 最多迭代次數（引導：最多輪數）：支援呢個設定嘅優化器先會顯示。
- 支出上限：運行最多可以用嘅金額。預設係 $5；如果 開始所需 嘅金額更高，就用嗰個金額。你亦可以揀 無上限。
如果上限或者你嘅結餘低過開始所需嘅金額，精靈唔會畀你繼續。睇 預算同收費。
步驟 4：指標同執行
程式碼同指標
寫兩個檔案：
run.py：喺一個案例上面運行你個成品嘅運行程式碼。metric.py：幫輸出評分同寫回饋嘅指標。
編程代理 可以幫你寫同改任何檔案。佢會檢查自己嘅程式碼，再修好出錯嘅地方。你最多可以加 20 個額外檔案。睇 指標同評分器。
如果你嘅指標會呼叫 llm()，就要設定 指標模型。預設會用反思模型。
合約檢查
合約檢查（引導：試行）會喺沙盒入面，用 3 個樣本案例運行你嘅程式碼同指標。佢會檢查：
- 運行程式碼嘅簽名，
- 指標嘅簽名，
- 指標模型，
- 運行程式碼喺樣本上面嘅結果，
- 指標回傳值。
揀 檢查（引導：試吓）。檢查通過之前，你開始唔到運行。如果你喺通過之後改咗程式碼或者設定，就要再做一次檢查。
排程執行
最佳化成功之後，你可以按排程再運行一次。預設係 已關閉。
準備好執行
最後一個畫面會用五個分頁顯示摘要：一般、資料、模型、預算 同 獎勵。檢查好設定，然後開始最佳化。
摘要亦會顯示運行嘅瀏覽權限。新運行預設係公開。之後可以喺運行頁面嘅 分享與私隱 對話框改。睇 分享同發佈。