Skip to content

Professional services

Need expert help? RAGcon offers:

  • RAGflow Support
  • RAGflow Hosting
  • Moodle Support
Talk to RAGcon →

Helpdesk placement

Component: aiplacement_ragflowhelpdesk · Release: 0.3.1 · Requires: Moodle 5.0–5.2 · Depends on: aiprovider_ragflow

A site-wide help drawer (an AI placement). It adds a "RAGflow Helpdesk" item to the site's primary/more menu that opens a chat page answering from an organisation-wide RAGflow knowledge base (system context, no course scope) — typically your help/FAQ/support content. It owns its own settings and drives the shared chat engine from the AI provider.

Features

  • Site-wide navigation entry → chat page at the system context, shown only when the user is logged in (not a guest), has the use capability, and the placement is enabled and configured.
  • Conversation (session) memory — on by default — so follow-ups keep context and the transcript is restored on return (stored server-side in RAGflow).
  • Long-term memory — optional — carries durable facts about the user (name, role, language, preferences, recurring goals) across conversations via RAGflow's native Memory.
  • Configurable greeting, optional source citations, and answers in the user's Moodle language.
  • Private/incognito mode and a New conversation / Forget memory control in the drawer (from the shared engine).

Configuration

Admin settings — Site administration → Plugins → AI placements → RAGflow Helpdesk

Setting Type Default Meaning
Chat assistant (chatid) select (live) — (required) The RAGflow assistant that answers Helpdesk questions; should be backed by a site-wide knowledge base. The Helpdesk is unavailable until an assistant is chosen.
Greeting message (greeting) textarea "Hello, I am the RAGflow Helpdesk…" First message shown when the drawer opens; empty to disable.
Conversation memory (sessionmemory) checkbox on Remember the conversation across turns and reloads (RAGflow session).
Long-term memory (longterm) checkbox off Carry durable user facts across conversations. Requires conversation memory and a RAGflow memory (below).
RAGflow memory (memoryid) select (live) The RAGflow memory used for long-term memory (create a "semantic" memory in RAGflow). One shared memory serves all users; Moodle separates them per user.
Include sources (includesources) checkbox on Append linked sources to answers.
Serve source files via RAGflow proxy (serveviaproxy) checkbox off Stream source files through the secure Moodle proxy.

Capabilities

Capability Default roles Purpose
aiplacement/ragflowhelpdesk:use Authenticated user (site context) See and use the Helpdesk drawer (guests excluded).

Privacy

The placement stores no personal data in Moodle — the conversation exists in the browser / a RAGflow session. With conversation memory on, the conversation is stored server-side in RAGflow; with long-term memory on, per-user facts are stored in RAGflow's Memory and are cleared with the user's data. See the AI provider privacy details.


Note: This documentation was created with the help of AI. Spotted an error, an omission, or something unclear? Please report it in the ragcon-docs GitHub repository so we can fix it.