DBHAVERY.AIApplied AI / AI Systems Engineering
Index ↗

Field note 01 · Customer support, made human

Support that fixes it, and treats you like a person.1

Everyone knows what bad customer service feels like: the hold music, repeating your story five times, a script that never solves anything. This is a support assistant built to do the opposite. It listens, answers from the company's real help articles, and hands you to a human the moment one is needed, with the whole conversation attached so you never start over. Compassion and competence, tuned to any business.

See how it helps
Sample transcriptNorthwind Outdoors
Self-playing sample · no live model

Note on this page. A static, always-on edition. The transcript and the live assistant answer from a sample company's real help articles by client-side retrieval, with each source footnoted. The full application runs the same retrieval and then a language model, hosted or local, writes the reply. This page swaps that one step for fixed answers so it costs nothing and never goes down.

§ 01 / The problem, both sides

Support is broken for the customer and the business at the same time.

It is the same call from two ends. The customer wants one thing fixed and to feel heard. The business wants to help everyone without going broke or burning out its people. The system in the middle usually lets both down.

What the customer dreads

The runaround.

Hold music and "your call is important to us." Telling the whole story, then telling it again to the next person. A script that never quite answers the question. Being transferred, disconnected, and told to call back. And the worst one: hanging up with the problem still not solved.

What it costs the business

An impossible trade.

Live help is expensive and almost impossible to staff around the clock. Good agents burn out repeating the same fifty answers. Quality swings between a great rep and a tired one. The knowledge to fix things exists, but it is scattered, and routine questions bury the cases that genuinely need a human.

§ 02 / What good feels like

The good experiences all share the same three things.

Think about the last time customer service actually went well. It almost certainly felt like this.

1

Someone listened.

You were treated like a person with a problem, not a case number. They took in the whole thing before answering, and they sounded like they cared that it went wrong.respect, not a script
2

They actually knew the answer.

Clear, correct, specific to your situation. No guessing, no "let me look into that" that quietly goes nowhere.competence
3

It got resolved.

You left with it fixed, or with a real next step and a person who owned it. You did not have to call back tomorrow.resolution

That is the whole bar: compassion, competence, and the problem actually solved. This assistant is built to clear it on the everyday questions, and to know the exact moment a person should take the rest.

§ 03 / How this fixes it

Every old frustration, answered.

Take each thing people dread about contacting support, and here is what this assistant does instead.

"I waited on hold forever."

It answers the second they ask, any hour, with no queue. Speed is the first thing customers rank, and the line is never closed.instant, around the clock

"I had to repeat my whole story."

It holds the thread, and when a person steps in they inherit all of it. Nobody starts over. Repeating yourself is the single biggest reason people come to resent support.full context, always

"The bot just looped me."

If it cannot help, or it catches itself repeating, it stops and gets a person, instead of trapping anyone in a maze of menus.no dead ends

"It felt cold and robotic."

It speaks in plain, warm language, notices when someone is upset, and apologizes like it means it, all in the company's own voice.compassion, on brand

"It just made something up."

It answers only from the company's real help articles and shows the source. No invented refund windows, no confident guesses.grounded, and cited

"I could never reach a human."

A way to reach a person stays in plain sight the entire time, and it offers one on its own the moment things get hard.a door that's never locked
§ 04 / One conversation, start to finish

A real problem, handled with care.

A customer whose gear failed right before a trip. Watch the tone, the grounded answer, and the clean hand to a human the moment the stakes rise.

Example transcriptNorthwind Outdoors
C
My tent poles snapped on day one and I'm stuck out here for four more nights. This is a disaster.
A
Oh no, that is the last thing you need in the middle of a trip. I'm sorry. Let me make this quick. A pole that snaps under normal use is covered by our warranty, and since it failed on you in the field I don't want you stuck filling out a claim form out there. I'm flagging it for a same-day replacement and a person will confirm the shipping details with you in a few minutes.1
C
I just need it before the weekend, honestly.
A
Completely fair. Overnight arrives the next business day if it ships before noon Pacific, and I have marked this one urgent. I'm handing you to a teammate now with everything above, so you won't repeat a word of it. If you would rather call, the team is at 1-800-555-0142.2
Sources1 · warranty.md     2 · shipping-policy.md · escalated to a human, full context

