On this page
Connect a provider with a backup, then name the assistant and choose the questions it offers first.
Who can do this: a role that holds the AI capability; owners and admins hold it by default.
Before you start#
- An API key from the provider you choose, unless the organization uses the shared platform configuration.
Steps#
- Open Settings > AI ("Cài đặt > AI").
- Choose the source: the shared platform configuration, or the organization's own API key. The shared option is marked unavailable when the platform has no active configuration.
- In Primary connection, pick the provider, paste the key, choose a primary model, press Test connection, then Save. A saved key stays hidden; leave the field empty to keep it.
- Add backup models to the primary connection and, with a second provider key, a Backup connection. List order is the fall-through order.
- Open Settings > AI assistant ("Cài đặt > Trợ lý AI") to set the name, the greeting and up to eight starter questions, plus a second set for market screens.
- Check: Test connection reports "Connected", and Chat answers instead of showing "AI is not configured. Check the AI connection in AI settings."
If it fails#
| Symptom | Cause | Fix |
|---|---|---|
| "AI is not configured..." | No active connection, or the saved key can no longer be decrypted | Check the connection and save the key again on Settings > AI. |
| An insight job stays waiting or retrying | The provider is slow or unresponsive | Nothing to do; it clears once the provider responds. |
| The assistant will not answer about a plane | No data flows on that plane yet | Check the connector; see Troubleshooting. |
| Nobody can open Settings > AI or Chat | The role lacks the AI capability | A super admin grants it on the organization's Roles page. |