MitDesk docs
Using MitDesk

Chat that reads your data

5 min read Odoo 20.0

Use the chat to ask questions about your Odoo data and to ask an AI agent to do work for you. This page shows the chat screen, how answers show their sources, and how to give the agent more context.

Who this is for: everyday users.

You need: Edition: Basic and above. Reading PDF and Office files you attach needs Pro. See Editions.

Open the chat with MitDesk ▸ Chat. You can also use the MitDesk icon in the top bar, or press Ctrl+Shift+M (Cmd+Shift+M on a Mac). That opens a small chat window that stays on top of any Odoo screen.

A new chat with starter questions, the agent name with its autonomy level, the message box and the right panel

Whose rights the chat uses

The agent reads Odoo data with tools such as search_records and read_record. These tools run as a real Odoo user, never as the superuser. MitDesk stops the run if a tool would start as the superuser.

  • Normally the agent acts as you. It sees what you may see.
  • An agent can have a Run as user. Then its tools run as that user. Such an agent is shown only to the users and groups named on it. See Autonomy policies.

A label next to the agent name tells you that you are talking to an AI system. Content the AI creates carries an AI badge.

Ask a question

  1. Click a starter question, or type your own in the message box.
  2. Press Enter to send. Press Shift+Enter for a new line.
  3. Read the answer. Under it you see Sources and Ask next (suggested follow-up questions).

An answer with its sources, follow-up questions and the panel "What this agent may do"

Useful things in the chat:

  • Under How it got there you can open the steps the agent took.
  • Under an answer, use the buttons to copy it, mark it as helpful or not helpful, or run it again. A "not helpful" mark saves the answer as a draft check for an administrator to review.
  • If the agent is busy, choose Add to chain (your message waits) or Interrupt and reassess (the agent stops and reads your message).
  • Use the microphone button to dictate a message.
  • Type / to see skills and commands you can insert.
  • Press Ctrl+F to search inside the conversation.
  • Start fresh makes the agent forget the chat so far. Nothing is deleted.

If the chat shows Set up your AI provider, no model is ready yet. An administrator can fix this in Connect a model.

Approve actions inside the chat

When the agent wants to change something, it may need your approval first. The request appears in the chat as a card. It shows what will happen, the records it touches and the old and new values.

  • Approve or Deny the request. If you may not decide it, the card tells you who can.
  • If the agent asks for more tools or skills than it has, an administrator can choose Allow in this conversation or Allow for this agent.
  • Approve & don't ask again creates a narrow automatic rule. It is offered only when this is safe. See Decisions.

Sources and citations

Answers can carry citations. A citation is a record the agent read: it shows the record name and, when the source has them, a page, a section, a relevance percentage and the search tier. Before MitDesk shows a citation, it checks that you may open the record.

MitDesk tells the agent that totals, averages and counts must come from a tool, not from guessing. A page of records is only a sample of the whole set.

The Context panel

Click Context to open the panel on the right. It has three parts.

Part What it shows
Pinned for this chat The record that travels with every question in this chat.
Sources used The sources of the last answer. Three are shown. Click Show all for the rest.
What this agent may do One line for each permission, with a Change permissions button.

Pin a record

Open the chat from a record, or click the pin button on any source. From then on, a short summary of the pinned record goes with every question. MitDesk reads it with your rights. If you may not read the record, nothing is sent.

If you pin a customer or contact, the panel offers Open 360° board. See The 360 customer board.

Agent settings

The settings button in the chat header opens the agent in the panel. Administrators can change the prompt, tools, skills and sources there. In Add sources they can upload a file, add a link, add business data, or add from Documents or Knowledge. See Knowledge and sources.

Choose the agent

The picker above the message box lists the agents you may use. It also has Auto — pick the agent from my question.

With Auto on, MitDesk chooses the agent when you send the first message of a new, empty chat. It compares the words of your question with each agent's name, instructions, starter prompts, skills and tools. No AI model makes this choice, so nothing leaves your server. MitDesk tells you which agent answered and why.

Auto skips agents whose model is not set up yet. Under sovereign routing it also skips agents that may not see your question. Auto never changes the agent of a chat that already has messages. Switching later is a step you confirm yourself.

Files and artifacts

Click the paperclip to attach a file, or drop a file on the chat.

  • Always readable: text, Markdown, CSV, JSON and HTML.
  • Photos and scans (PNG, JPEG): MitDesk reads the text in them on your server. This can take a few minutes.
  • PDF, Word, Excel and PowerPoint: these need Pro. The server also needs the matching reader packages. If a file cannot be read, its chip turns red and explains why.

The folder button opens the artifacts panel. Records lists the records cited in this chat. Files lists files the agent created.

Your conversations

The left side lists your chats. You can search them, rename them and filter them by agent. Administrators see all conversations in Configuration ▸ What has run ▸ Conversations.

The Conversations list with the agent, the user and the state of each chat

If it does not work

If an answer never starts, or stops early or comes back empty, see Troubleshooting.