When something does not work in Agents
An agent that does not run, may not read, cannot be changed or approved, a report that did not arrive, a missing catalog agent — what each message means and what to do.
Most problems in Agents come from four things: the agent may not read yet, it is someone else's, the workspace is paused, or a fresh sign-in is needed. Each section below starts from what you see.
An agent does not run on its schedule
- Open it in My agents and look at Health and Next run.
- Draft or Paused — click Activate or Resume.
- Not allowed to read, or will not run — not allowed under Next run — its owner clicks Allow reading … as me on its Overview.
- A red or amber banner on top — the workspace is paused: Limits, budgets and workspace rules.
- Its monthly budget is spent — the next run does not start until next month or a higher budget in Limits & budget.
Not allowed to read
The agent reads CRM, Email & Push, CDP or another service as its owner, and the owner has not allowed it, or took it back. The Dashboard shows Permission · not given with Allow it. Only the owner can allow it: on the agent's Overview or in Settings → Permissions, Allow reading … as me, then confirm with the Monfri sign-in.
A chip Ended — … means the permission ended — for example, the owner withdrew it. The owner allows it again.
A service does not know you yet
Activate answers that CDP, Automation, Assistant or Notes does not know you as a member of this workspace yet. You have access to the service, but you have never opened it in this workspace, so it has no record of you and would refuse everything the agent reads as you. Open that service once from Monfri, then click Activate again.
The same shows after a try or a run, under What it had nothing to work with: the service is named, with Open … beside it.
The try says there is nothing
A try on a new workspace often ends with one sentence — no deals, no visits, no campaigns. Under the report, What it had nothing to work with lists each thing the agent read and found empty, and says where that data comes from: CRM fills as you add or import contacts and deals, CDP once the Monfri tag is on your site, Email & Push with your subscribers and first campaigns. Add the data, then try again. The same list is on the run's page.
The permission was not recorded
Back from the sign-in, the agent's page says why:
- You signed in at Monfri as a different person. Only the owner can allow this agent. — sign out of Monfri and sign in as the owner.
- Your Monfri sign-in is in another workspace. Switch to this workspace and try again.
- The agent changed while you were signing in. Look at it again and allow it once more.
- You do not have access to one of these services yourself, so the agent cannot read it as you. — ask an owner or admin for access to that service: Service access.
Sign in again
Approving a proposal, choosing Automation flows, and activating an agent that starts on an event are done as you in another service, and need a fresh Monfri sign-in. When Agents asks, click Sign in again, sign in, and repeat what you did. Nothing was done before.
Only the owner of this agent can … Make a copy to have one of your own.
The agent reads a service as its owner, so only they run, change, activate or decide on it — an admin can still pause or archive it. Click Make a copy: a draft of your own with the same job, which reads as you once you allow it.
Only the owner of this agent sees its runs and proposals. is the same rule for its runs, reports and proposals.
The last run failed
The Dashboard shows Agent · last run failed with Open runs. Open the run: the error is shown where the report would be, and Timeline shows the step. The owner also gets an email about the first scheduled run that does not succeed after one that did — with the reason and what to do — and, after 3 failed runs in a row, an alert, if it is on: Runs, tries and Activity.
The last run finished, but it could not read what it needs — … means the run wrote a report although none of its reads worked, so the report says nothing about your data. The words after the dash are the first refusal. Most often the owner has lost access to the service, or the permission ended — see Not allowed to read above.
A run that reaches its limit of time, steps or cost now ends with a report of what it had read by then, and says so, instead of ending with nothing. Raise the limit in Limits & budget if the report is cut short often.
A report did not arrive
A run you start yourself is never emailed. For a scheduled run, check the agent's Report & delivery (Email me the report, Send, Say nothing when there is nothing to report) and Settings → Delivery — you may take a daily digest instead. The run's Timeline says where the report went: Where reports go.
The numbers in a report look wrong
A catalog agent's page says under What the code checks which of its numbers and lines are written by code from what it read; where it says Its report is the model’s own., the report is the AI's. In an agent you described in words or built from scratch, the names and numbers are written by the AI and not checked — try it and compare with the service before you rely on it.
An agent is missing from the catalog
The catalog shows only agents whose services you have access to, and the news agents only on a news site. Carts and checkout and Stock and promotions are for an online shop: they are not offered in a workspace whose sites are set up and none of them is a shop. Ask an owner or admin for access to the service: Service access.
Messages about the whole workspace
Agents is switched off for this workspace in Monfri.
Agents is off for this workspace. An owner or admin switches it on in the Hub, in Manage services: Open, activate and deactivate services.
Access to Agents is suspended by Monfri. Please contact us.
Write to Monfri support: Getting help.
This agent is not here
It was deleted, or it belongs to another workspace. If you have more than one workspace, switch in the top bar.
Your access to Agents has ended
You no longer have Agents in this workspace. An owner or admin gives it back in Monfri.
If something doesn't work
The problem is not here
Look at the article of the page where it happens: Approvals, When an agent runs, An agent's page and its settings, Start from the catalog.