What delivery formats and hand-off details should be agreed for a pilot?
Agree file formats, directory layout, foreign keys, manifest contents, split columns, environment hand-off items and versioning in the pilot brief so the sample loads without rework.
Agree the delivery shape in the pilot brief so the sample loads into your tooling without rework.
**Formats.** JSONL suits case-level records and trajectories, which are nested and variable in length. Parquet suits large flat tables such as receipts, obligations and allocations, with typed columns. Policies fit well as JSON or YAML with stable rule identifiers. A buyer can ask for either or both.
**Layout.** One directory per release: `receipts`, `obligations`, `allocations`, `policies`, `events`, `cases`, plus `manifest.json` and a `schema` folder. Each file name carries a version.
**Keys.** `receipt_id`, `obligation_id`, `allocation_id`, `rule_id`, `case_id` and `account_id` act as foreign keys across files. Ask for a key-check script or a documented join order.
**Manifest.** It lists file names, record counts, schema version, generation seed, and which fields were produced by rule and which as free text. Ask for checksums so your pipeline can verify the transfer.
**Splits.** A `split` column on cases marks train, validation and test. Request that splits are made by scenario group, not by row, to limit leakage.
**Environment hand-off.** For simulated environments, ask for the tool schemas, the reset call, the grader interface and a seed list so runs can be replicated.
**Versioning.** Regenerated sets should carry a new version and a change note, so you can compare scores between rounds.
Agreeing formats, keys, manifest and versioning up front means the sample loads into your tooling and rounds can be compared.
- Audience:
- Model labs
- Content type:
- Integration
- Buyer question:
- Scope and getting started
Content release: r-a220eb6e099b243b
Related questions
- What delivery formats, splits and versioning should I agree before a first sample?
- What does a scoping meeting for a freight billing agent pilot produce?
- Will I receive real customer payments, and does generated data settle privacy questions?
- What should I ask for in a sample or pilot before committing to a larger release?
- How should I scope a first engagement for a payment matching agent?
- What does a scoping conversation look like for an insurer premium desk pilot?