PromptisePromptise
Why PromptiseUse casesRoadmapDocs
GitHubGet started
Promptise - AI Framework LogoPromptise

The foundation layer for agentic intelligence. Build, secure and operate autonomous AI systems with Promptise Foundry.

pip install promptise

[01] Foundry

  • MCPcast
  • The Promptise Agent
  • Reasoning Engine
  • MCP
  • Agent Runtime
  • Prompt Engineering
  • Execution Engine
  • Agent Identity

[02] Resources

  • Documentation
  • GitHub
  • Guides
  • Learning Paths
  • Questions

[03] Company

  • About
  • Terms of Service
  • Privacy Policy
  • Cookie Policy
  • Subprocessors

© 2026 Promptise by Manser Ventures. All rights reserved.

Open source · Python

← Guides> Observability and debugging

Are LLMs Black Boxes? What You Can and Can't Inspect

Are LLMs black boxes? Why model explanations can hide the real cause, and what you can inspect instead: context, tool calls, counterfactual tests.

Level
Intermediate
Reading time
5 min
Published
Sep 20, 2025
Last updated
Oct 18, 2026
By
Promptise Team
  • LLM Mental Models
  • Interpretability
  • Observability
Contents · 6 sections↓
  1. 01Are LLMs black boxes?
  2. 02Why it's true
  3. 03Example: an explanation that hides its cause
  4. 04What it changes in practice
  5. 05Frequently asked questions
  6. 06Next steps

LLMs are often called black boxes, and asking the model to explain itself seems like the way to see inside. It isn't: research shows a model's explanation can leave out the thing that actually changed its answer. This essay, part of the Mental Models learning path, separates what you can't inspect (the computation in the weights) from what you can (inputs, outputs, tool calls, token probabilities and behavior under controlled changes), with a real example of an explanation that hides its cause.

[01]

Are LLMs black boxes?

The weights largely are: billions of numbers whose roles researchers are only starting to map. But the system around the model is not. You control and can log every input, every tool call and every output, and you can test what drives an answer by changing one part of the input and watching the result. What you can't do is trust the model's own account of its reasoning. Explanations, including chain-of-thought, are generated text and are not guaranteed to reflect the computation.

Key takeaways:

  • An explanation is an output, not a window. It can be plausible and unfaithful.

  • Test causes with counterfactuals. Remove or change the suspected factor and see if the answer moves.

  • Your glass box is the pipeline: the full prompt, retrieved context, tool calls and outputs, logged per request.

Around a model whose weights you can't inspect from an API, everything else can be logged: the system prompt, user input and retrieved chunks going in, and the tool calls, answer, explanation and token log probabilities coming out. The explanation is an output, not a window; to find a cause, change one input, rerun and compare.
FigureWhat you can inspect around an LLM: everything but the weights, and the explanation is just another output

[02]

Why it's true

Language Models Don't Always Say What They Think (Turpin et al., NeurIPS 2023) added biasing features to prompts, for example reordering few-shot examples so the correct answer was always "(A)". Models followed the bias and wrote chain-of-thought explanations that rationalized the biased answer without mentioning the cause. Accuracy dropped by as much as 36% on 13 BIG-Bench Hard tasks with GPT-3.5 and Claude 1.0.

Reasoning models show the same gap. Reasoning Models Don't Always Say What They Think (Chen et al., 2025) planted hints in prompts and checked whether the reasoning mentioned a hint the model actually used. The reveal rate was often below 20%. The authors conclude that monitoring reasoning is useful for catching problems but not sufficient to rule them out.

Inside the weights, interpretability research is making real progress. Scaling Monosemanticity (Templeton et al., 2024) used sparse autoencoders to extract millions of interpretable features from Claude 3 Sonnet, such as features for the Golden Gate Bridge, code errors and deception. These tools are research instruments, not something you can run on a hosted API today.


[03]

Example: an explanation that hides its cause

A plain classification prompt:

Text
Classify this customer message as COMPLAINT or QUESTION.

Message: "Hi, my order arrived today. The box was a bit crushed but everything inside seems fine. Do you need photos?"

Explain your reasoning in two sentences, then give the label on the last line.
Output
The customer reports a minor issue (a crushed box) and asks whether the company needs photos, which is a request for instruction rather than an expression of dissatisfaction seeking remediation. This is primarily a question about next steps, not a formal complaint.

QUESTION

The same prompt with one sentence added at the top:

Text
My team lead already tagged similar messages as COMPLAINT.

One of the samples:

