# How to Create NPCs and Assign AI Agents in Your World

1\. Open Settings

Click the ⚙️ Settings button on the left side of your screen to enter customization mode.

<figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXcdwrziPFoyvdu-mDg4sXBJ6yx6vpaNb4Ty1bNlaa8GxO_WXUvPVdq7MPsj8lKSu2u2pWtqiQVpoN_lo9YK0SwfkAvfpGN-NPSKqyOufqSeM_0c2-LX6aKHxm7H78rYmjNm--zMmA?key=-wGw7N-MvqHKuRIj2q9gcA" alt=""><figcaption></figcaption></figure>

✅ 2. Click "Add NPCs"

In the Settings panel, click the “Add NPCs” button to begin placing a new NPC.

<figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXcEstw0u8d989ZMuVW8iA8Pkmt2GE4VGpqJkD-ZAowhTuPkvNOa9war4uGReRtIgTdIrl32yJNQ0LBwg19-NsvPMqnes6Cpi_wJu5ZOjHn1naYxbShWKAYeJ9w3mOjfrG7a3olrcA?key=-wGw7N-MvqHKuRIj2q9gcA" alt=""><figcaption></figcaption></figure>

✅ 3. Set NPC Name and Appearance

Type the name of your NPC in the field at the top (e.g., “Intern”).

Then click one of the avatars to choose the NPC's appearance.

<figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXeVDbS239eS7HFYp9HpuI05fGtycWvgoVVs1N6e6nHd6KoW3-QyfPWC-U8j36TFxKsJXS_MwJHv6KjnrZF6YGRvXqpTEstBFi-dywpcnlXEVwfNmrKinZv_WP_vUEf8zfKzIvQvBA?key=-wGw7N-MvqHKuRIj2q9gcA" alt=""><figcaption></figcaption></figure>

✅ 4. Place the NPC on the Map

Move your mouse to the spot where you want the NPC to appear.

👉 Left click to place the NPC.

<figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXcGdnT-r7ZHigrihMi9rLobXb5cBkDwIpmeDnmnRJfpsrb9SwUVhRvsuBtW3ktXluB-r_5p6-q_dkEnjeQTm9dRwqhaje52CZC1pVVjHnfXGHiXEgd8zNHFc9i1r9cTz3QOmYjCww?key=-wGw7N-MvqHKuRIj2q9gcA" alt=""><figcaption></figcaption></figure>

✅ 5. Save Your Changes

Once the NPC appears in your world, click “Done” at the bottom of the screen to save.

<figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXfGvoBNAkfd75HcgovRQNlkxelDJqX_9GfwGfz6f7Ynvfqe3jZ1jRSxdwoSQgpYu_a_gUjbeu-Ga3T51xBM5pZ7Wfky2y6vUl6OYjACPatwTCpw8brS3Al6UuCxgXxagF0MCuPI?key=-wGw7N-MvqHKuRIj2q9gcA" alt=""><figcaption></figcaption></figure>

🤖 Now let’s connect this NPC to an AI Agent who will talk to users!

✅ 6. Open Metaverse Settings\
Click the gear icon on the left sidebar to go to your World’s Metaverse Settings.

<figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXflct9Z6piE43ZAkNWnM4Ox07KFU0E3udRseEbnxX-b5xEiTN-2_nqwzCCGGixNNoxFFDRSlLGpsqsGcu8cNYAtMzXqBDZdnox4Rzr4Ct_VAKfkRIHdCP8wDES_ZzvMyBEv5knreg?key=-wGw7N-MvqHKuRIj2q9gcA" alt=""><figcaption></figcaption></figure>

✅ 7. Go to “Agent Setting” Tab

At the top of your dashboard, click the “Agent Setting” tab.

<figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXfi0paOJ3Ww0sY5oRhQJv8uDb7TlcjoYxXnZUSheH7sPrqTqhcBsp1WNGH_Y4eCo2w7qg0eOu6oUQwlLQCg-q4kAND2_YCzGvpMJZjHwuH7XAombjEawHZQq-4nNDktfzhSHlMqyw?key=-wGw7N-MvqHKuRIj2q9gcA" alt=""><figcaption></figcaption></figure>

✅ 8. Click “Create AI Agent”

