Compass Agents Blueprint

Get the Compass Support blueprint repository: a production-shaped customer support agent that shows how deep agents, LangGraph, guardrails, Langfuse, RAG, and HITL fit together in one inspectable system.

Compass Support is a concrete implementation of a governed support runtime with a customer chat app, reviewer workspace, control plane, seeded connectors, durable workflow state, and observability surfaces. It is designed for teams that want something more useful than architecture slides: a runnable reference they can inspect, adapt, and learn from.

Open live demo Open Walkthrough

WHAT IS INSIDE THE REPOSITORY

Compass Support is intentionally shaped like a real product. The repo includes the application surfaces, service boundaries, and operational plumbing needed to reason about the system end to end.

Customer-facing support interface and streaming chat flow
Reviewer workspace for approval, takeover, and resume
Governed runtime routing across customer context, approved knowledge, and handoff states
Control-plane API for review tasks, quality operations, and reporting
Observability, eventing, artifact storage, and release-bundle surfaces

WHAT ENGINEERING QUESTIONS IT HELPS ANSWER

The blueprint is built to shorten the jump from prototype to production by making the hard parts concrete and inspectable rather than implied.

How browser requests cross the edge and reach the runtime safely
How customer context and approved knowledge are loaded and separated
How the system chooses between answer, clarification, and escalation
How review tasks become durable workflow state instead of fragile UI-only state
How reviewers resume a paused execution path without losing the thread

INFRASTRUCTURE AND RUNTIME SHAPE

The system spans the services teams usually need once they move beyond a single-agent prototype and start treating the runtime as a real application topology.

Kong, Caddy, Postgres, Redis, and Qdrant
Redpanda, MinIO, Prometheus, Loki, Grafana, and Vault
Explicit runtime contracts, tracing, policy decisions, and workflow steps
Fixture-backed connectors with clear seams for real provider implementations

BEST FIT FOR

This is particularly useful for teams evaluating modern agent-system concerns in a concrete support workflow.

Deep agents and specialist routing
LangGraph checkpointing and workflow orchestration
RAG pipelines and grounded answer contracts
Guardrails, prompt/version management, Langfuse, and human approval loops