v4.1.0Home

Graphics & diagrams

Diagrams and annotated illustrations for the concepts you'll bump into across the rest of the docs. Skim them as a refresher or read straight through.

The agent loop

Every Foxora agent runs the same tight five-step loop. The arrows are forward progress; the dashed arc is the feedback that keeps the agent self-correcting until the goal is met.

  • Goal01
  • Plan02
  • Tool call03
  • Observe04
  • Result05
The loop is small on purpose — every step is observable, replayable, and cheap to extend.

Inside each step

Each node above is small enough to inspect on its own — that's why the platform stays predictable even when a task spans hundreds of tool calls.

  1. 01

    You ship the goal

    The agent receives the user's intent — either a free-text message or a structured task envelope from another agent.

  2. 02

    Foxora plans

    The model decides which tools, files, and memory it needs. The plan is stored as a tree of subtasks the agent can revisit.

  3. 03

    Tools fire

    Each step runs through the gateway — auth, rate-limits, logging, billing — before reaching the actual tool implementation.

  4. 04

    The agent observes

    Every tool call returns an observation. The agent decides whether to continue, branch, ask the user, or call another tool.

  5. 05

    You get a result

    When the plan is complete (or the agent decides it can't make progress) you receive a structured answer with citations and a trace.

Trace every step

Every loop iteration is captured in the agent's trace view. Open any run from the dashboard to inspect the plan, tool calls, observations, and token costs side-by-side.

At a glance

The five vocabulary words you'll bump into across the rest of the docs. Each one shows up in traces, code samples, and the dashboard with the same colour and shape.

  • Agentan autonomous loop
  • Planthe tree of subtasks
  • Toola callable capability
  • Observationthe result of a tool call
  • Tracethe recorded run history

Diagram library

Bookmark these for reference — they're updated whenever the product changes. Each card opens to the full annotated version with copyable assets.

Featured · Architecture

Foxora request flow

Walk a single request from your client through auth, routing, the model, billing, and back. Annotated with the exact services involved at each hop.

6 annotated steps6 min readOpen diagram