> ## Documentation Index
> Fetch the complete documentation index at: https://docs.peektag.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Assistant Instructions

> Train the experience agent with clear behavior, tone, boundaries, and goals.

<Frame>
  <img src="https://mintcdn.com/peektag/a3DwInUVlmqQCoKu/images/Screenshot-2026-07-02-091148.png?fit=max&auto=format&n=a3DwInUVlmqQCoKu&q=85&s=3675c5ac769ef60a091fcfc4c9df4792" alt="Screenshot 2026 07 02 091148" title="Screenshot 2026 07 02 091148" style={{ width:"42%" }} width="564" height="362" data-path="images/Screenshot-2026-07-02-091148.png" />
</Frame>

Assistant Instructions help you teach the experience agent how to talk, what to use as context, and what rules to follow when it chats with customers.

Think of this page in two parts:

* **Train the agent** so it remembers the latest experience data.
* **Write instructions** so it knows how to behave during the conversation.

## Train with your latest data

When you click **Train**, PeekTag reads the latest data from the experience.

This can include things like:

* Experience title
* Description
* Menu or product details
* Uploaded content
* Business information
* Metadata
* Settings that help describe the experience

PeekTag then uses that information to prepare the agent, so its answers are based on the latest version of the experience instead of old or missing data.

<Frame>
  <img src="https://mintcdn.com/peektag/a3DwInUVlmqQCoKu/images/Screenshot-2026-06-28-103157.png?fit=max&auto=format&n=a3DwInUVlmqQCoKu&q=85&s=6d00754af0f03334c832ed7f12eb39bd" alt="Screenshot 2026 06 28 103157" width="1614" height="360" data-path="images/Screenshot-2026-06-28-103157.png" />
</Frame>

<Warning>
  Always click **Train** after you update the experience. If you change the title, description, menu, products, files, settings, or any important content, train the agent again so it answers with the latest data.
</Warning>

## Why training matters

If the agent is not trained after an update, it may still answer using older information.

For example, if you update a menu item, change a service description, add a new product, or edit the experience text, the agent needs to learn that new version before customers start asking questions.

A simple rule:

<Note>
  Update something, then train the agent. That keeps the model fresh and avoids outdated answers.
</Note>

## Build instructions

After the agent has the latest data, use **Agent Instructions** to explain how it should behave.

This is where you write the rules the agent should follow during the conversation.

<Frame>
  <img src="https://mintcdn.com/peektag/a3DwInUVlmqQCoKu/images/Screenshot-2026-06-28-103209.png?fit=max&auto=format&n=a3DwInUVlmqQCoKu&q=85&s=5ebe7d630cec80d9629bb0d6c8d741c3" alt="Screenshot 2026 06 28 103209" width="1594" height="682" data-path="images/Screenshot-2026-06-28-103209.png" />
</Frame>

Good instructions tell the agent:

* What role it has
* How it should speak
* What tone to use
* What it should help the customer do
* What it should avoid
* When it should recommend an action
* What it should never guess

## Simple example

```text theme={null}
You are a helpful fashion assistant for this outfit experience. Help customers understand the outfit, explain the style, and guide them toward the next step. Keep answers short, friendly, and practical. Do not invent prices, availability, brands, or product details unless they are included in the experience data.
```

## What to include

<CardGroup cols={2}>
  <Card title="Role" icon="user-round">
    Say who the agent is. For example: fashion assistant, menu guide, booking helper, or product advisor.
  </Card>

  <Card title="Tone" icon="message-circle">
    Tell it how to sound: friendly, premium, simple, expert, calm, playful, or direct.
  </Card>

  <Card title="Goal" icon="target">
    Tell it what the customer should achieve, such as choose an outfit, understand a menu, book a service, or ask for help.
  </Card>

  <Card title="Boundaries" icon="shield-check">
    Tell it what not to say, not to promise, and not to guess.
  </Card>
</CardGroup>

## Good everyday rules

Use plain rules like these:

* Keep answers short and easy to understand.
* Ask one question at a time.
* Do not make up missing information.
* If something is not in the experience data, say that clearly.
* Guide the customer to the next useful action.
* Stay on topic for this experience.
* Match the business tone.

<Tip>
  Write instructions like you are training a real team member. Be clear, simple, and practical.
</Tip>

## When to update instructions

Update the instructions when:

* The business goal changes
* The offer changes
* The tone needs to feel different
* Customers are asking confusing questions
* The agent gives answers that are too long, too vague, or too risky
* You add new actions, products, services, or content

<Warning>
  Instructions and training work together. Training updates what the agent knows. Instructions control how the agent should use that knowledge.
</Warning>
