What integration contract should be agreed before a pilot build?
An adapter contract defines how generated assets enter the buyer's runtime, how episodes reset and which tool behaviours require explicit implementation decisions.
Agree a manifest that identifies `release_id`, `schema_version`, `fixture_ref`, `tool_contract_ref` and `evaluation_contract_ref`. The manifest should distinguish supplied generated assets from runtime components the buyer must implement or request within scope.
Define tool behaviour beyond names and argument fields. For `request_evidence`, specify whether the response arrives immediately, creates a pending item or requires another action to advance simulated time. For mutations such as `submit_package`, define whether retries with the same idempotency key return the earlier result or create another submission.
Reset behaviour needs an explicit contract. A reset can select a fixture and seed, clear episode-specific requests and restore role permissions. State which external integrations, if any, sit outside that reset. Evaluation should receive a reset-complete event before the agent starts acting.
JSON Schema can describe tool payloads, while JSONL can carry fixtures and event examples. A buyer can first connect a small fixture to their runtime and exercise reset, one read, one mutation and one rejected action. This establishes whether the adapter honours the agreed behaviour before a larger generated corpus makes integration problems harder to isolate.
Resolve runtime boundaries early so that a usable content release can become a working environment.
- Audience:
- Environment builders
- Content type:
- Integration
- Buyer question:
- Scope and getting started
Content release: r-a220eb6e099b243b
Related questions
- What integration contract should we establish before loading a pilot release?
- What makes a useful first pilot scope for an agent team?
- What licence questions should we resolve before using generated evidence material?
- How can a pilot reveal that the agent needs a different action boundary?
- What should a sample request include before a pilot is agreed?
- How can a pilot expose the limits of concurrent environment behaviour?