NewEvery agent tool call now routes through the governed MCP gateway — policy check, audit log, then dispatch.Read the changelogarrow_forward
XOOZLYAI Orchestrator
routeHow it workssmart_toyAgent fleetshieldGovernance & trustsellPricingmenu_bookDocsarticleBloghistoryChangelog
Log inStart free
grid_viewProductsrouteHow it workssmart_toyAgent fleetshieldGovernance & trustsellPricingmenu_bookDocsarticleBloghistoryChangelogHelp centreLog in
Start free
  1. XOOZLY
  2. chevron_rightDocumentation
Loading the knowledge base…
XOOZLYAI Orchestrator

Ready to orchestrate your AI fleet with total confidence?

Start a project, set a cost cap, and watch the loop run with every tool call policy-checked and logged before it leaves the platform.

Start freearrow_forwardSee what shipped
  • check_circleNo credit card required
  • check_circleYour keys, your model spend
  • check_circleEvery tool call audited

Platform

  • All productsarrow_forward
  • Orchestration looparrow_forward
  • Agent fleetarrow_forward
  • Governed control planearrow_forward
  • Pricingarrow_forward

Trust & legal

  • Trust centrearrow_forward
  • Security & compliancearrow_forward
  • AI use policyarrow_forward
  • Report a vulnerabilityarrow_forward
  • Data subject requestsarrow_forward

Resources

  • Documentation & guidesarrow_forward
  • Engineering & research blogarrow_forward
  • Changelogarrow_forward
  • Uptime & reliabilityarrow_forward

Browse by domain

  • Strategy & Researcharrow_forward
  • Developmentarrow_forward
  • QAarrow_forward
  • Governance & Orchestrationarrow_forward
  • All 10 domainsarrow_forward
XOOZLY
© 2026 XOOZLY · 61 agents · 10 domains · 8 SDLC stationsAI use policyarrow_forwardLog inarrow_forward99.9% uptime SLAarrow_forward
  1. XOOZLY
  2. chevron_rightDocumentation
  3. chevron_rightGuide
Loading this guide…
  1. XOOZLY
  2. chevron_rightDocumentation
  3. chevron_rightFailed step diagnostics and human-in-the-loop corrective actions
arrow_backBack to the knowledge base
schedule1 min read·verifiedChecked against the code on 25 October 2026
Agent fleets & observabilityfailed-step-diagnosticscodeapi-server/orchestrator/nodes/station.pycodeapi-server/orchestrator/run_lifecycle.py

Observability

Failed step diagnostics and human-in-the-loop corrective actions

A failed station does not quietly try again. It stops with the state it actually produced and surfaces for evaluation, which is what makes the next decision a person's rather than a retry loop's.

open_in_newOpen Orchestration dashboard in the consolearrow_forward
01

A failed station does not retry itself

A station that cannot proceed stops and surfaces, carrying the state it actually produced rather than the state it was supposed to produce. It does not quietly try again with stale context.

troubleshootWhy the failure is left where it happenedThis is why a failed run is diagnosable: the recorded state is the real one. A retry loop that overwrote it would leave you reasoning about the last attempt rather than the first failure.
02

The failure most first runs hit

keyThe failure you will see firstIn an environment with no AI provider API key configured, every run stops at the same place: immediately after planning begins, with a specific “provider key not configured” error. If that is what you are seeing, the fleet is wired correctly and is missing one credential.
03

Reading the failure

Start from the recorded state rather than the error at the end. The first station whose output stopped matching what the next one needed is usually the real problem; the station that eventually failed is often just the first one that could not continue.

  1. 1Open the run's traceRead from the top, in station order.
  2. 2Find the first surprising outputNot the first error — the first output that is not what the next station was going to need.
  3. 3Check whether a tool call was involvedA refused tool call is recorded with its reason, which is frequently the whole explanation.
04

Correcting and re-running

Because nothing retried itself and nothing was overwritten, correcting means changing the thing that was actually wrong — a rule file, a grant, a connection — and starting a new run. The failed run stays as the record of what happened.

restart_altA new run, not a resumed oneA run is one pass through the stations. Fixing the cause and running again is the normal recovery, and it leaves both runs in the history, which is what makes the fix auditable.

boltPut it into practice

Run a fleet with these guardrails on from day one.

Hard cost caps, one audited gateway in front of every tool call, and versioned rule files — the defaults, not an enterprise add-on.

Start freearrow_forward

On this page

4 sections
  1. 1. A failed station does not retry itselfchevron_right
  2. 2. The failure most first runs hitchevron_right
  3. 3. Reading the failurechevron_right
  4. 4. Correcting and re-runningchevron_right
feedbackSomething missing?

Related guides

  • articleReviewing Rule Optimizer automated proposalsApproval queue
  • articleInterpreting execution traces in the Trace ViewerCycle history
  • articleLong-running asynchronous agent execution trackingGlobal jobs dashboard