Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.nudj.cx/llms.txt

Use this file to discover all available pages before exploring further.

The Nudj Agent is a conversational AI co-pilot that plans, creates, and edits your content. It can draft challenges, reward allocations, achievements, and posts, and it can tune branding (colours, fonts, copy) through natural-language conversation. Below is how to use it effectively and what it can (and can’t) do.

​
Two agent modes

ModeWho sees itWhat it can do
PlannerEveryone (incl. signed-out users and Viewer/Moderator roles)Answer questions, draft ideas, read platform data (list/get)
BuilderManager, Admin, and SuperAdmin rolesEverything Planner does, plus create, update, delete on challenges, rewards, achievements, posts, and communities
The agent derives your mode from your RBAC role — no manual switch. Viewers/Moderators stay in Planner mode; Managers and above get full Builder access. See Roles & Permissions for role details.

​
Opening the agent

Click the AI button in the admin top nav, or open the chat panel from any admin page. The agent has access to your current organisation and community context automatically — you don’t paste IDs.

​
Slash commands & templates

Type / to surface the template menu:
Draft a new challenge. The agent asks for the goal, format, action count, and reward budget, then proposes a full challenge (title, description, actions, distribution).
Draft a reward. The agent walks through type (Asset/Entry/Points/XP), allocation supply, redemption config, and advanced options.
Propose an achievement with event criteria.
Draft a feed post or update.
Tune colours, fonts, and copy. Works against both org-level and community-level themes.
The agent shows a Continue button after long steps so you can easily resume the conversation without typing “continue”.

​
Models

The agent runs behind a Vercel AI Gateway. The current active model is Moonshot Kimi K2.5 — a strong reasoning, coding, and agentic model. Additional model routing is planned; for now a single model is used behind the gateway.
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 permissions.

​
Voice mode

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

​
Shopify embed — voice popup

When you run Nudj inside the Shopify admin iframe, the browser’s iframe permission policy blocks mic access. Nudj sidesteps this by opening a dedicated voice popup window with full mic permissions. The popup talks to the embed over postMessage — transcripts and AI replies flow back into the main chat.

​
YouTube & integration tools

When you ask the agent to build a video-driven challenge, it can fetch channel metadata, thumbnails, and video lists via the built-in YouTube MCP tool. It can also wire up:
  • Video action configuration for admin-UI video challenges (see Video Challenges).
  • Reward allocations tied to the video action.
  • Thumbnail + description prefilled from the YouTube API.

​
Theming via the agent

Ask the agent to:
  • “Change the community primary colour to emerald green” — writes directly to the community theme.
  • “Use Kaufland Sans as the display font” — swaps a theme token.
  • “Make the challenge complete screen more celebratory” — updates the per-step colour and copy.
Changes show up in the live preview iframe next to the theme editor. See Community-Level Theming.

​
What the agent won’t do

  • Launch content without confirmation. Drafts save but the agent always asks before flipping status to Live.
  • Assign or escalate roles. Role management is admin-only in settings — not agent territory.
  • Delete data without a confirm. Destructive actions always prompt.
  • Act outside your RBAC role. A Viewer asking the agent to “create a challenge” gets a polite refusal.

​
Troubleshooting

Browser 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 community dropdown, then reopen the chat. The agent picks up the context from your active community cookie.