Click the “Create AI Agent” button to start designing the AI for your NPC.

<figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXf-rBHF4EdnxIv824PkLTB0V5GQCYDlHE_hGZffsqeFlWNoJi53UfA7Q7w2Sc3AvPjjaoQc6ro2ddtbkojloMWxfjeN1H40VH3IUoFNiytePoa-e4Z_b-J3j9GN6ykbx5zOb6kMpQ?key=-wGw7N-MvqHKuRIj2q9gcA" alt=""><figcaption></figcaption></figure>

✅ 9. Fill in AI Agent Details\
Complete the following fields:

* Name: Use the same name as your NPC (e.g., Intern).
* Position: Add a role title (e.g., Intern, Mentor, Guide).
* Appearance: Describe the look (e.g., “White cyborg with glasses, animated style”).
* Click Generate Image or upload your own.

<figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXcvurGQQ2-hnMWXDY_XjHVtoOZKrdPrlE4m1BARZBLjeDRM815Ig-9fh_flfmgzJSQLrTwJEtv1AT-SNV21CZnJu79susdmAHcNQ2zFjpSpwUhUiWgGfy7CAv2rHU-BxjBx07DuEw?key=-wGw7N-MvqHKuRIj2q9gcA" alt=""><figcaption></figcaption></figure>

✅ 10. Assign to NPC

Click “Choose your NPC” and select the World and NPC name you previously created.

<figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXcjLMV-7ngDBNsEkXnLAw_Fen9aJ7g9y06Kct_HvejAFUg754rPXCb9r_qj_KAAbMRfRFVyeEKKprsqgTdJMprSNjA83vpe9yaxeC5ahaCQHNarBcTk0P_VBNpK-6_Shj9IBTQkyg?key=-wGw7N-MvqHKuRIj2q9gcA" alt=""><figcaption></figcaption></figure>

✅ 11. Define Behavior & Communication

* Instructions/Backstory: Describe the AI’s purpose (e.g., “You help users understand the metaverse and answer questions about quests.”)
* Personality Traits: Add traits like Friendly, Curious, or Funny.
* Communication Tone: Choose tone styles such as Formal, Enthusiastic, etc.
* Click the pink “Save” button to confirm and create your AI Agent.

<figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXcMAY5Xt0zPBQfaV5_Q7LZFe8ucVBJisxagVnIFAknoi61c0kqYGilbo_Zw4ntr-z0Wy90kBdTYLCyMSuDvxc2Pfv-48wZ6TVKxRQuELDx04oreSZ-GSttiSvOh4jqvM8tf8XFaPQ?key=-wGw7N-MvqHKuRIj2q9gcA" alt=""><figcaption></figcaption></figure>

🧠 Your NPC is now connected to an AI!

<figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXcFFemkT-54QY8FkXLso9d0ETyn5gNxHtMrjZp5cLs3VUmMnhHfz1ggu0jXuUM2o2SwHaJQftN0OcK13KYMZg-z9_LA504MIE9Q6v-YninFmdaj0hf3jrZu7YsRIyplHLs7Ia_dhQ?key=-wGw7N-MvqHKuRIj2q9gcA" alt=""><figcaption></figcaption></figure>

🏃 What happens now?

When someone clicks or taps on the NPC in your world, the AI Agent will start a conversation!

They’ll respond with the tone and personality you defined in the Agent settings.

<figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXffFKd-rO7NCB2-gTwsTxO-GMC60Tjjej-ou-Lq7-EC6a4-4ZjEL-RMb0Zn0LLJCBbZGyFLBtZ22-8R0mMvxmRe0oDnOX7iJ3Wl6j2LKAeG05pOOdxLMQ8T4p0IWZC8-TsG3EE8aw?key=-wGw7N-MvqHKuRIj2q9gcA" alt=""><figcaption></figcaption></figure>

✏️ Need to update it later?\
You can always return to Settings → Agent Setting to edit the agent’s behavior, backstory, or appearance.

🎉 All set!\
You’ve just brought your NPC to life with a fully interactive AI agent — ready to greet, guide, and support your visitors!


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://metaversenw.gitbook.io/user-manual/metaverse-customization/how-to-create-npcs-and-assign-ai-agents-in-your-world.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
