Skip to content

Case study

An AI assistant grounded in the firm's own policy wordings

Brokers were searching 30,000 PDFs or asking whoever was free. We built an assistant that answers only from the brokerage's own library, shows the passage and version it used, and says so plainly when the answer is not there.

Named only with client approval Figures marked are illustrative Reply within one business day

AI

Copilot · fine-tuned on your data

Live
Which invoices are overdue by more than 30 days?
14 invoices totalling 42,300 are overdue. Three accounts carry 68% of it — I’ve drafted reminders for review.

0.94

F1 score

86ms

Inference

12k/d

Requests

The engagement, in short

OlDevs built an internal assistant for a national commercial insurance brokerage that answers policy-wording questions using only the firm's own library of wordings, endorsements and carrier bulletins.Every answer shows the exact passage and document version it drew from, and the assistant declines to answer when it cannot find support in the source material. It runs inside the brokerage's own cloud tenancy, so no client or carrier data leaves their environment, and an audit log records every question, answer and citation. 78% of wording questions are now resolved without escalating to a senior broker, and 100% of answers are traceable to a document version.

Key facts

01Client
A national commercial insurance brokerage with around 450 staff across six offices
02Industry
Insurance and financial services
03Services
AI development, generative AI and LLMs, full-stack development
04Duration
14 weeks
05Platforms
Broker web app, compliance review screens and ingestion pipeline in the client's cloud tenancy
06Outcome
78% of wording questions resolved without escalating to a senior broker

The challenge

Thirty thousand PDFs and a senior broker's memory

Brokers answered policy-wording questions by searching a shared drive of 30,000 PDF wordings, endorsements and carrier bulletins, or by asking whichever senior colleague happened to be free. New hires took months to become confident in that material. The compliance team, meanwhile, had no way to know which document version a broker had relied on when advising a client.

01

Answers depended on who was free

The fastest route to a wording answer was asking whichever senior broker happened to be available. That put a hard ceiling on how many questions could be answered in a day, concentrated knowledge in a few people, and made the quality of an answer depend on who picked up.

Knowledge bottleneck · Escalations

02

A shared drive nobody could search

Thirty thousand PDF wordings, endorsements and bulletins sat on a shared drive. Searching it could not reliably tell a superseded wording from the edition in force, so a broker either already knew where to look or asked someone who did.

Unsearchable PDFs · Version confusion

03

No record of what advice rested on

When compliance reviewed a file, there was no way to establish which version of a wording the broker had actually read. The reasoning lived in an email thread or in somebody's memory, which is a difficult position for a regulated firm to defend.

Audit gap · Compliance risk

04

Ramp-up measured in months

New brokers took months to become confident in the material, and much of that time was spent learning where documents lived and which colleague to ask. Onboarding cost senior time twice: once in teaching, and again in answering the questions teaching did not cover.

Onboarding · Senior time

What we built

Retrieval first, generation second, citation always

We built an internal assistant on a large language model that answers only from the brokerage's own document library and shows the exact passage and version it drew from. The retrieval layer indexes wordings, endorsements and bulletins as they land, keeps carrier-specific permissions intact, and declines to answer when it cannot find support in the source material. It runs inside the brokerage's own cloud tenancy, so no client or carrier data leaves their environment, and every question, answer and citation is written to an audit log.

01

Ingestion and indexing pipeline

New wordings, endorsements and bulletins are picked up as they land, split by clause rather than by page, and indexed with the carrier and the document version so retrieval can tell one edition from another.

Ingestion · Versioning

02

Grounded answers with citations

The assistant retrieves candidate passages first and generates only from what it found. Each answer shows the exact passage it drew from, so a broker verifies the wording itself rather than trusting a summary of it.

Retrieval augmented generation · Citations

03

A refusal when support is missing

When retrieval returns nothing that supports an answer, the assistant declines rather than filling the gap. That behaviour was specified up front, tested against questions the library genuinely cannot answer, and monitored after launch.

Guardrails · Evaluation

04

Compliance review screens and audit log

Compliance sees every question asked, the answer given, the passage cited and the document version it came from. Reviews now start from a record of what was read instead of from reconstruction.

