How does set-up map onto an environment's entities, states and tool actions?
Describes how approvals, parties, accounts and obligations become entities with allowed state transitions, and which tool actions and guards an environment could expose to an agent.
Set-up maps cleanly onto a small state machine, which makes it straightforward to wire into an existing environment harness.
A typical mapping:
- **Entities:** approval, party, account or service, obligation (mandate, consent, contact), task, notification - **States:** approved, in set-up, awaiting information, active, referred, rejected - **Transitions:** each tool call moves one entity along an allowed edge, and illegal edges return an error the agent must handle
Tool actions a release could expose include `search_party`, `get_approval`, `create_party`, `open_account`, `attach_obligation`, `set_status`, `raise_referral` and `send_notice`. Each takes record identifiers such as `APP-2187` or `ACC-5530` and returns the changed record, so a harness can log the diff after every step.
Preconditions can be encoded as guards. For instance, `open_account` could fail unless the approval status is approved and its expiry date is in the future. That lets you test whether an agent reads the failure and recovers rather than retrying.
For the evaluation hook, expose a read-only `snapshot()` that returns all entities as JSON, and compare it to an expected end state after the episode. Scope the exact entity list, status vocabulary and guard rules in a pilot, since they differ by domain and by the systems you want to imitate.
A small state machine with guarded transitions lets you test whether agents recover from rejected actions instead of retrying blindly.
- Audience:
- Environment builders
- Content type:
- Integration
- Buyer question:
- What it is and why it matters
Content release: r-a220eb6e099b243b
Related questions
- What is account set-up, and why does it matter for training and evaluating agents?
- What does a set-up decision look like when an applicant already exists in the system?
- Which signs show a set-up workflow is worth using for agent training or evaluation?
- Which upstream and downstream records does an agent link together during set-up?
- Why is account set-up harder for an agent than a single create call?
- What does a near-match customer problem look like during utility service set-up?