From 1bde4c88872d1ca83c84ac9ae706b4cee04a562a Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Baki=20Burak=20=C3=96=C4=9F=C3=BCn?= <63836730+bakiburakogun@users.noreply.github.com> Date: Sat, 29 Aug 2026 05:58:38 +0300 Subject: [PATCH] docs(ai/assistant): document the assistant data folder name MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit The assistant creates a folder in each user's files for the content it generates. Its name is now configurable server-wide and per user, but neither the key nor the behaviour around existing folders was written down anywhere. Documents both settings next to the other assistant occ options, and the two things that surprise people: changing the name leaves existing folders alone, and a user who already has a folder under the built-in name keeps it rather than getting a second one. Adds the user facing side to the user manual as well: where the assistant saves what it generates, that the name can be changed in the personal settings, and that changing it leaves the existing folder alone. The skills path is stated relative to that folder rather than hardcoded, since the skills folder is resolved inside it. Signed-off-by: Baki Burak Öğün <63836730+bakiburakogun@users.noreply.github.com> --- admin_manual/ai/app_assistant.rst | 27 +++++++++++++++++++++++++++ user_manual/ai_assistant.rst | 23 ++++++++++++++++++++--- 2 files changed, 47 insertions(+), 3 deletions(-) diff --git a/admin_manual/ai/app_assistant.rst b/admin_manual/ai/app_assistant.rst index 5f66636e7f0..6ecf74c8a30 100644 --- a/admin_manual/ai/app_assistant.rst +++ b/admin_manual/ai/app_assistant.rst @@ -190,6 +190,33 @@ To enable/disable the text-to-image smart picker for all the users. To enable/disable the speech-to-text smart picker for all the users. +5. Data folder + +.. code-block:: + + occ config:app:set assistant default_data_folder --value="Assistant" --type=string + +The assistant stores the content it generates, such as generated images and speech-to-text +output, in a folder in the files of each user. This sets the name that folder is given when +it is created. It defaults to ``Assistant``, and is also editable in the Assistant admin +settings. + +Users can choose their own name in their personal Assistant settings, which is stored per +user and takes precedence over the server-wide default: + +.. code-block:: + + occ user:setting $USER_ID assistant data_folder "Assistant" + +Two things to keep in mind: + +* Changing either value does not rename or move a folder that already exists. It only + affects the name used the next time a folder has to be created, so existing generated + content stays where it is. +* A user who already has a folder under the built-in name ``Assistant``, from before a + default was set, keeps using it. This avoids starting a second folder for them and + leaving their earlier output behind. + Task processing ~~~~~~~~~~~~~~~ diff --git a/user_manual/ai_assistant.rst b/user_manual/ai_assistant.rst index 908bd8c9035..2a4ef88f163 100644 --- a/user_manual/ai_assistant.rst +++ b/user_manual/ai_assistant.rst @@ -20,8 +20,23 @@ Personal settings ----------------- The assistant personal settings are in **Personal settings** under the **Artificial intelligence** -section. You can disable the assistant top menu entry there, and enable or disable the -AI-related smart pickers. +section. You can disable the assistant top menu entry there, enable or disable the +AI-related smart pickers, and change the name of the folder the assistant saves its output to. + +Where generated content is saved +-------------------------------- + +Content the assistant generates for you, such as generated images and speech-to-text output, is +saved to a folder in your Files. It is called ``Assistant`` unless your administrator has chosen +a different name for the instance. + +You can pick your own name for it under **Data folder** in the assistant personal settings. Leave +the field empty to keep the name your administrator has set; the placeholder shows what that is. + +.. note:: + + Changing the name does not rename or move the folder you already have. It applies the next + time a folder has to be created, so anything generated before the change stays where it is. Running a task -------------- @@ -628,7 +643,9 @@ applies it in future conversations without you having to repeat yourself. Where skills are stored ~~~~~~~~~~~~~~~~~~~~~~~ -Your personal skills live in your Nextcloud Files under the folder ``Assistant/Context Agent/Skills/``. +Your personal skills live in your Nextcloud Files under ``Context Agent/Skills/`` inside the +assistant data folder, so with the default folder name that is +``Assistant/Context Agent/Skills/``. Each skill is a subfolder containing a file called ``SKILL.md``. The ``SKILL.md`` file starts with a YAML frontmatter block that defines the skill's name and description, followed by the