Setting Up Your First Operator

📋 Requirements

Before you begin, ensure you have:

1. A MelodyArc Account
   You’ll need access to the MelodyArc portal.

2. An Organization with the Base Set Installed
   This ensures your workspace includes the foundational components required for importing operator point sets.

🎯 Objective

In this guide, you’ll set up your first MelodyArc Operator — a conversational Chat Operator.
This operator enables real-time conversation with users through the MelodyArc chat interface.

By the end, you’ll have a working operator, ready to respond to messages sent via @chat.

🧩 Step 1 — Access the Operator Point Set

1. Navigate to the GitHub repository:
   👉 Chat operator set

2. Review the README.md file in the repository.
   Note that the required unique operator name for this point set is chat.

3. Inside the 1.0.0 folder, open the chat_operator_set.json file.
   Copy the entire JSON content — you’ll use it for import shortly.

⚙️ Step 2 — Import the Operator Points

1. Go to your MelodyArc Portal.
2. Click on the Expert tab in the left navigation bar.

3. At the top of the screen, locate Point.
   Next to it, click the three vertical dots (⋮) menu.

   

4. Select Import Points.

5. In the import from JSON box:

• Paste the copied JSON from GitHub into the text box.

• Click Next to review the import.

  

6. Review the list of points that will be added to your organization.
7. When satisfied, click Save.
   ✅ The Chat Operator Point Set is now imported.

🤖 Step 3 — Create the Operator

1. From the left navigation, click Operators.

   

2. Click the Create button.

3. Enter the following details:

• Friendly Name: Buddy or any name you would like. (This is the display name users will see.)
• Unique Name: chat
  (This must match the requirement from the GitHub README.)

4. Leave other options at their default values.
5. Click Next, then Create.

🎉 Congratulations — your Chat Operator is now set up!

💬 Step 4 — Start a Conversation

1. Return to the main chat page in the portal.
2. In the chat input bar, type @chat:
3. Follow this with your message — for example:
4. Your new operator will respond and engage in conversation.

Enjoy interacting with your first MelodyArc Operator!

✅ Summary