Skip to content
Outcomes · Case study

A governedknowledge agent.

Consultants searched years of engagement documents by memory and by asking around. We built an agent on Databricks that answers with the sources: documents ingested as they are saved, chunked and embedded into Vector Search, retrieved with the reader’s document permissions checked before passages reach the model, and served behind the AI Gateway with every request logged and every release evaluated.

01 / The situation

Before and after

Before

Knowledge in people’s heads

Proposals, deliverables and lessons learned sat in document libraries by client and year. Finding the last comparable engagement meant asking a partner. Nothing could be opened to a model without opening everything to everyone.

After

An agent that cites and respects permissions

Documents indexed in Vector Search inside Unity Catalog, with a permission-aware retriever controlling which passages reach the model; answers from a foundation model through Model Serving with the passages cited; every request through the AI Gateway with logging, rate limits and guardrails; every release gated by evaluation.

02 / Architecture

The platform

Index the corpus. Authorize every retrieval.

Document indexing and user requests meet at an explicit permission-aware retrieval boundary before passages reach the answer.

Data flowControlReturn pathSelect a stage to inspect
Full architecture
Document indexing and user requests meet at an explicit permission-aware retrieval boundary before passages reach the answer.
Decision gate

Permission-aware retrieval

06 / 09

The retrieval boundary enforces which engagement content the reader may access. Table row filters are not assumed to propagate into the shared search index.

  • Reader authorization
  • Unity Catalog
  • Vector Search
Data in
Vector Search / Agent endpoint
Data out
Grounded generation

A shared Vector Search index does not automatically inherit Unity Catalog table row filters. Retrieval must enforce the reader’s authorization explicitly.

03 / The delivery

Inside the delivery

Ingestion

Auto Loader lands new documents as they are saved. A Lakeflow pipeline parses, chunks and embeds them into Delta tables, and a Vector Search index with Delta Sync follows those tables, so the index is never rebuilt by hand.

  • Auto Loader
  • Chunking and embedding
  • Delta Sync index

Retrieval under permissions

The retriever checks the reader’s document permissions before passages reach the model. The shared index requires explicit permission filtering; row filters on the underlying chunk tables alone do not secure vector query results.

  • Vector Search
  • Permission-aware retrieval
  • One index

The agent

Built with the Mosaic AI Agent Framework: retrieval, a model from the Foundation Model APIs, and tools that read engagement metadata. Deployed to Model Serving with MLflow tracing on every request, so a bad answer can be read back step by step.

  • Agent Framework
  • Foundation Model APIs
  • Model Serving

Evaluation as a release gate

MLflow evaluation runs a curated question set with LLM judges and expert-reviewed answers before each release; a version that scores below the current one does not ship. Production traces feed the next question set.

  • MLflow evaluation
  • LLM judges
  • Release gate

Gateway and interface

The AI Gateway fronts the endpoint with rate limits, payload logging and guardrails. Consultants use the agent through a Databricks App that shows the answer and the cited passages side by side.

  • AI Gateway
  • Guardrails
  • Databricks App
04 / The outcome

What changed

One index, everyone’s own permissions.

Permission-aware retrieval limits the passages available to the agent to documents the consultant is allowed to read.

Every answer shows its sources.

Passages are cited and one click away; an answer without a source is not shown.

Releases are gated by evaluation.

A version that scores lower than the current one on the question set does not ship.

Every request is logged.

Gateway logs and traces show what was asked, what was retrieved and what it cost, per team.

New documents are searchable the same day.

The index follows the Delta tables; nothing is re-indexed by hand.

TechnologyDatabricksMosaic AI Vector SearchAgent FrameworkModel ServingAI GatewayMLflowUnity CatalogDatabricks Apps