Core workflow model
| Workflow | Recommended surfaces |
|---|---|
| Memory write/read | remember, recall, raw control.ingest, raw control.query |
| Context assembly | getContext / get_context, /v2/control/context |
| Learning loop | reflect, recordOutcome / record_outcome, surfaceStrategies / surface_strategies |
| Diagnostics | memoryHealth / memory_health, diagnose |
| Coordination | registerAgent / register_agent, handoff, feedback |
| Explicit planning state | goals, variables, actions, cycles |
Operating guidance
- Use one deterministic
run_id/session_idstrategy. - Prefer helper-first SDK methods for application code.
- Use
checkpointbefore compaction or risky transitions. - Use
getContextrather than rebuilding long prompts manually. - Treat explicit state APIs as complementary to memory, not a replacement for it.
Failure modes and troubleshooting
| Symptom | Root cause | Fix |
|---|---|---|
| Stale or weak responses | Context was built manually and inconsistently | Standardize on getContext() / get_context() |
| The system does not improve across attempts | Reflection or outcome recording is missing | Pair reflect() with recordOutcome() |
| Multi-agent behavior drifts | Roles are implicit | Register agents and persist handoffs / feedback |
Next steps
- Review the full route contract at Control HTTP reference.
- Apply the workflow in Support agent memory loop.