Skip to main content

App User Agent

In-app assistant for published app users (not builders). Builders enable it per application under App Settings → User Agent.

What users can do​

  • Ask about data visible on the current page (tables, charts, query results)
  • Confirm before running builder-defined skills (queries)
  • Confirm before filling form fields or triggering a button/submit

Setup​

  1. Configure org AI provider (same BYOK as Builder Copilot).
  2. Open the app → Settings → User Agent.
  3. Enable the agent, set a display name, add skills bound to queries.
  4. Deploy / Publish so publishedApplicationDetail.userAgent is live.
  5. In the published app, use the FAB near “Built with Groove Builder”.

Security​

  • Skills are an allowlist of action ids; the server validates run_skill against published config.
  • Page data is redacted/capped before it reaches the model.
  • Mutations never run until the user clicks Confirm.