Context Agent is not usable

The Basics

  • Nextcloud Server version (e.g., 29.x.x):
    • 31
  • Operating system and version (e.g., Ubuntu 24.04):
    • Ubuntu 24.04
  • Web server and version (e.g, Apache 2.4.25):
    • Apache2
  • PHP version (e.g, 8.3):
    • 8.3
  • Is this the first time you’ve seen this error? (Yes / No):
    • Yes
  • When did this problem seem to first start?
    • after install
  • Installation method (e.g. AlO, NCP, Bare Metal/Archive, etc.)
    • local
  • Are you using CloudfIare, mod_security, or similar? (Yes / No)
    • no

Summary of the issue you are facing:

I have the Context Agent installed, the Docker container is running.
In the settings, the Context Agent is set:

However, I can’t access it anywhere. Where can I query the Context Agent by terms or tasks? In AI Assistant - Context Chat, I can only select “Files” as a provider.

Steps to replicate it (hint: details matter!):

  1. Install AI components as in NC Admin Docs given
  2. Install context_agent
  3. Nextcloud Assistant didn’t offer a Context Agent to search for Mail, Task, or Appointments.

Log entries

No errors in any log I checked (nextcloud.log, journal)

Configuration

Nextcloud

        "instanceid": "***REMOVED SENSITIVE VALUE***",
        "passwordsalt": "***REMOVED SENSITIVE VALUE***",
        "secret": "***REMOVED SENSITIVE VALUE***",
        "trusted_domains": [
            "XXXXX",
            "127.0.0.1",
            "XXXXX",
            "localhost"
        ],
        "allow_local_remote_servers": true,
        "datadirectory": "***REMOVED SENSITIVE VALUE***",
        "overwritewebroot": "\/XXXXX",
        "overwrite.cli.url": "https:\/\/XXXXXX\/XXXXX",
        "dbtype": "pgsql",
        "version": "31.0.0.18",
        "dbname": "***REMOVED SENSITIVE VALUE***",
        "dbhost": "***REMOVED SENSITIVE VALUE***",
        "dbport": "",
        "dbtableprefix": "oc_",
        "dbuser": "***REMOVED SENSITIVE VALUE***",
        "dbpassword": "***REMOVED SENSITIVE VALUE***",
        "installed": true,
        "app.mail.verify-tls-peer": false,
        "mail_from_address": "***REMOVED SENSITIVE VALUE***",
        "mail_smtpmode": "sendmail",
        "mail_smtpauthtype": "LOGIN",
        "mail_domain": "***REMOVED SENSITIVE VALUE***",
        "maintenance": false,
        "filelocking.enabled": true,
        "memcache.locking": "\\OC\\Memcache\\Redis",
        "memcache.local": "\\OC\\Memcache\\APCu",
        "memcache.distributed": "\\OC\\Memcache\\Redis",
        "redis": {
            "host": "***REMOVED SENSITIVE VALUE***",
            "port": 0,
            "dbindex": 0,
            "timeout": 1.5
        },
        "theme": "",
        "loglevel": 2,
        "twofactor_enforced": "false",
        "twofactor_enforced_groups": [],
        "twofactor_enforced_excluded_groups": [],
        "mysql.utf8mb4": true,
        "clear_site_data": true,
        "mail_sendmailmode": "smtp",
        "updater.release.channel": "stable",
        "app_install_overwrite": {
            "0": "ocr",
            "1": "files_ebookreader",
            "2": "epubreader",
            "3": "dicomviewer",
            "4": "mindmap_app",
            "5": "fulltextsearch",
            "6": "fulltextsearch_elasticsearch",
            "7": "files_fulltextsearch",
            "8": "files_fulltextsearch_tesseract",
            "9": "riotchat",
            "10": "ojsxc",
            "11": "extract",
            "12": "memories",
            "13": "music",
            "14": "files_rightclick",
            "15": "metadata",
            "16": "talk_matterbridge",
            "17": "files_archive",
            "18": "cfg_share_links",
            "20": "tasks",
            "21": "occweb",
            "22": "radio",
            "23": "files_antivirus",
            "24": "side_menu",
            "25": "duplicatefinder",
            "26": "epubviewer",
            "27": "maps",
            "28": "electronicsignatures",
            "29": "intros",
            "30": "thesearchpage",
            "31": "timemanager",
            "32": "uppush"
        },
        "preview_max_x": 2048,
        "preview_max_y": 2048,
        "jpeg_quality": 60,
        "default_phone_region": "DE",
        "enable_previews": true,
        "session_relaxed_expiry": true,
        "trusted_proxies": "***REMOVED SENSITIVE VALUE***",
        "memories.exiftool": "\/var\/www\/nextcloud\/apps\/memories\/bin-ext\/exiftool-amd64-glibc",
        "memories.vod.path": "\/var\/www\/nextcloud\/apps\/memories\/bin-ext\/go-vod-amd64",
        "memories.vod.ffmpeg": "\/usr\/bin\/ffmpeg",
        "memories.vod.ffprobe": "\/usr\/bin\/ffprobe",
        "maintenance_window_start": 100,
        "trashbin_retention_obligation": "auto, 30",
        "versions_retention_obligation": "auto, 180",
        "activity_expire_days": 365,
        "memories.db.triggers.fcu": true,
        "data-fingerprint": "2f550edebc0aa062e8c84b74fddcb9bc",
        "auth.webauthn.enabled": true
    }
}

Apps

Enabled:

  • activity: 4.0.0
  • app_api: 5.0.2
  • assistant: 2.4.0
  • calendar: 5.1.2
  • cfg_share_links: 6.1.1
  • circles: 31.0.0-dev.0
  • cloud_federation_api: 1.14.0
  • contacts: 7.0.3
  • contactsinteraction: 1.12.0
  • context_chat: 4.1.0
  • dashboard: 7.11.0
  • dav: 1.33.0
  • deck: 1.15.0
  • dicomviewer: 2.3.0
  • drop_account: 2.7.1
  • eidlogin: 1.0.18
  • epubviewer: 1.7.3
  • extract: 1.3.6
  • federatedfilesharing: 1.21.0
  • federation: 1.21.0
  • files: 2.3.1
  • files_antivirus: 6.0.0
  • files_archive: 1.2.3
  • files_automatedtagging: 2.0.0
  • files_downloadlimit: 4.0.0
  • files_emailviewer: 0.1.4
  • files_external: 1.23.0
  • files_fulltextsearch: 31.0.0
  • files_fulltextsearch_tesseract: 27.0.1
  • files_mindmap: 0.0.33
  • files_pdfviewer: 4.0.0
  • files_reminders: 1.4.0
  • files_sharing: 1.23.1
  • files_trashbin: 1.21.0
  • files_versions: 1.24.0
  • files_zip: 2.1.0
  • fileslibreofficeedit: 2.0.1
  • firstrunwizard: 4.0.0
  • flow_notifications: 2.0.0
  • fulltextsearch: 31.0.0
  • fulltextsearch_elasticsearch: 31.0.0
  • gpoddersync: 3.12.0
  • gpxpod: 7.0.4
  • integration_openai: 3.4.0
  • intros: 1.0.2
  • libresign: 11.0.3
  • logreader: 4.0.0
  • lookup_server_connector: 1.19.0
  • mail: 4.2.3
  • maps: 1.5.0
  • memories: 7.5.2
  • metadata: 0.21.0
  • nextcloud_announcements: 3.0.0
  • notes: 4.11.0
  • notifications: 4.0.0
  • notify_push: 1.0.0
  • oauth2: 1.19.1
  • occweb: 0.2.2
  • ownershiptransfer: 1.1.0
  • passwords: 2025.2.20
  • photos: 4.0.0-dev.1
  • polls: 7.3.2
  • previewgenerator: 5.8.0
  • privacy: 3.0.0
  • profile: 1.0.0
  • provisioning_api: 1.21.0
  • radio: 1.0.3
  • recommendations: 4.0.0
  • related_resources: 2.0.0
  • repod: 3.5.6
  • richdocuments: 8.6.2
  • riotchat: 0.18.7
  • serverinfo: 3.0.0
  • settings: 1.14.0
  • sharebymail: 1.21.0
  • side_menu: 4.0.1
  • snowflakestheme: 1.1.3
  • spreed: 21.0.0
  • support: 3.0.0
  • survey_client: 3.0.0
  • systemtags: 1.21.1
  • talk_matterbridge: 1.31.1026000
  • tasks: 0.16.1
  • text: 5.0.0
  • theming: 2.6.1
  • thesearchpage: 1.2.8
  • timemanager: 0.3.17
  • twofactor_backupcodes: 1.20.0
  • twofactor_webauthn: 2.1.0
  • unroundedcorners: 1.1.4
  • updatenotification: 1.21.0
  • uppush: 2.3.0
  • user_status: 1.11.0
  • viewer: 4.0.0
  • weather_status: 1.11.0
  • webhook_listeners: 1.2.0
  • welcome: 1.2.1
  • workflow_ocr: 1.31.0
  • workflow_script: 2.0.0
  • workflowengine: 2.13.0
    Disabled:
  • admin_audit: 1.21.0 (installed 1.8.0)
  • bruteforcesettings: 4.0.0 (installed 4.0.0)
  • comments: 1.21.0 (installed 1.3.0)
  • encryption: 2.19.0
  • files_rightclick: 0.15.1 (installed 0.15.1)
  • password_policy: 3.0.0 (installed 1.3.0)
  • snappymail: 2.38.2 (installed 2.38.2)
  • suspicious_login: 9.0.1
  • twofactor_nextcloud_notification: 5.0.0 (installed 5.0.0)
  • twofactor_totp: 13.0.0-dev.0 (installed 13.0.0-dev.0)
  • user_ldap: 1.22.0

The terminology is a little confusing, that happened to me as well. Context Chat is for chatting with your documents, if you have that enabled.
The Context Agent is used for tasks beyond files, e.g. schedule a meeting. You can access it directly in “Chat with AI”, but it only works if the AI model has the correct capabilities (in my case it only worked with qwen3:8b so far).