Examples

Conceptual flows, not final protocol definitions

These examples use valid JSON to sketch possible packages and submissions. They are draft illustrations for discussion.

Hello World

The environment asks the agent to help the user explain BYOAg in their own words and submit a concise definition.

{
  "byoag_version": "0.1-draft",
  "task": "Explain BYOAg in your own words.",
  "constraints": {
    "max_words": 40,
    "audience": "curious developer"
  },
  "submission": {
    "method": "POST",
    "url": "https://example.org/byoag/hello/submissions"
  }
}

Classroom activity

A student agent retrieves an assignment package. Later, an instructor agent retrieves submissions and a shared evaluation rubric.

{
  "activity": "Compare two explanations of a scientific concept.",
  "resources": ["reading-brief.md", "rubric.json"],
  "time_limit_minutes": 30,
  "submission_schema": {
    "summary": "string",
    "evidence_used": "array",
    "questions_remaining": "array"
  }
}

Interactive adventure

The agent retrieves a scene, discusses available choices with the user, submits the user's decision, and receives the next scene URL.

{
  "scene": "The user is at a locked observatory door.",
  "choices": ["inspect keypad", "search desk", "ask for hint"],
  "continuation": {
    "submit_to": "https://example.org/adventure/scene/7",
    "returns": "next_scene_url"
  }
}