Skip to content
B BYOAg
Menu

Examples

Conceptual flows, not final protocol definitions

These examples use valid JSON to sketch possible packages and submissions. They are draft illustrations for discussion, not final protocol definitions or production integrations.

Education

A student agent retrieves a guided activity. Later, an instructor can retrieve 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"
  }
}

Entertainment and games

An agent retrieves a scene, discusses the choices with the person, and submits their confirmed decision to receive the next scene.

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

Healthcare care navigation

An agent helps a person prepare for a visit and navigate available services. Medical questions are routed to a qualified clinician; the example does not provide diagnosis or treatment.

{
  "purpose": "Prepare for a scheduled care visit.",
  "available_services": ["appointment preparation", "coverage questions"],
  "allowed_actions": ["collect questions", "request scheduling support"],
  "clinical_boundary": "Escalate medical questions to a qualified clinician."
}

Commerce

A service exposes current options and policies. The agent helps the person compare them, but a purchase or subscription remains subject to explicit user confirmation.

{
  "request": "Compare eligible delivery options.",
  "resources": ["catalog.json", "availability.json", "return-policy.md"],
  "allowed_actions": ["compare", "save a shortlist", "prepare checkout"],
  "confirmation_required_for": ["purchase", "subscription"]
}