AI Suggestions
AI suggestions let the FluidGrids assistant look out for problems in your workspace while you get on with other work, and bring each one to you with a suggested next step. When a workflow run fails, for example, you see a suggestion such as CRM API key revoked: update the CRM credential to restore syncing, with buttons to open the run or to have a fix proposed.
The assistant only reads, and only what you can see. It never changes anything on its own: every change is a button you click.
AI suggestions are being rolled out workspace by workspace and are off until they are turned on for your workspace.
What it looks for
| Suggestion | When it appears |
|---|---|
| A run failed | A run of one of your workflows failed. If a workflow fails several times, you get one suggestion about its newest failed run, not one per run. |
| The same step keeps failing | The same step of a workflow failed in several runs with the same kind of error. |
| A workflow could be improved | A change could make a workflow cheaper or more reliable. |
| A connection needs attention | A connection stopped working, has expired, or was never finished and still needs you to sign in. Workflows that use it fail until it is fixed. |
The second and third kinds come from FluidGrids' own analysis of failing steps and of workflow optimisation, so they appear only in workspaces where those features are turned on.
The assistant decides which problems are worth raising and words each suggestion. It may leave a problem out, for example an error that reads like a deliberate test.
Turn it on
Two things have to happen, in this order.
- The feature is turned on for the workspace. AI suggestions are off by default and are turned on for a whole workspace by an administrator. If you would like them in your workspace, ask Support. Individual kinds of suggestion can also be turned off for a workspace.
- Each person opts in. Turning the feature on for the workspace only makes it available. Nobody gets suggestions until they switch them on for themselves.
To opt in:
- Open Settings › AI suggestions (
/settings/ai-suggestions). The entry appears in the Settings menu only once the feature is on for your workspace; before that, the page says AI suggestions are not available in this workspace yet. - Under Proactive suggestions, switch on Let the assistant look for suggestions.
- Click Save. The page confirms Saved. and shows Your permission lasts until a date 30 days from now.
To stop, switch Let the assistant look for suggestions off and click Save.
What you agree to
Switching suggestions on gives the assistant your permission to look through FluidGrids in the background, as you:
- Read-only. The permission lets it read, never write. A change attempted with it is refused.
- Only what you can see. It reads as you, so it sees exactly what your role lets you see, and nothing more.
- For 30 days. The date is shown under the switch. When the 30 days are up the switch shows as off again and the assistant stops looking. Switch it on and click Save to give permission for another 30 days.
- Withdrawn at once when you switch it off. Saving with the switch off ends the permission immediately, and checks that were already waiting are dropped.
Your suggestions are yours: each person who opts in gets their own, about what they can see.
Where suggestions appear
- The Suggestions button in the top bar, a sparkle icon with the number of open suggestions. It is in the desktop top bar and in the phone top bar (on a phone-width browser and in the mobile app). Click it to open your suggestions; the list fits a phone screen. The button appears only after you have opted in.
- Pins on the item itself. A small sparkle pin appears on what the suggestion is about: the failed run's row in the Executions list (sidebar Runs), the connection's card on the Connections page, or the step on the workflow canvas in the Visual Builder. Click the pin to open the same suggestion; press Escape to close it. If the item is not on the page you are looking at, the suggestion is in the Suggestions list only.
- Settings › AI suggestions also lists your open suggestions under the switch.
Each suggestion card shows its severity (Urgent, High, Medium or Low), an AI suggestion badge, a short title, a sentence or two on why it matters, and its buttons.
What the buttons do
A card shows only the buttons that fit its problem.
| Button | What it does |
|---|---|
| Open run | Opens the failed run, and closes the Suggestions list. |
| Open workflow | Opens the workflow in the builder. |
| Propose a fix | Asks the assistant to draft a fix for the failed run and shows it in a Proposed fix dialog for you to review. Applying it saves the change as a new draft version of the workflow. Nothing runs until that version is made live: you activate it yourself or, where your workspace changes Production only through promotions, promote it through the usual promotion and approval. Proposing a fix uses your workspace's AI credits; without them, the dialog says so. |
| Review the proposed fix / Review the change | Opens a fix or improvement that FluidGrids has already prepared, in the same dialog. Applying it also only creates a draft version. |
| Fix connection / Open connection | Opens the connection so that you can reconnect it or finish signing in. See Credentials. |
| Ask why it failed | Opens the AI Assistant with the question already asked about that run. |
| Dismiss | Removes the suggestion. It stays gone after a reload. |
| Snooze 1 day / Snooze 1 week | Hides the suggestion until then. It comes back on its own when the time is up. |
If an action cannot be completed, the card says That didn't work. Try again, or open it yourself.
A dismissed problem is not raised again for a week (see below), so dismiss what you have dealt with or do not need, and snooze what you want to come back to.
When suggestions arrive
The assistant checks for problems when you open a run, a workflow or a connection, and once a day for the whole workspace (at 06:00 UTC), so problems that happened while you were away are found too. Limits you will notice:
- About 15 minutes after a problem is found. Problems are collected for 15 minutes so that one review covers them together, and the review itself usually takes under a minute.
- A few reviews a day. The assistant reviews your problems at most three times a day (and a workspace at most 20 times a day). Each review can raise several suggestions. Problems found after that wait until the next day (00:00 UTC).
- The same problem is not repeated for a week, even if you dismissed it. A workflow that keeps failing is one problem.
- At most one suggestion per item per day, for example per run or per connection.
Delivery outside the app is coming
Today suggestions appear only in the app: the Suggestions button, the pins and the Settings page. They are not sent by email.
The settings page already has a choice, When you're away, send suggestions, with As they come, In a daily digest and In a weekly digest. Your choice is saved, but it has no effect yet. Delivery outside the app, by email and as a digest, is coming; until then, check the Suggestions button.
Privacy
- The assistant reads only what you can see, and only reads. It cannot create, change, run or delete anything.
- Nothing changes without your click. Every button runs under your own session, with your own permissions, exactly as if you had gone there yourself. A proposed fix is saved as a draft and does nothing until it is activated or promoted to Production.
- The AI review sees only a short summary of each problem the check found, such as the workflow, the error type and the error message, not your whole workspace. It never receives your passwords, tokens or connection secrets.
- Text that other people or outside services wrote, such as an error message, is treated as data. The assistant does not follow instructions found in it.
- Suggestions are written by AI. Check the run or connection before you act on one.
- Switching suggestions off withdraws the assistant's permission at once.
If you don't see suggestions
| What you see | Why |
|---|---|
| No AI suggestions in Settings, or AI suggestions are not available in this workspace yet. | The feature is not on for your workspace yet. Ask Support. |
| No Suggestions button in the top bar | You have not opted in, or your 30 days are up. Switch it on in Settings › AI suggestions and click Save. |
| A run failed but no suggestion arrived | It can take about 15 minutes. You may also have had your three reviews for today, the same problem may have been raised in the past week, or the assistant judged it not worth raising. |
| A suggestion in the list but no pin | The item it is about is not on the page you are looking at. The suggestion is still in the Suggestions list. |
| Propose a fix says there are no credits | Proposing a fix uses the workspace's AI credits. See Plans and Quotas. |