Module 5: Agent Architecture

Smart Is Not Reliable

Why agent reliability is a system property built from checks, constraints, recovery paths, observability, and human escalation.

Core idea

A smart agent can still be unreliable.

Fluency is not the same as truth. Confidence is not the same as completion. A useful agent needs a system around the model that checks reality, handles failure, and knows when to stop.

Reliability comes from the loop, not from the personality of the assistant.

The reality-check loop

A reliable agent keeps returning to evidence:

claim

evidence

action

observation

update, retry, stop, or escalate

The loop matters because the world can disagree with the agent. A file may not exist. A tool may return partial data. A website may change. A command may succeed in one step but fail to produce the intended result.

Reliable systems notice that gap.

Common failure modes

Agents often fail in ordinary ways:

  • they act on stale assumptions
  • they trust a tool result without checking what it means
  • they confuse a success message with actual success
  • they repeat the same failing action too many times
  • they do the same action twice when it is not safely repeatable
  • they keep going after the task has become risky or uncertain

The danger is not only a wrong answer. The danger is an action loop that keeps moving after evidence says it should slow down.

Reliability controls

A reliable agent design adds controls around action:

  1. State checks: verify the starting state before acting.
  2. Result checks: verify what changed after acting.
  3. Error classification: separate temporary errors, missing context, permission problems, and unsafe states.
  4. Bounded retries: try again only when the error suggests a retry may help.
  5. Idempotency awareness: avoid repeating actions that could create duplicate or irreversible effects.
  6. Recovery paths: know whether to roll back, compensate, pause, or ask for help.
  7. Observability: leave enough evidence for a human to understand what happened.
  8. Human escalation: stop before public, financial, account, reputation, data, or irreversible consequences.

These controls make the agent less magical and more useful.

A simple example

Imagine a research helper preparing a reading list.

An unreliable helper says, "I found five sources," even if it only guessed from titles.

A more reliable helper checks whether each source opened, whether the source supports the summary, whether any claim needs a second source, and whether the final list should be reviewed before publication.

The model may be smart, but the system is reliable only when evidence shapes the next step.

Builder checklist

Before trusting an agent with a task, ask:

  1. What does it need to observe before acting?
  2. What result should it verify after acting?
  3. Which actions are safe to retry?
  4. Which actions should happen only once?
  5. What counts as failure?
  6. When should the agent stop?
  7. When should a human decide?

If those answers are missing, the agent may look capable while still being fragile.

Beginner checkpoint

Answer in your own words:

  1. Why can a fluent model still be unreliable?
  2. What is the difference between a tool success message and a verified result?
  3. Why should retries have limits?
  4. What kinds of actions need human escalation?
  5. How does observability protect the human in the loop?

Turtleand take

Reliability is a system property.

A serious agent does not just sound smart. It checks the world, updates from evidence, contains failure, and asks humans at the boundary where consequences increase.