Skip to main content

The map of an agent, and its history

The visual editor shows an agent as cards — when, its steps, what it reads, proposes and reports. Change it there, try it, save it, and go back to an earlier version.

M
Monfri Team
Updated ·4 min read

The map is the visual editor of an agent: the same settings as its Settings, drawn as cards you click and change. Every save is a new version, and History lets you see what changed and go back to an earlier one.

Open the map

  • On the agent's page: … → Open the map (View the map for an agent you may not change).
  • In Settings: Form | Map → Map.

The map takes the whole window. Back to the agent (the arrow at the top left) returns to its page; your unsaved changes stay, in the map and in Settings, until you save or discard them.

The cards

The cards come in groups:

  • When — its schedule, its event, or When you run it;
  • The job and each Step of it, numbered;
  • Reads — the tools that read, each in the steps that call it;
  • Proposes — the tools that only create a proposal for a person;
  • Report and Delivery — what the report holds and where it goes.

On the left, Cards lists every card (a dot marks a changed one) and Add holds the tools by service and Add a step. On the right, the panel shows This card (or The agent), Try and Needs a look. On a narrow screen the three are tabs: Cards, Diagram, Panel.

Change the agent

  1. Click a card. Its settings open in the panel — the text of a step, the tools it calls, the inputs a tool is given, a tool's limits and proposals, the schedule, the report and the delivery.
  2. To add a step, click + between two steps, or Add a step in Add. A step uses a tool by naming it: pick one in Call another tool….
  3. Alt+↑ and Alt+↓ move the chosen step; Ctrl+Z and Ctrl+Shift+Z undo and redo; Esc closes the card.
  4. Needs a look lists what to fix before you rely on it — a tool a step names but the agent does not have, a tool that no longer exists, a required tool no step names, a pick it waits for — each with a button such as Add the tool, Pick or Go to.
  5. … changes · Review shows every change against the saved version.
  6. Try runs your changes as they are on live data — its proposals can never be approved.
  7. Click Save (Ctrl+S). It becomes the next version.

When steps are renumbered and one step mentions another by number, the map tells you to check the references.

See and restore an earlier version

  1. Open the agent → History (or History at the top of the map).
  2. Click a version on the left: when, who, what changed and how its runs went. What it changed compares it with the version before; The whole version shows it all.
  3. Click Restore v…, read what changes, and confirm with Restore v….

The old version becomes a new one — a copy — and nothing is lost: the current version stays in the history. An active agent runs the restored version from its next run. An agent made from words needs a successful try of it before it is activated again.

If something doesn't work

The agent changed since you opened it — it is v… now.

Someone saved the agent while you were changing it. Compare with yours shows both; then load theirs or save yours over it.

Read only

The agent is someone else's, or it is archived. Only its owner changes it; you can Make a copy on its page.

v… uses a tool that no longer exists (…), so it cannot be restored as it was.

A tool of that version was retired. Open the current version, change it by hand, and save.

Only its owner sees its history

The agent reads a service as its owner, so its history is theirs.

Didn't find your answer?

Write to us and tell us what you were trying to do.