🎛️ Studio
xMagic Studio is the control room for everything your AI does—from high‑level Agent settings down to Job‑specific tools and quick actions.
Studio Layout​
| Panel | Description |
|---|---|
| Configuration | Create or edit Jobs, attach Tools / Workflows, adjust prompts, set phone numbers, and more. |
| Preview | Live chat that runs the current, unsaved draft. Use the dropdown to test the whole Agent or any single Job. |
Assisted vs Manual​
- Assisted – guided wizard (natural‑language), perfect for first‑time users.
- Manual – full JSON view + advanced toggles, ideal for power users.
Switch modes anytime—the underlying config stays in sync.
Agent‑level configuration
| Setting | What it controls |
|---|---|
| Assistant name & icon | Branding in chat UI. |
| Agent language | Default language for replies. |
| Voice type | Male / Female for TTS channels. |
| Model | Select GPT‑4o, GPT‑3.5, etc. |
| Agent prompt | System message (default: instructs simple Q&A + hand‑off to Jobs). |
| Suggested questions | Clickable chips shown on first load. |
| Welcome message | First greeting your users see. |
| Enable incoming calls | Turns on voice hotline for the Agent. |
| Phone number | Choose a purchased number for voice/SMS. |
| Quick Actions | Shortcut commands linked to a job. |
Quick Actions (shortcut commands)​
- In Manual mode scroll to Quick actions → Create.
- Fill the form:
- Action name – button label.
- Prompt – text sent to the Job.
- Specific Job – (optional) target workflow.
- File attachments – allow users to upload docs.
- Form fields – gather extra input (text or select).
How users experience a Quick Action​
When a user clicks the button, a small form (generated from your fields) pops up:
After they submit, the data is passed to the Job and the chat continues:
After saving, buttons appear in Preview and in the interact page and therefore in production once the Agent is deployed.Job‑level configuration
| Section | Details |
|---|---|
| Job prompt | Core instructions—what the workflow should accomplish. |
| Voice prompt | Personality, tone, length rules, fallback behavior. |
| Enable reasoning | Step‑by‑step explanations & deeper logic. |
| Allow early exit | Users may leave without completing the flow. |
| History limit | Max messages considered for context. |
| Knowledge Base | Attach any Global data folder—or create one in Assisted mode. |
| Phone number | Pick a number if the Job should accept calls. |
| Tools / Workflows | Add built‑ins (QA, Scheduling, Form Filling, Ticket Forwarding, Sheets, Outbound Call) or your own custom Workflows. |
Attached data folders are also visible under the Knowledge tab inside the Agent:
Preview & Test​
- Agent – tests routing + combined logic.
- Specific Job – isolates one workflow.
Input bar anatomy
• 📎 Attach file – upload docs, images, or spreadsheets that the Preview (and the final Agent) can read in‑context.
• 🏷️ Quick‑action chip – appears above the bar when you add a Quick Action; one click injects its prompt.
• 🎙️ Voice button – tap the blue waveform on the far right to dictate; tap again to stop. The assistant transcribes and answers with speech.
Voice mode
The assistant will listen, transcribe, and reply with text‑to‑speech—so you can validate the full audio experience before going live.
---Step‑by‑step Reasoning​
Every assistant reply can include an expandable Reasoning card:
- Assisted mode – shows how the wizard interprets your plain‑language instructions and turns them into Job prompts.
- Preview – displays live execution logs (✔ steps, ⚠ warnings, ❌ errors) so you can verify that the right Job was triggered and finished.
Use these logs to fine‑tune prompts, troubleshoot tool calls, or simply confirm that routing is working as expected.
Save, Deploy, Load​
| Action | Effect |
|---|---|
| Save | Snapshot the draft under a version name. |
| Deploy | Publish the saved version—Interact now points to it. |
| Load | Re‑open any saved or deployed version for edits or rollback. |
Default Tools at a glance​
| Tool | Capability |
|---|---|
| Question Answering | Baseline Q&A engine (auto‑attached). |
| Scheduling | Book and manage appointments. |
| Form Filling | Collect structured data via dynamic forms. |
| Ticket Forwarding | Escalate to live support (email, Zendesk, Slack). |
| Sheets Analysis | Parse & answer questions about spreadsheets. |
Need something custom? Register your own Workflow and attach it like any other tool.
You can make every configuration above in either Manual or Assisted mode, and any change you save is applied instantly.​
That’s everything you need to master xMagic Studio—build, test, and ship conversational AI without leaving this screen.