Merge pull request #13427 from nextcloud/context-agent-update

Update context agent page

Author: marcelklehr

admin_manual/ai/app_context_agent.rst

@@ -7,26 +7,27 @@ App: Context Agent (context_agent)
 The *context_agent* app is the app that provides AI agent functionality in Nextcloud and acts as a backend for the :ref:`Nextcloud Assistant app<ai-app-assistant>`. Nextcloud can provide customer support upon request, please talk to your account manager for the possibilities.
 
 When the Context Agent app is installed the AI Chat in Nextcloud Assistant will be able to interact with your Nextcloud apps via virtual integrations that are called "tools". They allow the Assistant to perform actions in your Nextcloud upon sending instructions in a chat message.
+Tool groups are only available if their requirements are met. They can be en- and disabled in the AI admin settings.
 
 Currently implemented tools:
 
 * List the user's calendars
 
   * Example prompt: *"List my calendars"*
 
-* List the user's talk conversations
+* List the user's talk conversations (requires `Talk <https://apps.nextcloud.com/apps/spreed>`_)
 
   * Example prompt: *"List my talk conversations"*
 
-* List messages in a talk conversation
+* List messages in a talk conversation (requires `Talk <https://apps.nextcloud.com/apps/spreed>`_)
 
   * Example prompt: *"List the latest messages in my conversation with Andrew"*
 
-* Send a message to a talk conversation
+* Send a message to a talk conversation (requires `Talk <https://apps.nextcloud.com/apps/spreed>`_)
 
   * Example prompt: *"Can you send a joke to Andrew in talk?"*
 
-* Create a public talk conversation
+* Create a public talk conversation (requires `Talk <https://apps.nextcloud.com/apps/spreed>`_)
 
   * Example prompt: *"Can you create a new public talk conversation titled 'Press conference'?"*
 
@@ -38,21 +39,21 @@ Currently implemented tools:
 
   * Example prompt: *"Where do I live?"*
 
-* Ask a question to context chat
+* Ask a question to context chat (requires :ref:`Context Chat<ai-app-context_chat>`)
 
   * Example prompt: *"What is the company's sick leave process?"*
 
-* Transcribe a media file
+* Transcribe a media file (requires Transcribe audio task type enabled)
 
   * Example prompt: *"Can you transcribe the following file? https://mycloud.com/f/9825679"* (Can be selected via smart picker.)
 
-* Generate documents
+* Generate documents (requires `Nextcloud Office <https://apps.nextcloud.com/apps/richdocuments>`_)
 
   * Example prompt: *"Can you generate me a slide deck for my presentation about cats?"*
   * Example prompt: *"Can you generate me a spreadsheet with some plausible numbers for countries and their population count?"*
   * Example prompt: *"Can you generate me a pdf with an outline about what to see in Berlin?"*
 
-* Generate images
+* Generate images (requires Image generation task type enabled)
 
   * Example prompt: *"Can you generate me an image of a cartoon drawing of a roman soldier typing something on a laptop?"*
 
@@ -76,11 +77,11 @@ Currently implemented tools:
 
   * Example prompt: *"Find a free 1-hour slot for a meeting with me and Marco next week."*
 
-* Create a deck card
+* Create a deck card (requires `Deck <https://apps.nextcloud.com/apps/deck>`_)
 
   * Example prompt: *"Create a deck card for 'Buy Groceries' in my Personal board."*
 
-* Access information in deck boards
+* Access information in deck boards (requires `Deck <https://apps.nextcloud.com/apps/deck>`_)
 
   * Example prompt: *"Which deck cards are currently in the To do list in my Personal board?"*
 
@@ -96,7 +97,7 @@ Currently implemented tools:
 
   * Example prompt: *"Show me search results for quick pasta recipes, please."*
 
-* Send an email via Nextcloud Mail
+* Send an email via Nextcloud Mail (requires `Mail <https://apps.nextcloud.com/apps/mail>`_)
 
   * Example prompt: *"Send a test email from my [email protected] account to [email protected]"*
 
@@ -112,20 +113,19 @@ Currently implemented tools:
 
   * Example prompt: *"Can you show me the folder tree of my files?"*
 
-* Determine public transport routes
+* Determine public transport routes (requires a `HERE <https://www.here.com/>`_ API key configured in the admin settings)
 
   * Example prompt: *"How can I get from Würzburg Hauptbahnhof to Berlin Hauptbahnhof?"*
 
-* List all projects in OpenProject
+* List all projects in OpenProject (requires the `OpenProject integration <https://apps.nextcloud.com/apps/integration_openproject>`_)
 
   * Example prompt: *"List all my projects in OpenProject, please"*
 
-* List all available assignees of a project in OpenProject
+* List all available assignees of a project in OpenProject (requires the `OpenProject integration <https://apps.nextcloud.com/apps/integration_openproject>`_)
 
   * Example prompt: *"List all available assignees for the 'Product launch' project in OpenProject"*
 
-* Create a new work package in a given project in OpenProject
-
+* Create a new work package in a given project in OpenProject (requires the `OpenProject integration <https://apps.nextcloud.com/apps/integration_openproject>`_)
   * Example prompt: *"Create a work package called 'Publish release video' in the 'Product launch' project in OpenProject"*
 
 
@@ -197,4 +197,5 @@ Known Limitations
 -----------------
 * Make sure to test the language model you are using in concert with this app for whether they meet the use-case's quality requirements
 * Most models have difficulties with languages other than English. Some sometimes answer in another language than used by the user. 
-* Customer support is available upon request, however we can't solve false or problematic output, most performance issues, or other problems caused by the underlying model. Support is thus limited only to bugs directly caused by the implementation of the app (connectors, API, front-end, AppAPI)
+* Customer support is available upon request, however we can't solve false or problematic output, most performance issues, or other problems caused by the underlying model. 
+  Support is thus limited only to bugs directly caused by the implementation of the app (connectors, API, front-end, AppAPI). We still try to optimize this as far as possible, so if you encounter any false or problematic output, you can report it `in a dedicated Github issue <https://github.com/nextcloud/context_agent/issues/51>`_ to help us improve this app.