Task definitions

A task is a bank row keyed by task_id within an environment. Online, the agent sees a natural-language instruction; scoring uses a structured task_spec.

Anatomy

{
  "task_id": "vu.checkout.t098",
  "instruction": "Find me a red hoodie and checkout.",
  "max_steps": 38,
  "verifier_id": "VU-CHECKOUT",
  "task_spec": {
    "task_id": "vu.checkout.t098",
    "variant_id": "named_variant_then_checkout",
    "goal": "Find me a red hoodie and checkout.",
    "success_criteria_id": "SC_CHECKOUT",
    "constraints": {
      "clean_cart_required": true,
      "must_be_in_stock": true
    },
    "target_query": "hoodie",
    "target_sku": "B07HOODIE02",
    "target_variant_name": "Red",
    "verifier_id": "VU-CHECKOUT",
    "matching_policy": "deterministic_sparse_reasoned",
    "require_needs_confirmation": true,
    "profile_id": "U_001"
  },
  "harbor_reset": {
    "seed": 18421,
    "fixture_id": "fixture1",
    "max_steps": 38,
    "task_spec": { "...": "same as task_spec above" }
  }
}

harbor_reset is a legacy field name for the env reset payload used by POST /v1/env/reset. Prefer thinking of it as “reset package.”

Important fields

Field	Role
`task_id`	Stable id (`vu.<family>.tNNN`)
`instruction` / `goal`	What the agent is told
`success_criteria_id`	Router into verifier family (`SC_CHECKOUT`, `SC_ADD_TO_CART`, …)
`verifier_id`	Specific VU implementation (`VU-CHECKOUT`, `VU-SEARCH-ADD`, …)
`target_*`	Expected query / SKU / variant / qty / category
`constraints`	e.g. `clean_cart_required`, `must_be_in_stock`, budget / Prime
`require_needs_confirmation`	Enables confirmation latches before irreversible actions
`matching_policy`	How catalog matches are chosen
`profile_id`	Seeded user profile (`U_001` …)
`harbor_reset`	Exact payload for `POST /v1/env/reset` (legacy name)

Bundles

Task libraries are JSONL bundles per environment. Shopping environments commonly include:

Bundle	Example tasks	Typical verifiers
`checkout`	`vu.checkout.t098`	`VU-CHECKOUT`
`search_add_checkout`	`vu.search.add.t309`	`VU-SEARCH-ADD`, `VU-FILTER-ADD`, `VU-CHEAPEST-QTY`
`reasoning_checkout`	`vu.reason.compare.t103`	`VU-BUDGET-FALLBACK`, `VU-COMPARE-SWAP`
`cart_mutation`	`vu.cart.qty.t077`	`VU-QTY-ADJUST`

Pharmacy retail (cvs_gym) has its own checkout / hard-task families on the same control plane.

Fetching tasks

# Ordered task list for evaluations
curl -s https://agi.akhara.ai/evaluations/tasks

# Dashboard task detail
curl -s https://agi.akhara.ai/dashboard/tasks/vu.checkout.t098 | python3 -m json.tool

Also: GET https://agi.akhara.ai/dashboard/tasks (filters: bundle, category, search).

Open / free-play tasks

For unscored exploration, POST /runs/open accepts a free-form task_definition string (no library row, no verifiers, reward 0.0). See Evaluations API.

Sample-pack format

Offline packs use schema akhara.harbor.task_definition.v1 under tasks/<task_id>/task_definition.json (metadata + library row + live task_spec). See Sample trajectories.

Getting started

Mechanics

API reference

Scores and trajectories

Task definitions

Anatomy

Important fields

Bundles

Fetching tasks

Open / free-play tasks

Sample-pack format

​Anatomy

​Important fields

​Bundles

​Fetching tasks

​Open / free-play tasks

​Sample-pack format

Anatomy

Important fields

Bundles

Fetching tasks

Open / free-play tasks

Sample-pack format