Skip to main content

đź“– xMagic Glossary of Terms

Welcome to the xMagic Glossary! Use this quick-reference guide to familiarize yourself with the key concepts, UI sections, and controls you'll encounter while building conversational AI on xMagic.

Agent​

The Agent is your primary AI assistant. It answers general questions, maintains conversational context, and routes any workflow-specific requests to Jobs.

Job​

A Job is a focused workflow attached to an Agent—for example, scheduling an appointment or creating a support ticket. Jobs can call one or more Tools (including Custom Tools) to complete their tasks.

Knowledge Base​

A Knowledge Base is the collection of PDFs, spreadsheets, websites, and other reference materials an Agent consults when generating answers. Each Agent has its own Knowledge Base; the Global Knowledge Base holds content shared across Agents.

Tool​

A Tool is an add-on capability such as Scheduling, Form Filling, Ticket Forwarding, or Sheets Analysis. Jobs invoke Tools to perform actions beyond plain Q&A.

Custom Tool​

A Custom Tool is a user-defined integration that extends xMagic beyond the default Tool set. You can register your own service (via MCP servers) and attach it to specific Jobs, allowing the Agent to call external APIs or proprietary workflows unique to your organization.

Organization​

An Organization is the top-level workspace in xMagic. Everything—Agents, Jobs, Knowledge Bases, Tools, billing settings, and member privileges—lives inside an Organization.

  • Single source of truth – Each Organization stores its own data, keeping agents and knowledge bases visible only to its members.
  • Role-based access – Members join as Admins or Members; fine-grained privileges control who can deploy agents, manage billing, or invite users.
  • Shared resources – Phone numbers, Custom Tools, and Global Knowledge folders are configured once and reused by any Agent in the Organization.
  • Centralized billing – Subscription plans, payment methods, and invoices are managed at the Organization level—one bill covers all Agents.
  • Collaboration hub – Conversation logs, tasks, and analytics are aggregated so teams can monitor performance and iterate together.

API Keys​

API Keys are secure tokens that authorize external applications to connect to xMagic. Keep them private and rotate them regularly.

Quick Actions​

Quick Actions are predefined commands an Agent can execute instantly (e.g., “Send pricing sheet,” “Generate reset-password link”), speeding up common tasks.

Channels​

Channels are the communication paths through which end-users talk to an Agent—Web Chat, Email, SMS, Voice, and more.

Conversations​

Conversations are threaded interactions between users and the Agent. Reviewing conversation logs helps you refine answers and measure performance.

Studio Interface Terms​

TermDefinition
StudioThe main configuration workspace for an Agent. Switch between Assisted (natural-language) and Manual modes to edit prompts, add Jobs, and attach Tools.
InteractA live chat area where you test and converse with your deployed Agent. Useful for quick validation after each deployment.
PreviewThe right-hand pane in Studio showing real-time output from the current, unsaved configuration. It lets you observe how your changes affect the Agent or Job before deployment.

Top-Right Studio Controls​

ControlPurpose
DeployPublish the current configuration so end-users can access it.
SaveStore the current draft without deploying; creates a version you can return to.
LoadRestore any previously saved or deployed version to continue editing or to roll back changes.

This glossary will evolve as xMagic grows. For deeper explanations, visit the relevant documentation sections or contact our support team.