Agent collaboration
Work with agents on the current board, leave Ask or Run messages on nodes, and review each round of changes.
Get started
To work with an agent on a board, add the agent app in Midmap and configure MCP. See MCP connection.
When the connection is successful, the agent status in Midmap shows Online. You can then call Midmap from a conversation in that app.
Work on the current board
Before acting, the agent reads the board currently open in Midmap, the selected node, and unread messages. Messages it reads are marked as read.
You can discuss the current board in the agent conversation or ask the agent to make changes.
After the agent creates a board, Midmap opens it automatically so you can continue working. If Midmap is in use when the board is created—for example, if you are editing another board—it will not switch to the new board, so your current work is not interrupted.
You can also ask the agent to view or edit another board. Name the target board in your request to avoid changes to the wrong board.
Leave messages on nodes
Hover over a node to reveal the Ask and Run buttons. These two types of notes are called messages in Midmap.
After you enter and save a message, it is stored on the board; it is not sent to the agent immediately.
When the agent calls Midmap during a conversation in the agent app, it reads the unread messages on the current board.
Midmap’s MCP instructions tell the agent how to handle each type of message:
- Ask: Used to ask questions, clarify, or discuss. This type of message is conversation content only and is not treated as an instruction to perform an action.
- Run: Used to specify a board action. The agent carries it out when it reads the message.
After the agent reads an unread message, Midmap marks it as read. It will not be provided again as an unread message. To have the agent notice it again, choose Mark as unread.
Messages are useful for temporary, one-off discussions or instructions for the agent to respond to in its next conversation. You can leave messages on different nodes, then ask the agent to review and handle them together in one conversation in the agent app.
Here, “conversation” means a conversation in the agent app. Midmap does not currently provide a direct chat with an agent.
If you have many read messages, choose Clear to remove all read messages at once. Unread messages are kept.
Review and manage changes
The canvas updates in real time as the agent makes changes, and Midmap shows a notification for the current operation. Nodes use color markers to show the type of change:
- Green: This node was added or moved under a different parent.
- Orange: This node was modified. If there are changes in its folded subtree, this node also shows an orange marker.
- Red: This node’s child was deleted.
While the agent is working, you can still drag nodes, switch layouts, zoom the canvas, and fold nodes. These actions do not interrupt the agent’s edits.
The agent’s actions are grouped in the operation notification. Review the summary and color markers, then choose Accept to keep this round of changes or Reject to undo it.
The notification and color markers disappear when you choose Accept or edit the board yourself. You can still use the board’s Undo button to undo changes step by step through the operation history.