AI helper
How to use the AI client helper
What the client-portal AI helper does, how it grounds its answers, what it costs you, and how to configure the per-workspace cap.
Audience: owner · 4 min read · Updated
Each client portal includes an AI helper, branded as "Ask the AI helper" or whatever name you configure. It's a chat interface scoped to that specific client's portal: their files, their approvals, their deadlines, their invoices.
It's not a general-purpose chatbot. It's a contextual assistant that helps clients self-serve answers to "what's pending from me?" or "when is my next deadline?" without emailing your team.
What it does well
The helper is good at:
- "What's pending from me?" Returns the open file requests, pending approvals, and upcoming deadlines for this client.
- "When is my [filing/deliverable/review] due?" Reads the deadline tracker, returns the date and what's needed.
- "What did we agree on last week?" Searches recent approvals and messages, returns the decisions with citations.
- "How do I upload a file?" Explains the portal UI, points to the right section.
- "What does [your firm name] do for me on [recurring task]?" Reads the FAQ block you configured during setup, summarises in plain English.
The helper cites the specific items it pulled from. A typical answer reads:
You still owe us your P60 from the BBC contract (due 15 January, see file request "P60 2025-26") and your dividend voucher from Pinpoint Ltd (due 15 January). Once those arrive we can run the draft return.
Citations are clickable. The client jumps from the helper answer straight into the relevant item.
What it doesn't do
Equally important to know:
- It doesn't give legal, tax, financial, or medical advice. The model is instructed to defer to "your firm" when asked for substantive advice. "Should I take the higher-rate pension contribution?" → "That's a decision your accountant should walk through with you. Open a message with the firm to discuss."
- It doesn't read attached files in detail. It knows files exist (name, category, upload date) but doesn't summarise their contents. For documents inside the portal, the client opens them directly.
- It doesn't act on the client's behalf. It can't approve invoices, sign engagement letters, send messages, or trigger any state change. Read-only by design.
- It doesn't remember conversations across sessions. Each helper session starts fresh. This is a privacy and predictability decision.
What it costs you
The helper is included with your workspace. There is no per-query charge and no separate AI line on your bill. Usage is limited only by the monthly cap below.
The monthly cap
Each workspace has a per-month query cap, enforced across all clients. Defaults:
- Workspaces on a slot pack: 500 queries/month
- Workspaces with an active Agency Pack: 2,000 queries per 30-day pack
You can see the current month's usage at /app/settings/ai-usage. The page shows:
- Total queries this month
- Per-client breakdown
- The cap and the percentage consumed
When the cap is reached:
- Clients see a "AI helper paused for the month, resumes [date]" message
- The chat input is disabled
- Clients can still send a normal message to your team via the portal Messages section
- You get a notification: "AI helper cap reached for [workspace] this month"
If your clients regularly reach the cap before the month ends, write to support@clientnest365.com and tell us how many clients use the helper.
Disabling the helper
You can disable the helper at three levels:
Workspace-wide: Settings → AI usage → toggle off. The helper disappears from every client portal.
Per-client: /app/clients/<client> → AI helper → toggle off. The helper disappears for that one client's portal.
Per-category: Settings → AI usage → Categories. Disable the helper for clients tagged with specific categories (e.g., "litigation" clients see no helper).
Disabling is useful when:
- Your clients are in sensitive workflows (litigation, employment disputes, personal injury) where you don't want any AI in the loop.
- A specific client is uncomfortable with AI tools.
- Your firm's professional regulations or insurance policies require human-only client communication.
Configuration
In Settings → AI helper, you can configure:
- Helper name: defaults to "AI helper." Some firms prefer "Portal helper" or "[Firm name] helper."
- Welcome prompt: the first message the client sees when they open the chat. Default: "Hi, I'm your portal helper. Ask me what's pending, when your next deadline is, or where to find a file."
- Off-limits topics: free text describing what you don't want the helper to discuss. The model is instructed to defer to your team on these.
- Custom FAQ: pairs of (question, answer) the helper uses as canned responses. Useful for firm-specific things ("What does ClientNest365 cost?" → your standard pricing answer).
Questions the helper is built for
The helper answers from what is in the client's own portal, so it handles questions like these:
- "What's pending from me?"
- "When is my next deadline?"
- "How do I upload a file?"
- "What's the status of [matter/engagement]?"
- "Where can I see my invoices?"
- "How do I message my [advisor/lawyer/designer]?"
For anything outside the portal's data, it gives a short answer and points the client to the section or person that can help.
What this looks like in practice
Open the public demo and choose AI helper to ask it about a sample engagement as a client would. The accounting walkthrough covers where its answers stop: filing deadlines and tax positions stay with the accountant.