Guide an Agent

Guide page — how to use this step in your SDK or loop. For the HTTP endpoint parameters, see Observe / Guide / Feedback. For the product concept, see Execution Memory.

guide compiles governed context for the next Agent turn. It is where Aionis decides what can be used now, what needs inspection, what should be avoided, and what can be rehydrated when detail is needed.

SDK Example


import { agentPromptFromGuide } from "@aionis/sdk";
 
const guide = await aionis.execution.guideForRole({
  agent_id: "worker-2",
  team_id: "checkout-team",
  role: "worker",
  run_id: "run-002",
  task_signature: "checkout-migration",
  query_text: "Continue from the latest accepted checkout route.",
  context_mode: "compact_agent",
});
 
await agent.run(agentPromptFromGuide(guide));

Agent Context Surfaces

Surface	Meaning
`use_now`	Current, trusted enough for direct Agent use.
`inspect_before_use`	Relevant but risky, contested, stale, or incomplete.
`do_not_use`	Failed, suppressed, or unsafe as a route.
`rehydrate`	Pointer to raw evidence that can expand on demand.

Execution Memory renders these surfaces as a contract. That keeps failed branches visible as governed counter-evidence.