Your first conversation
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.
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.
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.
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.