Skip to main content
AI Development

NVIDIA Switchyard turns model choice into a runtime decision

NVIDIA NeMo Switchyard can route each agent turn to a different model. Its pre-alpha status makes observability—not promised savings—the right first test.

Sean McLellan profile photo

Sean McLellan

Lead Architect & Founder

6 min read
A brass junction directs clear glass spheres from one vertical track into the right of two transparent processing chambers.
Constructed diagramA textless constructed diagram of one input being directed to one of two processing targets; it is not NVIDIA product UI.

NVIDIA introduced NeMo Switchyard on August 11, 2026. The open-source proxy and library can choose among configured AI models while an agent is working, rather than binding the entire workflow to one model in advance.

That changes the operating question. A team no longer has to decide only which model is best; it must decide when the route may change, what context follows the handoff, and how anyone can tell whether routing improved the result. Switchyard is also explicitly pre-alpha and “not for production use,” so the useful move now is an observable experiment—not a production shortcut justified by expected savings.

What did NVIDIA release?

Switchyard sits between an AI application and a pool of model endpoints. Its server accepts OpenAI Chat Completions, OpenAI Responses, and Anthropic Messages requests, translates them into an internal format, selects a configured target, and returns the response in the format the calling application expects.

The target has a semantic name, while a separate client maps that name to a provider endpoint and model ID. NVIDIA’s design therefore keeps the routing policy apart from the exact deployment behind each target. A team could update an endpoint or provider mapping without rewriting the rule that decides when a “capable” or “efficient” target should receive work.

This separation is useful, but protocol compatibility is not proof of behavioral equivalence. Tool schemas, streaming events, cache behavior, reasoning state, and provider errors can still differ behind similar request shapes. A route test must cover the effects the workflow depends on, not only whether the proxy returns a valid response.

The Switchyard repository makes the maturity boundary unusually clear. It describes the project as pre-alpha, says APIs and algorithms are expected to change significantly before version 1.0, and warns that the software is experimental and not for production use. Those statements should govern deployment decisions even though NVIDIA’s launch post discusses production-oriented agent workflows.

How can the route change during an agent session?

Switchyard includes several routing strategies, and they make materially different decisions.

An LLM classifier examines a request and selects a candidate model. It can maintain affinity with that model across later turns so the same conversation is not classified repeatedly. This is closest to assigning a session to a model tier based on the work it appears to contain.

A stage router can reconsider the target as the agent progresses. NVIDIA says it can examine recent tool activity: severe errors, repeated unproductive work, or prolonged exploration can push a turn toward a more capable model, while steady edits after tests pass can favor an efficient model. This turns model choice into part of the workflow state rather than a setting applied once at startup.

An escalation router starts with a lower-cost model and uses a judge to decide whether the same request should move to a more capable target after sustained difficulty. That adds another model call and another judgment boundary. A lower list price does not automatically mean a lower completed-task cost when retries, judging, extra tokens, and routing overhead are included.

NVIDIA also says a route can carry state across a session when the policy needs it, including earlier tool results or an affinity decision, or remain stateless when history is unnecessary. The team implementing the workflow has to choose that boundary. It should not emerge accidentally from a default.

Why is session continuity the harder test?

A one-turn routing demo can show that two endpoints answer through the same proxy. It does not show that a multi-turn agent survives a model handoff.

The receiving model may need tool results, prior commitments, file locations, accepted constraints, or evidence from an earlier turn. If the router sees information that the selected model does not receive, its decision can be sensible while the next action is wrong. If the full conversation follows every route, the supposedly efficient target may inherit a context size and cost profile that removes the expected advantage.

There is also a review problem. A user may see one continuous conversation while the underlying model changes between planning, implementation, recovery, and completion. When the result fails, the operator needs to reconstruct which target handled each turn and what the router knew at that moment.

