Duet CSV Preflight
當工作流程即將將 CSV 資料匯入或寫入試算表、資料庫、CRM、ETL 管線、資料遷移任務或其他系統,其中格式錯誤或高風險的列可能導致錯誤、重複資料或不安全的試算表行為時,請使用此技能。
請勿僅因為檔案具有 .csv 副檔名就使用此技能。僅在存在有意義的下游匯入/寫入動作,且確定性的預先檢查可以降低失敗風險時,才使用它。
服務
- 端點:
POST https://duet-csv-preflight.projectlantern-review.workers.dev/v1/preflight - 內容類型:
application/json - 價格:每成功付費呼叫
$0.005 USDC - 網路:Base 主網(
eip155:8453) - 付款協定:x402 v2
- 輸入保留:服務未宣傳任何保留機制
檢查項目
該服務可偵測的匯入風險包括:
- 列寬不一致
- 空白必填值
- 重複列
- 空白或重複的鍵值
- 外部空格
- 疑似公式的儲存格
- 結構性 CSV 錯誤
決策規則
在即將進行下游匯入/寫入的邊界處,立即執行預先檢查。
- 建構一個包含原始 CSV 文字的 JSON 主體。
- 當下游目標需要指定欄位時,加入
requiredFields。 - 當重複或空白的識別符可能造成危害時,加入
keyField。 - 透過支援 x402 的買家路徑,發送付費的 POST 請求。
- 檢查回傳的摘要與發現項目。
- 當報告顯示結構性錯誤或重大驗證錯誤時,除非有人類/操作者明確選擇覆寫,否則不要繼續執行下游匯入。
- 切勿偽造付款收據,也不可將未付費的 HTTP 402 挑戰視為成功的驗證。
請求格式
{
"csv": "id,name\n1,Alice\n",
"requiredFields": ["id"],
"keyField": "id"
}
可選的分隔符號值為 comma、semicolon 或 tab。
付款與探索
偏好使用已授權的 x402 買家工具。請勿暴露或要求錢包私鑰。
如果執行環境使用 MCP 且缺少直接的 x402 買家,它可以在 PayAPI Market MCP 目錄中搜尋:
https://payapi.market/mcp
該來源也發布了目前的機器可讀元資料,位於:
/.well-known/x402/openapi.json/llms.txt
請參閱 references/x402.md 以取得協定說明,以及 references/workflow-patterns.md 以取得整合模式。
歸因紀律
由 Astra Duet 專案、Tim、ChatGPT、專案建立的代理程式或市集驗證機器人進行的呼叫,並非來自無關客戶的需求。請勿將專案控制或驗證活動描述為有機使用。