• AI reference · Area road

immersive

Ask for an immersive. Ask for an immersive she wants: a finished AATAM piece that fits, or her week's own piece (programme and week), whose cost waits for her yes first. Never say unlimited or instant; say immersive, never session.

Where it is

In the road area (her next step, her taps, coaching moments, her programme, immersives, her review, what waits for her yes, what was made, and her office as her phone reads it): open it with tools_for { area: "road" }, then call it with use_tool { name: "immersive", args }.

Does it need a yes?

Needs the owner's yes: it makes a yes card, and nothing happens until the owner taps yes. Here: a finished piece plays only on her tap; her week's own piece waits for her yes on its cost (an immersive yes card).

Inputs

InputTypeNeededAbout
area"work" | "relationships" | "yourself"yes
situationstringyesThe situation it is for. · format `^[a-z0-9][a-z0-9_.:-]{0,79}$`
programmestringnoHer programme, for her week's own piece. · 1 to 80 characters
weekintegerno1 to 60
wordsstringnoHer situation in her own words, only for her own piece. · up to 500 characters
shapestringnosleep, walk, focus, rest, rehearse or story. · up to 30 characters
request_keystringyesYour key for this one act: the same key again is the same act, never twice. · format `^[A-Za-z0-9][A-Za-z0-9:._-]{0,99}$`
run_idstringyesThe run_id from start. Pass it on every call: it keeps your task held. · 1 to 100 characters

Example

{
  "name": "immersive",
  "arguments": {
    "area": "work",
    "situation": "situation",
    "request_key": "request key",
    "run_id": "the run_id from start"
  }
}

When it is refused

  • invalid: The input isn't right. The sentence names the field and the fix; nothing was done. Fix it and call again.
  • not_found: No such thing in this company (a task, file, person, record). Check the number or name, or list first.
  • not_allowed: Not without another step: the owner's yes, your own task held with pick_up, or a setting the owner turns on. The sentence says which.
  • taken: Someone else holds it (another AI on that task). Pick another task.
  • stale: It changed since you read it. Read it again and use the new version.
  • failed: On our side or a service's, never your input. Try again in a minute; if it keeps failing, call report_problem.