Switchyard’s reference server records the selected model, decision rationale, token usage, latency, and call outcomes. Its Prometheus metrics cover requests, errors, latency, tokens, and routing overhead. Those are necessary operational signals. They still do not establish whether the business output was correct, complete, or acceptable; that evidence belongs to the workflow using the route.

A clear sphere rests in a central cradle connected to two transparent chambers, beside four colored glass beads.
Constructed diagramA routing decision becomes reviewable only when the request, selected target, operating signals, and outcome can be examined together.

What should a first routing experiment prove?

Start with one repeatable workflow that already has a fixed-model baseline. Use captured, non-sensitive cases with accepted outputs and known failure examples. The baseline matters because a routed system can look cheaper per call while taking more calls to finish—or appear faster while producing work that requires more human correction.

Run one simple policy before combining several. Random routing can provide a controlled comparison across targets. A classifier can test request-level assignment. A stage router can test whether visible workflow signals identify moments when stronger capability is needed. Changing the model pool, policy, prompts, and acceptance criteria at the same time makes the result impossible to attribute.

For each turn, retain the request or a privacy-safe reference to it, the routing policy and version, the selected target, the reason or signals used, latency, token usage, errors, and the eventual task outcome. Then review completed work against the same acceptance bar as the fixed-model baseline. This extends the model bake-off problem we covered earlier: the evaluation harness must treat each candidate fairly, while the routing experiment must also explain which candidate received each part of the work.

The experiment should deliberately force difficult paths. Trigger a tool error, resume an older session, remove one target, exceed a latency threshold, and present a request near the policy boundary. Confirm whether the route escalates, stays pinned, retries, falls back, or stops—and whether the operator can see why.

These are BaristaLabs recommendations, not controls NVIDIA claims Switchyard provides automatically. The project supplies routing strategies, translation, and operational telemetry. The team using it still owns output acceptance, privacy, provider-specific behavior, and authority over consequential actions.

When is routing ready to leave the lab?

A route is not ready because it selected the larger model for a hard prompt and the smaller one for an easy prompt. It is ready for further consideration when repeated cases show that the policy improves a defined outcome without making failures harder to detect or recover from.

The evidence should answer four questions in plain language. Did accepted-output quality hold? Did completed-task cost or latency improve after routing overhead and retries? Did session continuity survive handoffs and resumptions? Could the system return to a fixed known target when routing failed?

Keep the fixed-model path available during the experiment. A dynamic router adds a decision-maker to every eligible turn, so disabling that decision must be simpler than debugging it during an incident. The current repository warning provides an additional stop rule: do not put this pre-alpha implementation in the production request path as if its interface and algorithms were stable.

NVIDIA Switchyard matters because it makes a previously informal idea concrete. Teams already discuss sending routine work to a smaller model and difficult work to a frontier model. The release exposes the machinery required to make that choice at runtime—and the evidence gap that choice creates.

The first business case for model routing is therefore not “use the cheapest model whenever possible.” It is “prove that the organization can explain, evaluate, and reverse every route change.” If you want to structure that test around one real workflow, ask BaristaLabs to review the model-routing experiment.

Sources

Multi-model workflow review

Test one model route before it controls live work

BaristaLabs can help compare a fixed-model baseline with one observable routing policy, including quality review, session continuity, cost, and fallback evidence.

Useful for teams considering multiple model tiers inside one agent workflow.

Turn this idea into a pilot

Which workflow should go first?

Use the readiness check to compare impact, effort, risk, owner, and next step before booking a call.

  • 3-5 minutes
  • Deterministic score
  • No sensitive data
Check workflow readiness

Practical AI Workflow Notes

Want more practical AI operations ideas?

Get short notes on applying AI inside real small-business workflows — from document handling and customer follow-up to internal reporting, compliance, and automation guardrails.

A useful next step if you’re still exploring and not ready to book a 20-minute AI assessment.

Occasional emails. Practical workflow guidance only. Unsubscribe anytime.