MitDesk docs
Getting started

Your first conversation

4 min read Odoo 20.0

This page shows you how to open the chat, ask a question about your own data, and read the answer.

Who this is for: everyday users.

You need: Edition: Basic and above. See Editions. You need to be in the group MitDesk User, and an administrator must have connected a model.

Open the chat

There are three ways in. All of them are visible only to members of the group MitDesk User.

  • The MitDesk icon in the top bar. A badge shows when approvals are waiting or an answer is being written.
  • The command palette. Type ? to find New MitDesk chat and your recent chats.
  • Ask AI in the cog menu of a form, list, kanban, pivot or graph view. It sends what you are looking at to the chat as context.

You can also open MitDesk ▸ Chat. Chats can open as small windows that stay open while you move around Odoo. Up to six can be open at once.

A new chat: starter questions, the assistant name with the label Read only, the message box and a panel on the right

If no agent exists yet, the chat tells you so. An administrator sees the button Create your first agent. Otherwise you see the starter questions of the agent. Click one to send it. An agent has one to six starter questions. If a starter question contains {record}, MitDesk replaces it with the name of the record you pinned.

Ask about your data

Type a question about records you can already see. For example: "What needs my attention today?"

Under the answer you see a Sources row. Each chip is a record the answer used. Click a chip to open the record. Use the pin next to it to keep that record in the chat. You can also copy an answer, mark it helpful, or regenerate it.

If you mark an answer as not helpful, MitDesk saves it as a draft check for an administrator to review. It is more than a counter.

What you should see: a Sources row under the answer, with one chip for each record it used.

The answer to "What needs my attention today?" with Sources, Ask next suggestions and what this agent may do

Your past chats are listed under MitDesk ▸ Configuration ▸ What has run ▸ Conversations. Administrators see this menu. Everyone finds their own chats in the chat window.

The label beside the agent name

Next to the agent name you see a small label. It says what the agent may do in this chat. Point at it to read the full sentence.

Label What it means
Read only It only reads. It never changes anything.
Proposes It proposes each change. A person approves the proposal before it happens.
Asks first It asks a person for consent before each change.
Acts alone It acts on its own inside its rules.

The agent that comes with MitDesk is Read only. Nothing you ask it will change a record. Even Acts alone never lifts the limits for money, sensitive data and changes to the rules. Those always wait for a person. See Autonomy policies.

Next to the label you see the badge AI assistant. It tells you that you are talking to an AI system. Text that an agent writes in the Odoo chatter carries an AI badge too.

The panel on the right

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

  • Pinned for this chat shows the record this chat is about. The assistant keeps it in mind for the whole chat.
  • Sources used lists the records behind the last answer. You can open or pin each one.
  • What this agent may do says in a few lines what the agent reads and what it may change. If the agent runs as another user, a line names that user. The button Change permissions opens the agent.

When the assistant wants to change something

With Proposes or Asks first, the assistant does not write by itself. The request shows up as a card. It shows the action, the old and new value where there is one, who asked, and the record. Nothing happens until a person approves it. See Decisions: approving and answering.

With Acts alone, an allowed change runs at once. You get a receipt that says it was done on its own, with a link to the record. Administrators also see Ask me next time. It creates a rule so the same action waits for a person in the future.

An approval request: the requested action, the exact call, who asked and a preview of the record

If it does not work

If the assistant does not answer, see "Nothing answers, or answers never start" in Troubleshooting. If the chat says no agent exists, ask an administrator to create one.

Next steps