No hold music. No repeating the story. A grounded answer, real warmth, and a person brought in at the right moment with the whole thread in hand.

§ 05 / It talks like a person

Human-level conversation, not a phone tree.

It reads the room

Warmth when it counts.

When someone is frustrated, or something genuinely went wrong, it leads with a real apology and slows down instead of firing back a canned line. Specific, honest empathy, never a hollow "I understand your concern."

Plain language

Clear, not corporate.

Short, direct answers in everyday words, framed around what can be done right now. It sets expectations honestly and tells people exactly what happens next.

Your voice

It sounds like your brand.

The tone is set per company, from a warm outdoor shop to a calm clinic to a precise software team. Same engine underneath, your personality on top.

Honest about itself

It never pretends to be human.

It says it's a virtual assistant up front, and treats handing you to a person as a feature, not a failure. Being straight about what it is earns more trust than faking it.

§ 06 / Works with your people

It hands off to a human, not into a void.

The most common way AI support fails is the handoff itself: the customer gets bounced to a person and has to start the whole story over. That moment of lost context is the biggest single reason people say they hate support bots, so it is the part this is built around.

No restart

The human inherits the whole conversation.

What was asked, which article answered it, what the assistant already tried, and the customer's own words all travel to the agent. The person picks up where the bot left off, and nobody repeats themselves.

Right moment

It escalates before you have to beg.

A frustrated tone, the same question asked twice, or a high-stakes topic trips a handoff on its own. The customer never has to fight a menu to reach a person.

Humans decide

People keep the judgment calls.

The assistant clears the repetitive volume so a person spends their hours on the cases that genuinely need one, arriving with the easy parts already done.

§ 07 / Tuned for any business

Customized for any business, in one file.

Listing 1companies/northwind-outdoors/company.yaml
# the company powering the transcript above
company:
  display_name: "Northwind Outdoors"
  tagline: "Gear for people who'd rather be outside"
branding:
  colors: { primary: "#1f6f54", accent: "#f4a23b" }
  tone: "warm, outdoorsy, practical"
support:
  in_scope:     [orders, shipping, returns, gear care, warranty]
  out_of_scope: [wholesale pricing, payment-card details]
escalation:
  triggers: ["speak to a human", "lost package", "refund over $300"]
  contact:  { phone: "1-800-555-0142", hours: "Mon-Fri 8-6 PT" }
knowledge_base:
  path: "knowledge"   # 6 articles, chunked and embedded
llm:
  tier: "fast"        # a local Ollama model, no external API

Change the business, not the engine.

The profile compiles into the assistant's system prompt and its runtime behavior. Swap this file and the knowledge folder, and the same code speaks for a different company.

Branding
sets the widget's look and the assistant's tone.
Scope
draws the line between an answer and a polite decline.
Escalation
names what a bot should never handle alone.
Knowledge
is the only thing it is allowed to answer from.
Grounded inreturns-policy.mdshipping-policy.mdwarranty.mdaccount-and-orders.mdproduct-faq.mdcontact-and-hours.md
§ 08 / Under the hood

The architecture is the product. The model is a config line.

Retrieval over the company's documents, a model allowed to answer only from what it pulled, and a policy layer that decides when to hand off. That core holds whichever engine powers it, so a business is never locked to one vendor.

Engine, option one

A frontier model, for top quality.

Most support SaaS runs on a hosted model: Claude, GPT, or Gemini, reached by API or kept inside the company's own cloud through Bedrock, Azure, or Vertex. Best answer quality, fastest to launch. A cheap model handles routine questions and only the hard ones escalate to a larger one.

Engine, option two

Fully private, for regulated work.

The same app runs on self-hosted open models such as Llama, Qwen, or Mistral, inside the company's own walls. No conversation leaves the building and there is no per-token bill. It is the right call for healthcare, finance, or anyone who cannot send customer data to a third party.

Claude / GPT / Gemini, or local open modelsRAG + citationsvector DB: Pinecone / Qdrant / pgvector / Chromaembeddings + rerankercompany.yaml profilespolicy + escalationShadow-DOM widgetevals + observability

§ 09 / Try it

Ask it something. Push back. Ask for a human.

Returns, shipping, a warranty claim, where an order is, or tell it you're frustrated and want a person. It resolves what it can from Northwind's documents, shows its sources, and gets a human the moment it should.