Teammately Docs
Docs menu

task

Import and prepare cases

Bring cases into the project, conform them to Project Input Schema, inspect materials, and prepare benchmark selection.

Import and prepare cases

Bring existing examples into the project and make them usable by experts, coverage work, and Harness execution without losing their input or material boundaries.

Prerequisites

  • A saved Project Input Schema.
  • Source examples with identifiable primary input.
  • Required case materials and accepted artifact formats.
  • A selected project and permission to manage Cases.

Steps

  1. Review Project Settings → Input Schema and confirm plain-text, chat, or structured architecture.
  2. Identify the primary input for each source example and map it to content.input.
  3. Map supporting values or artifacts to declared content.case_materials keys.
  4. Reject or correct records missing required materials, using unsupported artifact types, or violating the structured schema.
  5. Import or create the Cases through the available product path.
  6. Open representative Cases and inspect the rendered case view. Confirm that inputs, materials, labels, and source authority are understandable without private explanation.
  7. Classify or connect the relevant Coverage Facets.
  8. Select reviewed Cases in Benchmark Datasets and create a snapshot when the membership defines a new evaluation boundary.
Case Pool upload step with a file drop area for CSV, JSON, or JSONL source records before column mapping.

The upload step stages source records. Continue through column mapping and inspect representative rendered Cases before selecting them for a Benchmark.

Object and state changes

This task creates project Cases and may attach artifact records, material references, coverage classifications, and benchmark selection. The rendered case view is derived from canonical content. Selecting a Case for one benchmark does not remove it from the reusable project pool or select it for every benchmark.

Success criteria

  • Every Case conforms to the Project Input Schema.
  • Required materials are present and use accepted formats.
  • The rendered case view preserves the intended input and evidence.
  • Cases can be understood by an expert and delivered to a Harness.
  • Benchmark selection and snapshot state are explicit.

Common failure modes

  • Putting supporting documents into an unstructured metadata field.
  • Treating candidate responses as the primary case input.
  • Importing artifacts the project schema does not admit.
  • Selecting unclear Cases into a benchmark before review.
  • Changing case content while comparing Runs against an earlier snapshot.

Worked example

Example: import chat cases with documents

A project uses chat architecture and requires a policy_document material. The operator maps each conversation to canonical messages, attaches the controlling PDF, rejects rows without the document, and inspects rendered case views. Only reviewed Cases are selected for the benchmark snapshot.

Related reference pages

Reference / AssetsCasesUnderstand canonical project cases, their input and materials, and how they become members of benchmark datasets.Reference / Project SettingsProject Input SchemaDefine the canonical input architecture, case-material fields, and accepted artifact formats for project cases.Concept / Benchmark DatasetsBenchmark DatasetsSelect benchmark Cases, inspect representation, and freeze immutable Snapshots for reproducible evidence.

Related troubleshooting pages

Troubleshooting / Recovery LibraryCase upload troubleshootingRepair uploads with rejected rows, missing inputs, incorrect column mapping, or Cases that arrive without usable context.Troubleshooting / Recovery LibraryUnclear CasesRepair Cases that informed reviewers cannot interpret consistently from the supplied input, context, and output identity.Troubleshooting / Recovery LibraryMissing OutputsSeparate a missing managed Run response from an unmatched row in an imported output-only Run.

Source confidence

Code-backed: the active Cases surface and case-content contract support canonical input, materials, rendering, and schema validation. Exact import mechanisms can depend on the available product configuration.

Found something unclear?

Report outdated, unsupported, or confusing docs so we can fix the source page.

Report a docs issue

Continue learning

Related docs

Assets Cases Understand canonical project cases, their input and materials, and how they become members of benchmark datasets. Project Settings Project Input Schema Define the canonical input architecture, case-material fields, and accepted artifact formats for project cases. Benchmark Datasets Benchmark Datasets Select benchmark Cases, inspect representation, and freeze immutable Snapshots for reproducible evidence.
AI context