Skip to main content
The Nudj Agent is a conversational AI co-pilot that plans, creates, and edits your loyalty program. It drafts challenges, rewards, achievements, and posts, tunes branding, generates images, and previews the result live — all inside a full-height chat workspace. This page covers what it can do and how to drive it.

​
Two agent modes

The agent derives your mode from your RBAC role — there is no manual switch. Viewers and Moderators stay in Planner mode; Managers and above get full Builder access. See Roles & Permissions for role details.

​
Opening the agent

There are two surfaces, both backed by the same agent:
  • The chat workspace — the dedicated full-height chat at /chat, with the workspace panel beside it.
  • Ask Nudj — the persistent chat bar at the bottom of the admin. Contextual pages can open it pre-loaded with what you’re looking at.
The agent picks up your active organisation and community from context automatically — you never paste IDs.

​
The workspace panel

Next to the chat sits a panel with four tabs. Open it from the top-bar toggle or when the agent surfaces something.

Preview

A live widget preview the agent drives as it works — see changes land in the real member experience.

Inventory

Everything created or changed this session, grouped by type, so you can review the run at a glance.

Brand

Your Brand Memory — the company background, voice, and rules the agent writes from.

Guide

The Setup Guide — press Start on any onboarding task and the agent walks you through it. See Chat Setup Guide.
You can expand the panel to full width when you want to focus on the preview, and drag the divider to resize the split.

​
Live widget preview

The Preview tab renders the actual Nudj widget — pixel-identical to what members see on your storefront. The agent navigates it for you: ask it to build a challenge and the preview jumps to show it. The preview is also interactive. From any section in the preview you can:
  • Edit the section in a focused, tabbed editor (Content / Layout / Style).
  • Move a section up or down.
  • Hide a section.
  • Ask the agent about a section — sends a section-scoped message into the composer.
Because the agent and these controls write to the same community theme, you can mix approaches: ask the agent to restyle a section in words, then nudge one exact colour by hand. See Widget Section Theming.
Attach what you’re previewing to your message — the composer can carry the current preview context to the agent so it edits exactly what you’re looking at.
When the agent reads or writes your data, it renders a tool card in the conversation — a compact summary of what it did (a challenge it created, rewards it listed, stats it pulled). Cards for entities carry deep links: jump straight to Preview the item in the panel or Edit it in the admin.

​
Prompt queue & steering

You don’t have to wait for the agent to finish before lining up the next step.
  • Queue follow-up instructions while the agent is working — they run in order, and the queue pauses on any step that needs your approval.
  • Steer mid-run — send a priority message that interrupts the current step and jumps the queue when you need to correct course immediately.
The queue shows each item’s status (queued, running, waiting for approval, sent, failed, or cancelled), so a long build is easy to follow.

​
Image generation

Ask the agent for artwork — a challenge banner, a reward image, brand imagery — and it generates it. Image generation runs asynchronously: the agent keeps working while images render, then attaches the finished image to the right entity automatically. You choose which image model the agent uses in the chat’s image model setting; it’s saved per community.

​
Session summary

A session summary tracks the run: what’s been created, the setup-guide progress ring, any web sources the agent cited, and the live queue. Pin it beside the chat or open it from the top bar.

​
Voice mode

Hit the microphone button to talk to the agent instead of typing.
  • Provider: ElevenLabs Conversational AI (real-time, bidirectional).
  • Auto mode: the mic stays hot and detects when you’ve stopped speaking.
  • Push-to-talk: hold the spacebar or the PTT button to speak, release to send.

​
Shopify embed — voice popup

Inside the Shopify admin iframe, the browser’s permission policy blocks mic access. Nudj opens a dedicated voice popup window with full mic permissions; it talks to the embed over postMessage, so transcripts and replies flow back into the main chat.

​
Model & reasoning

The agent runs a single model behind a Vercel AI Gateway, so there’s no model to pick for the conversation. What you can tune is the reasoning effort — from none to high — trading speed against depth on harder tasks.
The agent uses MCP (Model Context Protocol) tools to read and write your Nudj data. Tools are scoped to your RBAC role — the agent cannot escalate its own permissions.

​
Theming via the agent

Ask the agent to:
  • “Change the community primary colour to emerald green” — writes directly to the community theme.
  • “Use our display font for headings” — swaps a theme token.
  • “Make the Achievements section feel more premium” — restyles that widget section.
Every change lands in the live preview. See Branding & Appearance and Community Branding.

​
What the agent won’t do

  • Launch content without confirmation. Drafts save, but the agent asks before flipping status to Live.
  • Mutate sensitive data without approval. Destructive actions and Brand Memory writes pause the queue for your confirmation.
  • Assign or escalate roles. Role management is admin-only in settings — not agent territory.
  • Act outside your RBAC role. A Viewer asking the agent to “create a challenge” gets a polite refusal.

​
Troubleshooting

Popup blockers interfere with the voice popup. Allow popups from your Nudj Admin domain (including any custom admin domain your org uses).
You’re in Planner mode. Check your role in Settings → Team Members — Managers and above get Builder access.
Switch community in the top-nav dropdown, then reopen the chat. The agent picks up the active community from context.
The live preview needs the widget configured for the selected community. Work through the widget task in the Chat Setup Guide first.