Case study · agent infrastructure · verified public release

Let people test the systems. Keep cost and credentials bounded.

Agentic Systems Gateway provides one policy boundary for zero-cost replay, optional visitor-owned NVIDIA NIM or OpenRouter inference, system discovery, release evaluation, signed receipts, and operational telemetry.

Direct answer

Agentic Systems Gateway demonstrates how a public portfolio can expose real, input-sensitive system behavior without storing visitor keys, lending an owner-funded provider credential, accepting arbitrary model endpoints, or confusing release evidence with client production acceptance.

Agentic Systems Gateway context showing visitor and system clients, typed policy controls, replay and fixed provider adapters, signed redacted receipts, evaluation registry, persistence, and observability.
System context and infrastructure. All requests pass through typed validation and deterministic policy before replay or a fixed provider. Receipts retain hashes and usage metadata, never prompts or visitor keys.
18/18release evaluation measures at target
0external business actions
Evidencegreen CI, 85 automated tests, 18 release evaluation measures, Docker and PostgreSQL restart proof, production Postman assertions, exact-artifact Vercel promotion, browser input-sensitivity testing, and a zero 5xx runtime review.

Case-study figures describe this documented engagement and are not forecasts or guarantees.

The operating constraint

A public agent portfolio creates a difficult operating boundary. Visitors need a working path when free providers are unavailable, live model calls cannot create an open-ended owner bill, API keys must not enter logs or storage, and a passing test suite must not be presented as evidence that a client accepted a production integration.

The system Aixcel designed

Aixcel built a strict FastAPI and Pydantic control plane with a nine-system registry, nine evidence-qualified evaluation records, fixed NVIDIA NIM and OpenRouter provider adapters, deterministic evidence replay, request quotas, prompt-injection checks, HMAC-signed receipts, an optional redacted SQL ledger, generated OpenAPI, and a persistent light and dark workspace. LangGraph is intentionally excluded because this component is a deterministic policy boundary rather than an agent reasoning workflow. The browser sends a visitor key in one request header and clears the field after use. It cannot supply a model name, endpoint, tool, or external action. SQLAlchemy, Alembic, PostgreSQL, OpenTelemetry, Prometheus, Structlog, Docker, GitHub Actions, Postman, Playwright, and a pinned Linux Vercel builder complete the release path.

The documented result

The public deployment exposes nine systems and their tested release boundaries. Replay works without a model account and changes when evidence changes. Live NVIDIA NIM and OpenRouter paths require a visitor-owned key. Shared NVIDIA access exists as a disabled code path and cannot create spend until a durable cross-instance quota store, approved key, monitoring, and an explicit cost decision are supplied. The verified release passed 85 tests at 84.95 percent measured coverage, 18 of 18 evaluation measures, 12 production requests with 40 Postman assertions, four durable redacted receipts across a PostgreSQL API restart, desktop and 390-pixel browser journeys, seven rendered Swagger operations, persistent themes, zero browser errors, and zero production 5xx responses.

System components

Python 3.12, uv, FastAPI, Pydantic v2, httpx, SQLAlchemy, PostgreSQL 17, Alembic, REST, OpenAPI, Postman, HMAC receipts, OpenTelemetry, Prometheus, Structlog, Docker, GitHub Actions, Playwright, Vercel

What each framework is doing here.

A framework earns its place by owning a clear responsibility in the system, not by appearing in a technology list.

Framework

FastAPI and Pydantic v2

What it is: FastAPI is an async Python API framework. Pydantic validates and serializes typed contracts.

Why it is here: They reject malformed input and generate the same OpenAPI contract used by the browser, Postman, and external reviewers.

Framework

httpx

What it is: httpx is an async HTTP client for Python.

Why it is here: It provides bounded timeouts and explicit request construction for the two fixed provider adapters without embedding provider behavior in the UI.

Framework

SQLAlchemy, Alembic, and PostgreSQL

What it is: SQLAlchemy maps Python records, Alembic versions schema changes, and PostgreSQL provides durable relational storage.

Why it is here: The private deployment path can preserve redacted, transactional receipts while the public Vercel release keeps persistence disabled.

Framework

OpenTelemetry, Prometheus, and Structlog