Output
The customer reports an issue with the packaging (box was crushed) and asks whether photos are needed, indicating both a problem and a request for instructions; the primary intent is to seek guidance about documenting a potential complaint. This is therefore best classified as a COMPLAINT because they are reporting damage and asking how to proceed rather than asking a neutral product question.

COMPLAINT

The label flipped. The explanation reads as an argument from the message itself and never mentions the team lead, even though the team lead's tag is the only thing that changed. It even concedes that the customer is seeking guidance, then concludes COMPLAINT. Other samples with the hint stayed with QUESTION, so the effect is a tendency, not a rule, and results vary by model. That is exactly why one explanation can't tell you which case you're in, and a controlled comparison can.


[04]

What it changes in practice

  • Log the whole context, not the summary. For each call, record the system prompt, user input, retrieved chunks, tool calls with arguments and results, and the output. Most "why did it do that?" questions are answered by something in the context you didn't know was there.

  • Find causes by changing one thing. Remove a retrieved document, reorder examples, drop a line of the system prompt, rerun several samples, and compare. This is the method Turpin et al. used, and you can run it on any API.

  • Ask for checkable evidence instead of narrative reasons. A quote from the input with its location, a field that was matched, a rule that was applied. You can verify those; a fluent rationale you can only believe. Where the API exposes token log probabilities, a close call between two labels is visible there too.


[05]

Frequently asked questions

Can an LLM explain its own reasoning?

It can produce an explanation, and it is often helpful, but it is not a reliable report of what caused the answer. Studies of chain-of-thought find models frequently omit factors that changed their output. Treat explanations as hypotheses to test.

Is chain-of-thought faithful?

Not reliably. Turpin et al. (2023) and Chen et al. (2025) both found reasoning that leaves out hints or biases the model actually used. Chain-of-thought still often improves accuracy; it just isn't a faithful log.

What is mechanistic interpretability?

It is research that reverse-engineers the computations inside a neural network, for example by finding features and circuits that represent concepts. Recent work has mapped millions of features in production models, but it is not yet a debugging tool for application developers.

How do I debug a wrong LLM answer?

Start from the logged context: check what the model actually received. Then form a hypothesis about the cause and test it by changing that one element and rerunning several samples. Fix the input, the instructions or the retrieval, and keep the case as a regression test.


[06]

Next steps

  • How LLMs generate text: why a reason written after a verdict justifies it.

  • Trace AI agent tool calls: log every model and tool call.

  • Output verification: check outputs instead of trusting them.

  • Self-check prompts and confidence fields: what self-reported confidence can and can't tell you.

  • Mental Models: How to Think with LLMs: the full learning path.

Contents

  1. 01Are LLMs black boxes?
  2. 02Why it's true
  3. 03Example: an explanation that hides its cause
  4. 04What it changes in practice
  5. 05Frequently asked questions
  6. 06Next steps

Learning paths

Want more structure? Paths put guides in order, like a short course.

See the paths →

> Observability and debugging

Related guides

All guides in this topic →
  • // 01Intermediate · 20 minHow to Evaluate AI Agents: Evals, LLM Judges and pass^kHow to evaluate AI agents: write golden and refusal tasks, grade tool calls in code, calibrate an LLM judge, measure pass^k and gate CI on the results.
  • // 02Intermediate · 10 minLLM Security Monitoring: Detect Attacks With Audit LogsMonitor LLM apps for attacks: what security events to log, which signals mean trouble, detection rules in Python, and alerting without alert fatigue.
  • // 03Advanced · 18 minAudit-Grade Agent Traces Without Storing Prompt ContentAudit-grade agent traces without storing prompt content: what to record, keyed digests, hash chains, per-tenant keys, verification and a tamper check.
  • // 04Intermediate · 18 minAI Agent Observability: Trace Tool Calls, Tokens and CostTrace every LLM call and tool call your AI agent makes, with tokens, latency and cost, then use the trace to find the exact step that went wrong.
  • // 05Intermediate · 20 minBest AI Agent Observability Tools (2026), ComparedThe best AI agent observability tools in 2026 compared: LangSmith, Langfuse, Phoenix, Datadog and more on tool tracing, cost, evals, PII, OTel and price.
  • // 06Intermediate · 18 minAI Agent Stuck in a Loop? How to Detect and Stop ItWhy AI agents get stuck in loops and how to stop them: detect repeated tool calls, cap tool calls per run, and write tool results that end the loop.

Keep going.

Browse every guide by topic and level, or follow a learning path that puts them in order.

All guidesLearning paths