Turn it on
- Settings → AI & agents → Features → AI chat: pick the provider and model and turn it on. On Colliedesk Cloud the server's provider answers with Claude Haiku 5.5; on your own server, add a provider first. A server with no provider offers no AI chat.
- Settings → Channels → Add channel → Add help chat: what the chat says first and the questions it offers (Help chat).
Both must be on. Off, the chat pages answer 404, as a help center that is off.
What the AI reads and says
- Your published articles, the ones the help center shows, except those marked Keep away from AI. On a page of another language you show, each article published in that language is read in it (and its sources link that language's pages); the others in their own language. Drafts, articles and translations in the trash, and languages you hide are never read. With no published article the chat says it cannot find an answer and offers Talk to a person.
- It answers in the language of the question, cites the articles it used, and says so when the articles do not answer the question. It never makes up a price, an address or a link: an email address, a phone number or a link that is not in your articles is hidden in its answer.
- Extra instructions of the channel are added to what it is told, but cannot add facts.
- The text a customer types goes to the provider of the AI chat feature, as for any AI feature (AI). AI chat never sees your conversations, contacts or notes.
Limits
On Colliedesk Cloud's own provider, AI chat has a monthly limit of answers and of spend, per plan, and a day may use a tenth of each. It never uses the included AI of your team's features.
| Plan | Answers a month |
|---|---|
| Trial | 50 |
| Solo | 300 |
| Small | 750 |
| Team | 1,500 |
| Team 25 | 3,000 |
| Founding | 600 |
When a limit is reached, customers see the help articles that match their question and Talk to a person, until the next day or month (UTC). On your own provider, or a server without plan limits, an admin can set a monthly spend limit for AI chat on the AI chat tab of Settings → AI & agents; empty is no limit, and the ⓘ beside the limit says what customers see past it. Type the amount, then select Save in the bar at the foot of the page. Settings → AI & agents → AI chat shows the month's answers, spend, chats, hand-offs and how many answers were rated helpful, with a warning at 80% and when answers are paused.
Spend is counted at the server's prices (the setting ai.server.prices, see
environment variables). When the server has no price for the AI chat's model, the tab
says Price unknown instead of a spend, and a monthly spend limit cannot be set until the operator adds one. A server
without an AI provider of its own has no prices at all: on your own key, your provider's dashboard shows the spend.
Chats and transcripts
Settings → AI & agents → AI chat → Chats lists the chats, newest first, with where each started
(the chat page, an article, your site), its state (open, handed off, ended) and whether an answer was
rated not helpful. Open one to read it with the articles each answer cited. Every member of the team
reads them there (the tab shows only the chats to someone who is not an admin), and from a conversation
a hand-off opened (Open chat transcript); only someone with ai_settings:update (an admin) deletes one, for good (the conversation
keeps its own copy).
A chat's texts are kept 90 days after its last question, then erased; its numbers stay a year. They
are in the export (ai-chat-sessions.ndjson).
On the customer's side
A chat is kept in the customer's browser for 30 days with one cookie that only works for your help center; New chat starts over. When the chat is on, the chat page and article pages load a small script of the help center; off, the help center has no script and no cookie.
Was this page helpful?
Updated
This page is rendered from the repository. Spot a mistake? Open an issue or a pull request.