The AI tab is the project's AI assistant. It reads the current project's data — tasks, documents, time, reports, planning, Playground boards, automations and recent activity — and produces insights (a project brief, a health explanation, a guest status draft, document and Playground summaries) and suggestions (new tasks, a client status document, automation rules). Nothing changes in your project until you click Apply on a suggestion.
Use it to prepare a weekly brief, understand why a project's health is slipping, draft a client update, or get a first list of next tasks. It is a tool for project managers and administrators; the assistant only ever looks at the project you are in.
Where to find it
| Sidebar | Project section → AI (between Integrations and Playground) |
| URL | /projects/{project}/ai |
| Command palette | AI · {project name} under Current project |
Who sees it:
- Plan: the AI assistant is an Enterprise-plan feature. On other plans the tab is hidden from the sidebar and the command palette.
- Role: the tab is manage-only — only people who can edit the project can load it. Others see "We couldn’t load the AI assistant." with Retry.
Screen tour
AI assistant card (top)
| Element | What it shows |
|---|---|
| Title | AI assistant |
| Subtitle | Generate project insights and review suggestions. Grounded only in this project’s data. — or, when no AI provider is set up for your workspace, Running on local heuristics — no external AI provider is configured for this workspace. |
| Insights | Number of insights in the log (latest 12). |
| Pending suggestions | Suggestions waiting for Apply or Dismiss (up to 30 shown). |
| Provider | Configured or Local only. |
| Action buttons | Project brief, Explain health, Suggest tasks, Draft guest status, Summarise docs, Summarise playground, Suggest automations. While one runs, the others are disabled. |
Schedule card
Auto-generate selected insights. Badge at the top-right: Next {date} or Not scheduled.
| Control | Meaning |
|---|---|
| Frequency | Daily, Weekly (default) or Monthly. |
| Active | Ticked = the schedule runs. |
| Action checkboxes | Which of the seven actions to generate (default Project brief and Explain health). |
| Footer | Last run {date} or No scheduled run yet; Save; Run now (only after the schedule is saved). |
Insight card
The selected AI insight (most recent by default). Shows the insight type, a badge Local heuristics (rule-based) or the AI confidence, and Provider fell back when the AI provider failed and local heuristics were used instead. The content is split into the sections the insight produced:
| Section | From |
|---|---|
| Summary | Project brief |
| Health explanation, Risks, Next actions | Explain health (and Project brief) |
| Client status / Guest status | Draft guest status |
| Docs summary | Summarise docs |
| Playground summary | Summarise playground |
| Suggested tasks | Suggest tasks |
| Suggested automations | Suggest automations |
Empty state: No insights yet — Use an action above to generate your first insight. If an insight produced nothing you see No content produced for this insight.
Insight log card
Recent generations. The latest 12 insights: type (e.g. Project Summary, Health Explanation, Client Status) and {date} · {who generated it}. Click one to show it in Insight. Empty: No insights yet.
Pending suggestions card
Apply to create the task/doc/automation, or dismiss. Each suggestion shows its title, description and a type badge, with Apply and Dismiss.
Empty state: No pending suggestions — Generating tasks, status drafts, or automations will surface suggestions here.
What each action does
| Button | Insight | Suggestions created | What Apply does |
|---|---|---|---|
| Project brief | Summary, risks and next actions. | — | — |
| Explain health | Health score, reasons, risks and recommended actions (see Projects). | — | — |
| Suggest tasks | Suggested next tasks. | Task — one per suggested task. | Creates a task in Todo with the suggested title, description and priority (default Medium), you as reporter. |
| Draft guest status | Client-facing status: title, body, completed, upcoming, risks, needs client attention. | Doc — the status draft. | Creates a client note document marked guest-visible in Files. |
| Summarise docs | Summary of the project's documents. | — | — |
| Summarise playground | Summary of Playground boards. | Action — ideas worth converting. | Records the suggestion in the project Activity (it does not convert the item; use Convert to task on Playground). |
| Suggest automations | Suggested automation rules. | Automation — one per rule. | Creates the rule paused on Automations so you can review it and click Resume. |
What the assistant can see
| Data | Normal actions | Draft guest status |
|---|---|---|
| Project details, health, progress, dates | Yes | Yes |
| Tasks | All tasks | Only guest-visible tasks |
| Documents | Documents you can see | Guest-visible only |
| Time | Summary | Not included (Time details are internal.) |
| Reports, planning, Playground | Yes | Guest-visible parts |
| Automation logs | Yes | Not included |
| Recent activity | Yes | Guest-safe only |
The assistant never looks outside the current project. Provider keys and prompts are never shown in the app.
Local only. When no AI provider is configured, insights are built from rules over your project data (task counts, due dates, blockers, health score). They are accurate but less fluent. If a configured provider fails, the insight is still produced locally and marked Provider fell back; the Activity log records AI provider failed; local fallback used.
Tasks
Generate an insight
- Open the project → AI.
- Click an action button, e.g. Project brief. The button shows a spinner.
- You see AI insight generated. The new insight opens in Insight and tops the Insight log. Activity records it (e.g. Project summary generated).
Errors: "Could not generate the insight.", "That AI action is not available.", "AI actions are disabled or not permitted.", "Please reload and try again."
Apply a suggestion
- In Pending suggestions, read the title, description and type.
- Click Apply.
- Confirm Apply suggestion — "This will apply the suggested change to the project. Review the suggestion before continuing."
- You see Suggestion applied. The suggestion leaves the list, the task/document/rule is created, and Activity logs Applied AI {type} suggestion '{title}'.
A suggestion can be handled once; a second attempt (for example from another tab) fails because "This suggestion has already been handled."
Dismiss a suggestion
Click Dismiss — Suggestion dismissed. No confirmation; nothing is created. Activity logs the dismissal.
Set up scheduled insights
- In Schedule, choose Frequency.
- Tick the actions to generate (at least one — Save is disabled with none ticked).
- Keep Active ticked and click Save. You see AI schedule saved. The badge shows Next {date} — tomorrow (Daily), one week from today (Weekly) or one month (Monthly).
- Click Run now to generate the ticked insights immediately — Scheduled AI insights generated.
Scheduled runs are generated as the person who last saved the schedule (or its creator) while they are still a member of the project; if neither is, the run is skipped. Untick Active and Save to stop the schedule (Not scheduled).
| Field | Required | Rules / defaults |
|---|---|---|
| Frequency | Yes | Daily / Weekly / Monthly; default Weekly. |
| Actions | At least one | Default Project brief + Explain health. |
| Active | — | Ticked by default. |
Statuses
| Object | Statuses |
|---|---|
| Insight | Generated (shown), or failed with an error line ⚠ |
| Suggestion | Pending (listed) → Applied or Dismissed (removed from the list) |
| Schedule | Active with Next {date}, or Not scheduled |
Permissions
| Role | Open the tab | Generate, apply, dismiss, schedule |
|---|---|---|
| Organization owner | Yes | Yes |
| Projects Administrator | Yes | Yes |
| Projects Manager who is a project Manager here | Yes | Yes |
| Projects Member, project Viewer, guests | No | No |
If AI actions are switched off for your organization, the tab is read-only: you see insights and suggestions but no action buttons, Schedule, Apply or Dismiss.
Worked examples
Example 1 — Monday brief (everyday)
Sara Khan opens AI on Al Noor Showroom Fit-out (ALN-FIT) and clicks Project brief. Insight shows a Summary (62% task completion; 2 overdue task(s); 1 blocked task(s)) and Next actions (Review due dates and owners for overdue tasks., Clear blockers before adding more active work.). She reassigns the two overdue tasks on Tasks.
Example 2 — Weekly client status and new tasks (full scenario)
Omar Haddad reports weekly to Al Noor Trading LLC.
| Step | Action | Result |
|---|---|---|
| 1 | Schedule: Weekly, ticks Project brief and Draft guest status, Save. | AI schedule saved.; badge Next Oct 12. |
| 2 | Run now. | Scheduled AI insights generated.; two new entries in the log; Pending suggestions 1 (the status doc). |
| 3 | Reviews the Guest status section — it lists only guest-visible tasks (no internal snagging tasks, no hours). Apply → confirm. | Suggestion applied. A guest-visible client note Project Status Update appears in Files. |
| 4 | Edits the note in Documents and shares it with the client via a guest share link. | Client reads it without a Solavel account. |
| 5 | Clicks Suggest tasks. Three task suggestions appear. Applies Confirm ceiling permit with DM, dismisses two. | Task ALN-32 created in Todo; Pending suggestions 0. |
| 6 | Clicks Suggest automations, applies Blocked work risk log. | Rule created Paused on Automations; Omar reviews and clicks Resume. |
How it connects
| Where | Link |
|---|---|
| Tasks | Applied task suggestions become tasks. |
| Documents | Applied status drafts become guest-visible client notes. |
| Automations | Applied automation suggestions become paused rules. |
| Playground | Summarise playground reads boards and suggests conversions. |
| Integrations | Applying a suggestion can send the ai.suggestion_applied webhook event. |
| Activity | Every generation, apply, dismiss and schedule change is logged. |
| Reports, Planning | Read as context. |
Tips and common problems
| Problem | Cause | Fix |
|---|---|---|
| No AI tab. | Plan is not Enterprise. | Upgrade in the Portal. |
| We couldn’t load the AI assistant. | You can't edit this project. | Ask a project Manager or administrator. |
| Output reads mechanical; Local only. | No AI provider for your workspace. | Results still reflect your data; keep due dates and blockers current. |
| Provider fell back badge. | The AI provider failed for that request. | Generate again later. |
| Applied automation doesn't run. | Suggested rules are created paused. | Resume it on Automations. |
| Guest status misses tasks. | It only uses guest-visible data. | Mark tasks/documents guest-visible if the client should see them. |
| Scheduled insights stopped. | The schedule's owner left the project, or Active is off. | Re-save the schedule yourself. |
| Save greyed out in Schedule. | No action ticked. | Tick at least one. |