AI assistant

目录

The Nextcloud AI assistant gives you access to AI-powered tools directly from the web interface. You can run tasks such as text summarization, image generation, and speech transcription, have back-and-forth conversations with a connected language model, and insert AI-generated content into documents and messages using smart pickers.

提示

The AI assistant requires at least one AI backend app to be installed and configured by your administrator. See the AI assistant administration documentation for details.

Personal settings

The assistant personal settings are in Personal settings under the Artificial intelligence 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.

提示

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

To open the assistant, click the assistant icon in the top-right navigation bar.

Assistant icon in the top-right navigation bar.

Figure 1: The assistant icon in the top-right navigation bar.

Choose a task type at the top of the assistant panel, fill in the input form, and click the submit button at the bottom right.

The assistant task form.

Figure 2: The assistant task form.

Your task will run immediately if possible, or be scheduled for later execution.

Waiting for task results.

Figure 3: Waiting for task results.

Notifications

If a task was scheduled, you can request to receive a notification when it finishes. Click the View results button in the notification to display the task output.

Task completion notification.

Figure 4: Task completion notification.

Task history

The left panel of the assistant shows a task history list filtered to the currently selected task type. You can relaunch, delete, or cancel previous tasks from this list.

Task history in the left panel.

Figure 5: Task history in the left panel.

Chat with AI

The Chat with AI tab in the assistant lets you have a back-and-forth conversation with the connected AI. Type a message into the text field at the bottom and press Enter to send. Click New conversation to start a separate conversation thread.

Chat with AI interface.

Figure 6: Chat with AI interface.

Each conversation has its own context. Toggle Remember this on a conversation to add it to the AI's long-term memory so that its context is available in any future conversation. Toggle it off again to remove the conversation from memory.

In the AI assistant section of your Personal settings, you can review all your remembered conversations.

Remembered conversations in personal settings.

Figure 7: Remembered conversations listed in personal settings.

Smart pickers

The assistant app provides three smart pickers accessible in Talk, Text editor, and any other place where rich text editing is available. Type / followed by ai to see the filtered provider list.

In Talk:

AI smart picker in Talk.

Figure 8: AI smart picker in Talk.

In Text editor:

AI smart picker in the Text editor.

Figure 9: AI smart picker in the Text editor.

Any result generated through the smart picker can be inserted directly into the current context.

Context Agent

When the administrator installs the Context Agent app, the AI assistant automatically gains the ability to interact with your Nextcloud apps. No additional setup is needed on your end, the agent tools become available in the same Chat with AI interface described above.

With Context Agent enabled, you can ask the assistant to perform actions across Nextcloud by typing natural-language instructions in the chat. The assistant uses "tools" behind the scenes to carry out your requests.

提示

Available tools depend on which apps are installed on your Nextcloud instance and which tool groups your administrator has enabled. Some examples below require specific apps such as Deck, Talk, or Mail.

Example prompts

Below are examples of what you can ask the assistant to do. Combine multiple instructions in a single message and the agent will chain the necessary tools automatically.

Artificial intelligence tools

Calendar tools

Tasks tools

Circles/teams tools

Contacts tools

Cookbook tools

Deck tools (require Deck)

Files tools

Forms tools

Bookmarks tools

Search tools

All search providers in Nextcloud are also automatically available as tools.

Share tools

  • Example prompt: "Does martin have write access to the Design/Ideas.md file I shared with him?"

Talk tools (require Talk)

Mail tools (require Mail)

Miscellaneous tools

Combining tools

These tools can also be combined by the agent to fulfil tasks like the following:

Skills

Skills let you teach the Context Agent reusable instructions that it can follow whenever they are relevant. A skill is a small markdown file that describes a procedure, a set of rules, or domain-specific knowledge. Once a skill is saved, the agent automatically picks it up and applies it in future conversations without you having to repeat yourself.

提示

Skills require the Context Agent app version 2.8.0 or later and the Assistant app version 3.5.0 or later.
You can ask your administrator if these requirements are met or the agent directly if it has the ability to use skills.

Where skills are stored

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 skill content in Markdown:

---
name: weekly-report-format
description: Formatting rules for my weekly status reports
---

When I ask you to write a weekly report, use the following structure:
1. Summary (2-3 sentences)
2. Completed tasks (bullet list)
3. Blockers
4. Plan for next week

For example, a skill named "weekly-report-format" would be stored at Assistant/Context Agent/Skills/weekly-report-format/SKILL.md.

A typical skills folder structure looks like this:

Assistant/
└── Context Agent/
    └── Skills/
        ├── email-tone/
        │   └── SKILL.md
        ├── weekly-report-format/
        │   └── SKILL.md
        └── meeting-notes/
            └── SKILL.md

Creating a skill

You can create a skill in two ways:

Listing and using skills

To see which skills are available, ask the agent:

You do not need to explicitly invoke a skill. The agent reads all available skill descriptions and applies the relevant ones based on the context of your conversation.

Admin-provided skills

Your administrator can configure a global skills folder that provides skills to all users on the instance. These global skills appear alongside your personal skills.

If a global skill has the same name as one of your personal skills, your personal version takes precedence.

Using Nextcloud as an MCP server

The Context Agent app exposes your Nextcloud as a Model Context Protocol (MCP) server. This means you can connect your Nextcloud instance to external AI tools and agents such as Pi Agent, Claude Code, Hermes, OpenCode or any other MCP-compatible client and let them use the same tools that are available in the Assistant chat.

The MCP server endpoint is:

https://your-nextcloud-domain.com/index.php/apps/app_api/proxy/context_agent/mcp/

Authentication is done with an app password. You can create one in "Personal settings -> Security -> Devices & sessions".

Connecting MCP clients

Any MCP-compatible client that supports the streamable_http transport can connect to the Nextcloud MCP server. Point the client to the endpoint URL shown above and pass the app password in the Authorization: Bearer <app-password> header.

Once connected, the external client can use all the same Context Agent tools, managing files, calendars, tasks, contacts, Talk conversations, and more directly from outside Nextcloud.

版本号 #2
由 cocobook-sync 创建于 2026-10-28 16:21:40 UTC
由 cocobook-sync 更新于 2026-10-29 01:09:06 UTC