Skip to content

fix(handbook): Adjust FlowFuse Expert onboarding procedure - #5333

Merged
ppawlowski merged 3 commits into
mainfrom
fix-handbook-assistant-expert-onboarding
Jul 20, 2026
Merged

fix(handbook): Adjust FlowFuse Expert onboarding procedure#5333
ppawlowski merged 3 commits into
mainfrom
fix-handbook-assistant-expert-onboarding

Conversation

@ppawlowski

@ppawlowski ppawlowski commented Jul 15, 2026

Copy link
Copy Markdown
Contributor

Description

This pull request adjusts the FlowFuse Expert onboarding process.

Requires FlowFuse/docker-compose#352 to be merged first.

Related Issue(s)

Closes https://github.com/FlowFuse/engineering/issues/141

Checklist

  • I have read the contribution guidelines
  • I have considered the performance impact of these changes
  • Suitable unit/system level tests have been added and they pass
  • Documentation has been updated
  • For blog PRs, an Art Request has been created (instructions)

@ppawlowski ppawlowski changed the title fix(handbook): Adjust FlowFuse Axpert onboarding procedure fix(handbook): Adjust FlowFuse Expert onboarding procedure Jul 15, 2026
@netlify

netlify Bot commented Jul 15, 2026

Copy link
Copy Markdown

Deploy Preview for flowforge-website ready!

Name Link
🔨 Latest commit 7ce5571
🔍 Latest deploy log https://app.netlify.com/projects/flowforge-website/deploys/6a5a084c81abac0008860830
😎 Deploy Preview https://deploy-preview-5333--flowforge-website.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.
Lighthouse
Lighthouse
1 paths audited
Performance: 67 (🔴 down 7 from production)
Accessibility: 96 (no change from production)
Best Practices: 100 (no change from production)
SEO: 91 (no change from production)
PWA: -
View the detailed breakdown and full score reports

To edit notification comments on pull requests, go to your Netlify project configuration.

@dimitrieh dimitrieh left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

LGTM.

@ppawlowski @Steve-Mcl I take it that the insights mode config is still needed to be added in case they don't upgrade to the point release?

Comment on lines -36 to +42
assistant:
enabled: true
service:
url: https://expert.flowfuse.com/v1/openai
token: <Assistant Token>
expert:
enabled: true
service:
url: https://expert.flowfuse.com/v4/expert
token: <Expert Token>
The feature is enabled by adding valid tokens to the `.env` file used to configure a FlowFuse Platform.
Tokens should be added to the `ASSISTANT_TOKEN` and `EXPERT_TOKEN` environment variables (find and replace the `<Assistant Token>` and `<Expert Token>` placeholders with the actual tokens provided by FlowFuse Support/Sales).

```yaml
ASSISTANT_TOKEN="<Assistant Token>"

EXPERT_TOKEN="<Expert Token>"

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I am not privy to all changes made - I assume the relevant YML being removed here is reconstituted from the presence of these 2 tokens?

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This is correct - configuration is gated behind tokens.

service:
url: https://expert.flowfuse.com/v1/openai
token: Provided-Assistant-Token
expert:

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Are we not adding info to enable insights?

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Actually, thinking about that - I believe @cstns made a change in forge to default to enabled (can you confirm)?

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

was also my question: #5333 (review)

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I think this was merged indeed, so if the client updates to the latest version of FlowFuse I assume this wouldn't be necessary.

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Actually, thinking about that - I believe @cstns made a change in forge to default to enabled (can you confirm)?

Confirming this was resolved in FlowFuse/flowfuse#7773. Note that this introduces a dependency between the configuration and the FlowFuse version: the setting only takes effect from the release (or minor release) that includes the fix onward.

@ppawlowski
ppawlowski merged commit 695ff83 into main Jul 20, 2026
7 checks passed
@ppawlowski
ppawlowski deleted the fix-handbook-assistant-expert-onboarding branch July 20, 2026 16:57
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

5 participants