Audit log · Compliance

Process

How the engagement ran.

  1. Question inventory before any model work

    We collected the wording questions brokers actually ask, including ones that should not have a confident answer, and used them as the set the assistant would be measured against.

  2. Retrieval built and measured on its own

    Retrieval quality was proven before generation was added. If the right clause is not in the retrieved set, no amount of prompting rescues the answer, so that is what we measured first.

  3. Deployed inside the client's tenancy

    The system was built to run in the brokerage's own cloud environment, with private networking and the carrier-specific permissions carried through from the document library so nothing leaves the firm's boundary.

  4. Weekly review with senior brokers

    Senior brokers graded answers each week, marking not only correctness but whether the citation supported the claim and whether a refusal had been the right call.

  5. Launch with refusal and citation monitoring

    The assistant went live with usage, citation and refusal rates monitored, so thresholds were tuned against the questions brokers were genuinely asking rather than against test traffic alone.

Stack

What it was built with.

Retrieval and indexing

Clause-level chunkingHybrid keyword and meaning-based searchCarrier and document version metadataIndexing as new documents landRetrieval quality measurement

Models and generation

Large language model hosted in the client's cloud tenancyRetrieval augmented generationStructured prompt templatesRefusal thresholdsAnswer and citation evaluation

Application

Broker web applicationCompliance review screensIngestion pipelineDocumented internal APIsSource document opened at the cited passage

Security and governance

Private networking inside the client's tenancyRole-based access controlCarrier-level document permissionsAppend-only audit logEncryption in transit and at rest

Delivery and operations

Automated build and release pipelineMonitoring of usage and refusal ratesCentralised loggingDocumented handover and runbooks

78%

Of wording questions resolved without escalating to a senior broker

11 min → 40 s

Median time to a cited answer

100%

Of answers traceable to a document version

Outcomes

What changed for the client.

01

Senior brokers get their day back

78% of wording questions are resolved without escalating to a senior broker. The people who were the firm's search engine are back on client work, and the questions that do reach them are the ones that genuinely need judgement.

02

Answers arrive with a source attached

Median time to a cited answer moved from 11 min to 40 s. A broker on a call can check a clause while the client is still on the line, and check the wording itself rather than a paraphrase of it.

03

Compliance can prove what advice rested on

100% of answers are traceable to a document version. Every question, answer and citation is logged, so a file review starts from a record of what was read rather than from asking people to remember.

04

New brokers become confident sooner

Newer staff can look something up without deciding whether the question is worth interrupting a colleague for, which removes the social cost of asking and shortens the stretch where confidence lags competence.

In their words

The client on the result.

We were nervous about an AI giving confident wrong answers. What we got is a tool that says it cannot find something when it should, and shows its work when it can.
AN

Chief Compliance Officer, national insurance brokerage

Insurance & financial services

FAQ

Questions about work like this.

It generates only from passages retrieved out of the brokerage's own library, and it declines when nothing in the source material supports an answer. Refusal was a specified behaviour, not an afterthought: we tested it against questions the library genuinely cannot answer, reviewed the results with senior brokers each week, then monitored refusal rates after launch.

No. The assistant runs inside the brokerage's own cloud tenancy, with private networking and carrier-specific permissions carried through from the document library. Documents, questions and answers stay in the client's environment, and the audit log lives there too.

Documents are indexed with the carrier and the document version, and split by clause rather than by page, so retrieval can tell an edition in force from one that has been replaced. Every answer names the version it drew from, which is what makes the citation useful in a review.

The ingestion pipeline picks up new wordings, endorsements and bulletins as they land and indexes them with their carrier and version, so the assistant answers from current material without anyone running a manual import. Permissions on the source document are preserved.

Fourteen weeks, covering the ingestion pipeline, the broker-facing web app and the compliance review screens, with a working demo every week. Request a quote and we will scope a comparable build for your own document library.

Still have a question? Ask us when you request a quote

Let’s connect

Have a problem like this one?

Tell us what is not working. We’ll reply within one business day with how we would approach it and a tailored quote.

We’ll only use your details to prepare your quote. No lists, no spam.

Call us Request a quote