Skip to content
MSO CloudDocumentation

Configure AI and the data assistant

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.
AI configuration"Cấu hình AI"1AI configuration sourceUse the shared platform configurationUse this organization's own API key2Primary connectionConnection namePrimary GeminiAI providerGeminiAPI Key•••••••••••• (saved - leave empty to keep)Primary modelgemini-2.5-proFetch latest modelsBackup modelsgemini-2.5-flashAdd backup modelTest connectionConnectedSave3Backup connectionConnection nameOpenAI fallbackAI providerOpenAIPrimary modelgpt-5-miniActiveMove upMove downAdd backup connectiontried top to bottom4AI assistant (Settings > AI assistant)Assistant nameTrợ lý dữ liệuGreetingChào bạn, hỏi gì về doanh thu?Starter questions (up to 8)Doanh thu tuần này so với tuần trước?SKU nào sắp hết hàng?Kênh nào có tỷ lệ hoàn cao nhất?Market questions: a second set of up to 8, shown on market screens5
Settings > AI and Settings > AI assistant. Callout N marks the control used in step N.

Steps#

  1. Open Settings > AI ("Cài đặt > AI").
  2. 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.
  3. 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.
  4. Add backup models to the primary connection and, with a second provider key, a Backup connection. List order is the fall-through order.
  5. 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.
  6. Check: Test connection reports "Connected", and Chat answers instead of showing "AI is not configured. Check the AI connection in AI settings."
Where an answer comes from when the primary failsPrimary modelprimary connectionBackup modelsame connection, same keyBackup connection 1its own provider and keyBackup connection 2list order, top to bottomerror or 30 s silenterror or 30 s silenterror or 30 s silent0 s30 s60 s90 sA single candidate has no timeout: its error is the answer.Streaming: no switch once the first token has reached the reader.
One request walks the candidate list in order; the axis is the worst-case wait before each candidate is reached (30 s per attempt to the first token).

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.