# Tour Guide

## **Introduction**

In this guide, you'll learn how to bring your AI avatars to life by turning them into dynamic tour guides within immersive 3D environments.

We’ll walk you through how to:

* Set up a tour-guide simulation
* Define interaction behaviors
* Add tour points
* Manage the tour flow
* Preview and publish the experience

## Step by Step Guide

### **1. Setting Up Tour Guide Mode**

<figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXfZz05ySedk4Lajg9JYaQUgBQ2qy2tFQ83JsZ_BqPyhU4Z7YXMv8Me9YaZAPbpkGFpWK0RmpFRLa2wetYHvDJcvNlYKupDkpRn0vDrE1oVeGSIQMabaXZYmRxzB3FsxnCGzVBHUjw?key=oE6QAXhDPkZ0WZirjFau9Q" alt=""><figcaption></figcaption></figure>

1. Select your avatar to open the **Edit & Publish** menu.
2. Locate the **Tour Planner Settings** section.
3. Set up your **Tour Prompts** – these define what the avatar says at the start and end of the tour.

**Example Prompts:**

* **Welcome Prompt:**\
  “Hi there! Ready to explore the fire station?”\
  → Greet the user, introduce yourself, and invite them to start the tour.
* **End Prompt:**\
  “That’s the end of the tour. Hope you had fun!”\
  → Ask if the user has any questions, answer them, then say goodbye.

### **2. Defining Behavior**

<figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXcBz2c8r7PObfXZj8jF4cq06K52dgnxZTL9tJXZaE42HckGNu3ki6iEs46-1FxJt6okkfsZ7sq6SeapiYAPjIDwE_Ec-IWnML9f3NMnZ4XBY2r2FFY6o2h5uQyhw6mX2nQPJp3u?key=oE6QAXhDPkZ0WZirjFau9Q" alt=""><figcaption></figcaption></figure>

Choose how your avatar initiates the tour:

* **Wait for Player:**\
  Avatar stays still and waits until the user approaches.
* **Engage on Sight:**\
  Avatar detects the user visually and initiates conversation.
* **Max (Timed Engagement):**\
  Avatar starts interacting after a set period of user inactivity.

### **3. Adding Tour Points**

<figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXevR5D8O-lo8NFR7mcrsGgtBpPleeW7gPblo5wZEb66TZwT6l0tTkw4ZdIUESzOyBJpnLqiwcFdOmfwePyw9OtYrDpGeTz8jT05Mr6d_h4jqzhALdAv367eDoxTRuEasVSAyaBRGQ?key=oE6QAXhDPkZ0WZirjFau9Q" alt=""><figcaption></figcaption></figure>

1. Click **“Add Tour Point”** — a green gizmo will appear in the scene.
2. Use the **XYZ axes** or click the **flag icon** to position the tour marker.
3. Enter a **Tour Point Name** (e.g., “Fire Truck”).
4. Add an **Objective** describing what the avatar will explain or do at this point (e.g., “Describe the fire truck and its role in emergencies.”).
5. Repeat this process to build a full tour path.

### **4. Managing the Tour**

<figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXeOlI3VqyrWMFFXq_U3i58HBkmfH_BkxbWHPuBqxMch0VKszsudh7AM_58GyMtZR_Bw8QEFGkvBp0beMSc0X9L7CWj553ExD6YqkWiDxIFJv8R4bvenIpOtAChAkptyvtZpZ60y?key=oE6QAXhDPkZ0WZirjFau9Q" alt=""><figcaption></figcaption></figure>

* To remove a tour point, click the gizmo and hit the **X icon**.
* Under **User Elements**, click **“Set User Starting Point”** to define where the player begins.
* Click **“Save Narrative Graph”** to save your tour configuration.
* Use **Preview** to test the experience.
* Click **Publish** when you're ready to share your tour.

## **Summary**

Convai Sim’s **Tour Guide Mode** transforms your AI avatar into an interactive, narrative-driven host—ideal for:

* Education & virtual field trips
* Employee onboarding
* Training simulations
* Museum or product walkthroughs

Once your tour is complete, you’re just one click away from publishing it across web, kiosks, and other platforms.


---

# 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://docs.convai.com/api-docs/no-code-experiences/convai-sim-experiences/tour-guide.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.