AI Assist Agent for Bicrypto
An assistant that solutions your assist tickets and reside chat from your individual documentation, cites the passage it used, and fingers the dialog to an individual relatively than guessing. It ships switched off and in copilot mode — it drafts, your staff presses Ship — and is promoted one rung at a time, on proof from your individual tickets.
Please learn first: that is an add-on
AI Assist Agent is an extension for Bicrypto, a separate product bought individually on CodeCanyon. It doesn’t run by itself. It has no standalone installer, no interface of its personal exterior the Bicrypto admin panel, and no database of its personal. A working, licensed Bicrypto 6.7.2 or newer set up is a tough prerequisite. If you don’t already run Bicrypto, purchase and set up that first — with out it there may be nothing on this package deal to run.
Please learn: AI utilization prices cash, and it isn’t included on this worth
The worth of this merchandise buys the software program. It doesn’t purchase AI capability. Each reply the assistant writes is a paid API name to whichever AI supplier you join it to, billed to you by that supplier at their charges, and that invoice grows with use for so long as the assistant is switched on. The identical applies to every other exterior service you level it at. There is no such thing as a configuration through which answering a buyer is free.
You select the supplier, and there are 3 ways to attach one:
- The managed connection — metered, pay per reply, nothing to subscribe to
- Your personal vendor key — an Anthropic API key, billed to your individual account with that vendor
- Any OpenAI-compatible endpoint — a self-hosted mannequin, or any third-party router or service that speaks the chat-completions form
On the shipped defaults, one answered dialog flip has measured between $0.02 and $0.30 relying on the supplier, the mannequin and the way lengthy the dialog runs. As a result of that may be a vary and never a quantity, the add-on makes you set a ceiling and enforces it: $5 a day and $100 a month by default, each editable. When a ceiling is reached the assistant stops answering and fingers over to an individual as a substitute. It doesn’t degrade quietly and it can’t overspend the restrict you set. The price of each single reply is recorded, so the spend display screen reveals you the place the cash went relatively than a complete.
Two issues cut back the invoice over time and neither prices something to change on. The nightly harvest turns replies your brokers wrote by hand into draft articles, so questions you reply twice develop into questions that reply themselves. And a query the retrieval layer can’t floor is refused earlier than any mannequin name is made — a query the assistant can’t reply can be a query you aren’t billed for.
What it does
The assistant reads your assist conversations and solutions them out of your information base and the product documentation. Each reply carries the passage it got here from, so a buyer can test it and your staff can audit it afterwards. The mannequin is rarely requested what it is aware of about your platform — it’s handed passages out of your documentation and informed to reply from these.
- Assist tickets — drafts or sends a grounded reply when a buyer replies to their very own ticket
- Dwell chat — solutions within the chat widget, with a reside agent one click on away
- Deflection — provides a solution whereas the client remains to be typing their topic line, so the ticket is rarely filed
- Escalation and handover — when it stops, the human who picks it up receives a short: what the client desires, what was established, and what’s blocking it
- Actions — it may supply a buyer a subsequent step, but it surely by no means acts. It writes a proposal; the client’s personal click on is the one factor that runs something, below their very own session and each test that guards the remainder of the platform.
- Your personal assistant — an admin-side assistant that solutions operators from the operator documentation and might stroll them to the display screen that holds the reply
What it refuses to do
A lot of the engineering on this add-on is within the solutions it declines to present. An assistant that solutions all the pieces is an assistant that invents your refund coverage.
- It is not going to reply beneath a confidence ground. If retrieval can’t discover a adequate supply it fingers over to an individual and data the query as a niche so that you can shut.
- It is not going to state your individual numbers from anyone else’s documentation. Charges, limits, assessment occasions, supported nations and refund coverage can solely be answered from articles you wrote. That gate applies in each language, not solely English.
- It is not going to identify the seller. Your set up is white-labelled and the assistant’s solutions are a part of your model. It writes a web page’s identify and its in-platform path, by no means an exterior hyperlink.
- It is not going to act on an account except you let it. Account instruments are read-only by default, and the actions it might take are an allowlist you fill in your self — empty at set up.
Promoted one rung at a time
It ships off. Nothing occurs since you put in it.
- Copilot — the assistant drafts, a human reads it and presses Ship. That is the shipped default.
- Auto tickets — it solutions tickets by itself; reside chat nonetheless goes to an individual.
- Auto all the pieces — it solutions tickets and reside chat unsupervised.
The console is not going to allow you to skip forward casually: promotion is measured in opposition to how a lot your brokers truly modified its drafts, by yourself tickets.
The console
9 admin screens, every with its personal permission so you’ll be able to hand out precisely as a lot as a assist lead wants:
- Overview — spend immediately and this month, what it did, how a lot was dealt with with no particular person
- Dwell Inbox — conversations the assistant is dealing with proper now, with take-over, a case temporary, the proof it used and a urged reply
- Supplier — which AI service solutions, whether or not it’s related, and what it fees
- Brokers — personas: identify, avatar, disclosure line, mannequin, effort and availability
- Sources — what it’s allowed to reply from, and the index constructed out of it
- Gaps — questions your documentation doesn’t reply but, clustered, with a one-click approach to reply them
- Actions — the allowlist of issues it might supply to do, and the multi-step processes it might stroll a buyer by means of
- Settings — autonomy, budgets, retrieval, channels, workplace hours, knowledge retention
- Handbook — the operator-side assistant and the procedures it solutions from
Technical necessities
Every thing besides the final two strains is what Bicrypto core already requires. The add-on itself introduces no new npm dependency — the AI supplier adapters are plain fetch calls relatively than vendor SDKs — so putting in it doesn’t change the dependency tree of your set up.
Platform
- Bicrypto core 6.7.2 or newer, put in, licensed and working. No different add-on is required.
- Linux. Ubuntu 24.04 LTS or newer, or one other distribution transport glibc 2.38+ (Debian 13+, RHEL / Rocky / Alma 10+). Ubuntu 22.04 is not going to run the platform. x86-64 or ARM64, glibc — not Alpine or musl.
- Not shared PHP internet hosting. A working set up is three long-lived Node.js processes behind a reverse proxy.
Runtime
- Node.js 22, 24 or 26. No different main model boots — the platform’s HTTP server is a prebuilt native binary and ships these three ABIs solely.
- pnpm — the platform pins
[email protected]. npm and yarn can’t resolve the workspace. - 4 GB RAM minimal, 8 GB to construct the frontend reliably. 2+ CPU cores. Shell entry, and the power to restart the backend.
Database and providers
- MySQL 8.0+ or MariaDB 10.6+, reachable, with the
mysqlconsumer obtainable on the appliance server. The add-on provides 17 tables, all prefixedai_support_, created by the platform’s personal replace command. No present schema is modified. - Redis, reachable and answering
PING— a tough dependency of Bicrypto, not a cache. - No ScyllaDB, no search server, no message dealer and no vector database are required.
API dependencies
- Outbound HTTPS out of your server to at least one AI supplier, which you select and configure: the managed connection, the Anthropic API, or any OpenAI-compatible endpoint together with a self-hosted one. That is the one exterior service the add-on calls, and its utilization is billed to you by that supplier — see the associated fee part above.
- An AI supplier account and credential for whichever of these you choose. Credentials are set within the server’s atmosphere file and by no means on a display screen: the platform’s public settings endpoint would in any other case expose them.
- Optionally, outbound HTTPS to the documentation host, used when the information index is rebuilt. This may be disabled or pointed at your individual mirror.
What’s within the obtain
- Full supply code. The backend as TypeScript (119 information) and the 9 admin screens as TypeScript and React (42 information). No compiled-only code and no obfuscation.
- Documentation — 33 pages of offline HTML protecting set up, each console display screen, each setting, the API reference, prices, permissions, scheduled jobs, knowledge retention and troubleshooting. Open
documentation/index.htmlin any browser. - A commented
.env.instanceitemizing each atmosphere variable the add-on reads, with what each is for. - A mission manifest, a changelog, a licence file, and a small script that compiles the shipped supply right into a manufacturing set up.
Assist
- Documentation: mashdiv.com/docs/ai-support-agent
- Assist: mashdiv.com/support

