Skip to content

docs(ai/assistant): document the assistant data folder name - #15527

Open
bakiburakogun wants to merge 1 commit into
nextcloud:masterfrom
bakiburakogun:docs/assistant-data-folder
Open

docs(ai/assistant): document the assistant data folder name#15527
bakiburakogun wants to merge 1 commit into
nextcloud:masterfrom
bakiburakogun:docs/assistant-data-folder

Conversation

@bakiburakogun

Copy link
Copy Markdown

Documents the assistant data folder name, added in nextcloud/assistant#632.

The assistant creates a folder in each user's files for the content it generates — generated images, speech-to-text output. Its name used to be a constant; it is now an app config value with a per-user override, and both are editable in the admin and personal settings. Neither the keys nor the behaviour around existing folders was written down anywhere.

Added as item 5 of the existing "Assistant configuration" list, covering:

  • occ config:app:set assistant default_data_folder for the server-wide default,
  • occ user:setting $USER_ID assistant data_folder for the per-user value,
  • that changing either does not rename or move folders that already exist,
  • that a user who already has a folder under the built-in Assistant name keeps it, instead of getting a second folder and leaving their earlier output behind.

The last two are the parts that surprise people, so they seemed worth stating rather than leaving to be discovered.

Note that the app change is merged but not in a release yet, so this targets master only — happy to follow up with backports once it ships.

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.

Signed-off-by: Baki Burak Öğün <63836730+bakiburakogun@users.noreply.github.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant