Skip to main content

Ask the AI companion about a meeting

Decidesk exposes its governance data to the Nextcloud AI Chat Companion, so you can ask "what action items are due this week?" or "summarise the last council meeting" instead of clicking through lists.

Goal​

By the end you will know how to open the AI companion, ask it a Decidesk question, and read the answer — including the source objects it cites.

Prerequisites​

  • The Nextcloud AI Chat Companion available on your instance (hydra ADR-034), with a model configured.
  • The OpenRegister app at a version that publishes the IMcpToolProvider interface — Decidesk registers its tools automatically against it, no admin step.
  • Some Decidesk data to ask about (meetings, decisions, action items).

Steps​

  1. Open the AI Chat Companion (the chat panel in the Nextcloud sidebar, or the companion app). It greets you with a chat box.

    AI companion chat panel

  2. Ask a Decidesk question in plain language — for example "What action items are open and due this week?" The companion calls Decidesk's action-items tool behind the scenes.

    Asking the companion about action items

  3. Read the answer. It lists the items with assignees and due dates, and — because every Decidesk tool returns a sources[] array — it cites which objects it used, so you can open them directly.

    Companion answer with cited sources

  4. Follow up — "summarise the last council meeting", "which motions are still admissible but not voted?", "start the next board meeting". Each call is argument-validated and authorisation-checked against the objects before it runs, so the companion only ever shows you what you're allowed to see.

    Follow-up question to the companion

Verification​

The companion returns a relevant answer (not "I don't have access to that"), the answer cites Decidesk objects you can click through to, and an action that changes state (e.g. "start the meeting") only succeeds if you have the right role.

Common issues​

SymptomFix
Companion says it can't reach DecideskOpenRegister must be at the release that publishes IMcpToolProvider; if it isn't, the tools are simply unavailable and the rest of Decidesk still works.
Companion answer omits sourcesRe-ask — every Decidesk tool returns sources; an answer without them usually means the model didn't actually call the tool. Be specific ("list the open action items").
"Not authorised" on an actionThe authorisation check runs before any business logic — you don't have the role that action requires for that body.
/api/chat/health 404 in the browser consoleHarmless — that's the companion probing whether the chat back end is wired up; Decidesk's own pages don't depend on it.

Reference​