MODEL ROUTING + PROVIDER PORTABILITY

Keep model providers replaceable behind stable platform contracts.

Agents bind to logical model aliases while the Model Gateway resolves qualified providers, model capabilities, deployment profile, policy, context window, tokenizer, availability and cost constraints. Provider-specific details stay outside the core product contract.

Logical model aliases and the Model Gateway are accepted architecture decisions; concrete provider choices remain lifecycle-qualified adapters.

1logical model contract
Nqualified provider adapters
0silent incompatible fallback

LOGICAL MODEL ALIASES

Product definitions request capabilities rather than hard-coding one provider.

Agent and team definitions reference logical aliases and declared model capabilities. Provider names, endpoints and credentials stay in deployment-specific routing configuration instead of leaking into reusable product contracts.

Logical aliases
Capability matching
Provider-neutral request schema
Structured output support
Tool-call compatibility
Versioned routing policy

QUALIFIED ROUTING

Routing intersects capability, profile, policy, region and current health.

A route is eligible only when the provider and model are qualified for the deployment profile, data class, region, required feature set and current runtime policy. Unsupported paths return explicit incompatibility instead of hidden substitution.

Profile compatibility
Region and data constraints
Policy filters
Provider health
Capacity signals
Explicit failure reasons

CONTEXT COMPATIBILITY

Model changes trigger a fresh context and tokenizer budget calculation.

Context window, tokenizer, structured-output and serialization compatibility are part of the routing decision. Mandatory context that cannot fit produces an explicit context-budget error rather than a silent move to a larger or external model.

Tokenizer-aware budgeting
Context-window validation
Serialization conformance
Output reservation
No silent cross-boundary fallback

LIFECYCLE + EXIT

Provider replacement is planned before production dependency becomes permanent.

Technology fitness, cost, latency, policy and health signals can trigger review. Migration uses compatibility tests, shadow or canary evidence, rollback and exit criteria while stable Projera contracts protect the product layer from vendor-specific rewrites.

Technology fitness
Migration readiness
Shadow or canary
Cost and latency comparison
Rollback
Exit criteria