Solavel Docs

AI

Last updated

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

  1. Open the project → AI.
  2. Click an action button, e.g. Project brief. The button shows a spinner.
  3. 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

  1. In Pending suggestions, read the title, description and type.
  2. Click Apply.
  3. Confirm Apply suggestion — "This will apply the suggested change to the project. Review the suggestion before continuing."
  4. 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

  1. In Schedule, choose Frequency.
  2. Tick the actions to generate (at least one — Save is disabled with none ticked).
  3. 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).
  4. 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.

Related