What it is: OpenTelemetry standardizes traces, Prometheus exposes time-series metrics, and Structlog emits contextual JSON logs.

Why it is here: Together they make requests, provider behavior, limits, security events, and failures inspectable without committing to a paid monitoring vendor.

Framework

Postman

What it is: Postman is a visual and command-line API testing platform for collections, environments, and assertions.

Why it is here: The 12-scenario collection proves health, capabilities, registry, evaluation, replay, sensitivity, injection blocking, and the no-key live boundary against production.

Framework

Docker and Vercel

What it is: Docker packages a reproducible service and PostgreSQL runtime. Vercel provides on-demand serverless HTTPS deployment.

Why it is here: Docker proves the durable private path while Vercel keeps the public synthetic gateway available without paid idle compute.

Why this architecture, not just this tool list.

Each component owns a specific responsibility. Alternatives were rejected only where they added complexity or weakened the tested control boundary.

ResponsibilityChoiceWhy it fitsAlternative and constraint
Public APIREST with FastAPI and PydanticClear resources, typed errors, generated OpenAPI, and direct browser and Postman testingGraphQL adds query and authorization surface; gRPC is less useful for a public browser workspace
Policy flowDeterministic Python, not LangGraphProvider allowlists, quotas, key handling, receipts, and security decisions should be direct and reproducibleLangGraph is valuable inside stateful agent workflows but would add orchestration where this gateway needs a fixed policy boundary
Free demonstrationVerified deterministic replayThe system remains inspectable during provider outages and produces no inference billAn owner-funded public model key creates cost and abuse risk; a fixed canned page would fail the input-sensitivity requirement
Live accessVisitor-owned keys for fixed providersThe visitor controls provider quota while the gateway controls model, endpoint, token, timeout, and tool boundariesArbitrary OpenAI-compatible endpoints or model names would expand SSRF, cost, and unsupported capability risk
Durable evidenceHMAC receipts and optional redacted PostgreSQL ledgerReviewers can verify provider and content hashes without persisting prompts, keys, or raw outputFull prompt logging creates unnecessary privacy and credential risk
DeploymentVercel public release plus Docker and PostgreSQL private pathThe public interface scales down between requests while the container path proves durable restartsKubernetes is deferred until traffic, tenancy, or a buyer requirement justifies cluster operations

Data, evaluation, and observability.

The system is credible only when its input limits, release tests, and operating signals are visible together.

Dataset and model boundary

The gateway does not train a model. Its controlled release corpus contains nine synthetic system records, nine evaluation records, and fixed replay scenarios for decision explanation, evidence critique, and structured summarization. Records disclose the live URL, data boundary, mutation boundary, tested scope, release proof, and replay scenario for each system. No client credentials, prompts, provider keys, patient information, private records, or raw model output enter the persistent receipt schema.

Evaluation protocol

The release suite checks registry completeness, evaluation coverage, passing scores, zero external writes, disclosed data and mutation boundaries, replay availability, fixed HTTPS providers and models, disabled shared spend, redacted receipt schema, theme persistence, Postman contracts, PostgreSQL restart behavior, and the coverage floor. Unit, schema, security, provider, replay, registry, API, generation-drift, Postman, Docker, desktop, mobile, input-sensitivity, key-storage, Swagger, and runtime-log checks form the wider acceptance gate.

Observability and error monitoring

Every response receives a trace ID. OpenTelemetry propagates request and provider spans. Prometheus exposes more than 15 signal families across HTTP traffic, latency, provider calls, quotas, injection blocks, live and replay modes, errors, signed receipts, persistence, and registry access. Structlog emits contextual JSON without prompt or key content. Suggested alerts cover readiness, 5xx rate, p95 latency, provider error ratio, quota denials, security blocks, receipt failures, and any unexpected shared-provider activity.

How to interpret this evidence.

Names and sensitive details are withheld. Metrics retain their stated meaning and evidence label. A scope count is not converted into an outcome, and no engagement result is presented as a universal benchmark.

Continue your evaluation.

Compare adjacent systems, inspect evidence, or see how Aixcel delivers the work.

Bring us the constraint. Leave with a clearer next move.

In 25 focused minutes, we will map where work or revenue is getting stuck, test whether AI is the right intervention, and identify the highest leverage first step.

Book a free systems audit