Pidtrymka

Pidtrymka (Ukrainian підтримка — “support”) — a drop-in AI customer-support agent that answers strictly from your knowledge base, cites the source file, and escalates anything it can’t back up.

No hallucinated policies. Drop your docs in kb/*.md, run the server, embed the widget. The agent will only say what your docs say — and clearly hand off to a human when the docs don’t cover the question.

Why this design

Most “AI support” bots happily invent refund policies. Pidtrymka is the opposite: the knowledge base is the only allowed source, every answer ends with Source: <file>, and out-of-scope questions get a fixed escalation reply your frontend can detect (escalated: true).

Features

• KB-grounded answers from kb/*.md — each file is a citable source.
• Hard escalation path with a machine-detectable flag.
• Prompt caching on the (large) knowledge base — every question after the first is cheaper and faster.
• Clean embeddable chat widget (public/index.html) — demo ships with sample shipping/returns docs.

Run

npm install
export ANTHROPIC_API_KEY=sk-ant-...
npm start
# open http://localhost:8181 — ask about shipping or returns

Replace the files in kb/ with your real docs and restart. Env: PORT, KB_DIR, PIDTRYMKA_MODEL (default claude-sonnet-4-6).

Stack

Node.js · Express · @anthropic-ai/sdk · markdown knowledge base · prompt caching.

License

MIT © Oleksandr Bilov (@Dominant-dev)