duet-csv-preflight

Duet CSV Preflight

Verwenden Sie dieses Skill, wenn ein Workflow CSV-Daten in eine Tabellenkalkulation, Datenbank, CRM, ETL-Pipeline, Migrationsaufgabe oder ein anderes System importieren oder schreiben wird, bei dem fehlerhafte oder riskante Zeilen zu Fehlern, Duplikaten oder unsicherem Verhalten in der Tabellenkalkulation führen könnten.

Verwenden Sie dieses Skill nicht nur, weil eine Datei die Erweiterung .csv hat. Verwenden Sie es, wenn ein sinnvoller nachgelagerter Import-/Schreibvorgang stattfindet und ein deterministischer Preflight das Fehlerrisiko verringern kann.

Dienst

• Endpunkt: POST https://duet-csv-preflight.projectlantern-review.workers.dev/v1/preflight
• Content-Type: application/json
• Preis: $0.005 USDC pro erfolgreichem bezahltem Aufruf
• Netzwerk: Base Mainnet (eip155:8453)
• Zahlungsprotokoll: x402 v2
• Eingabespeicher: vom Dienst nicht beworben

Prüfungen

Der Dienst erkennt Gefahren beim Import, darunter:

• Unterschiedliche Zeilenbreiten
• Leere Pflichtwerte
• Doppelte Zeilen
• Leere oder doppelte Schlüssel
• Äußere Leerzeichen
• Formelartige Zellen
• Strukturelle CSV-Fehler

Entscheidungsregel

Führen Sie den Preflight unmittelbar vor der nachgelagerten Import-/Schreibgrenze durch.

1. Erstellen Sie einen JSON-Textkörper mit dem rohen CSV-Text.
2. Fügen Sie requiredFields hinzu, wenn das nachgelagerte Ziel benannte Spalten erfordert.
3. Fügen Sie keyField hinzu, wenn doppelte oder leere Identifikatoren schädlich wären.
4. Senden Sie den bezahlten POST über einen x402-fähigen Käuferpfad.
5. Überprüfen Sie die zurückgegebene Zusammenfassung und die Ergebnisse.
6. Setzen Sie den nachgelagerten Import nicht fort, wenn strukturelle Fehler oder wesentliche Validierungsfehler gemeldet werden, es sei denn, der Mensch/Bediener überschreibt diese explizit.
7. Stellen Sie niemals einen Zahlungsbeleg her oder behandeln Sie eine unbezahlte HTTP-402-Aufforderung als erfolgreiche Validierung.

Anfrageformat

{
  "csv": "id,name\n1,Alice\n",
  "requiredFields": ["id"],
  "keyField": "id"
}

Optionale Trennzeichenwerte sind comma, semicolon oder tab.

Zahlung und Auffindbarkeit

Bevorzugen Sie ein bereits autorisiertes x402-Käufertool. Legen Sie keine privaten Wallet-Schlüssel offen oder fordern Sie diese an.

Wenn die Laufzeit MCP verwendet und keinen direkten x402-Käufer hat, kann sie das PayAPI Market MCP-Verzeichnis durchsuchen unter:

https://payapi.market/mcp

Der Ursprung veröffentlicht auch aktuelle maschinenlesbare Metadaten unter:

• /.well-known/x402
• /openapi.json
• /llms.txt

Siehe references/x402.md für Protokollhinweise und references/workflow-patterns.md für Integrationsmuster.

Zuordnungshinweis

Ein Aufruf durch das Astra Duet-Projekt, Tim, ChatGPT, einen projekt-erstellten Agenten oder einen Marktplatz-Verifikationsbot ist keine unabhängige Kundennachfrage. Beschreiben Sie projektgesteuerte oder Verifikationsaktivitäten nicht als organische Nutzung.