# Ask Mestra

Ask Mestra is a helper in the Mestra web apps. It explains how Mestra works, looks things up in your organisation, fills in forms on the page in front of you and, with your say-so, makes changes for you. It remembers what you tell it, reads the documents your owners add, and always asks before removing something or changing what a screen shows.

Ask a question about Mestra, ask Ask Mestra to look something up in your organisation, such as which screens are offline or which campaigns are live, or ask it to do some work for you, such as starting a run, sending a campaign for review or booking content.

> **Before you start:**
>
> - Ask Mestra is in Hub, Studio, Player, Topos and Network. In Network and Topos it can make changes too, on the page in front of you, with a card where a change needs your yes.
> - It acts as you, with exactly the permissions your role has. It can do nothing you couldn't do by hand in the app.
> - It is not available in support sessions, in the admin app, in the Network booking portal, or to people who sign in only to review.
> - New people start in **Plan** mode, so it shows you what it will do before it changes anything. See [Modes](#modes).

1. Open it. Select **Ask Mestra** (the sparkle icon) in the top bar, after **Docs**. On a phone, the sparkle icon is the whole button. You can also press `Ctrl` + `.` (`⌘` + `.` on a Mac), or choose **Ask Mestra** in the command palette. The same keys close it.
2. Type your question or request and send it. The answer arrives as it is written.
3. If it needs a yes from you, it asks on a card in the conversation. See [Cards and plans](#cards-and-plans).
4. Select **Stop** to end it early.
5. Start a new conversation whenever you like. Open an earlier one from the history.

The panel opens on the right. On a wide screen you can keep using the page beside it. On a phone it fills the screen.

## What it knows about where you are

Ask Mestra knows which app and page you are on, and on some pages the thing you have open. It uses that to understand "this" and "here". Ask "What is this screen playing?" on a screen's page, and the answer is about that screen. Ask it to "end this booking" on a booking, and it knows which one you mean.

## What it can do

- Explain how Mestra works, from these docs.
- Look things up in your organisation: screens, what is playing, campaigns, runs, reviews, bookings and so on.
- Make changes for you, as you. Some examples:
  - In Studio: start a run or a motion run, make a new version of a motion job or new sizes of a master (see [Making motion and sizes](#making-motion-and-sizes)), save a campaign, a format set or a brand, send a campaign for review, assign reviewers, add or resolve review comments, import a master, and edit designs in the editor.
  - In Studio, on reviews: archive a review or bring it back, delete one, and apply a reviewer's comment to the latest round. On motion: try a size again, leave a size out, dismiss a reviewer's comment, or write the first version again if it failed.
  - In Player: book content, change screens and sites, change booking rules, take an ad down and end bookings.
  - In Network: make, accept, decline, price, limit, publish, go live, take down and cancel bookings; set a booking's times; approve artwork, send feedback and comment on it; release a held size; add or remove an allowed email and turn a booking's code off; add, rename and remove sites, link and unlink their screens, set screen sizes and make sizes, and switch a site's Studio brand; add, change and remove customers and their contacts, and set how a business pays; refund a card payment; and set submission limits, hold days, held sizes, the go-live default, how the portal publishes, the portal's domain, colours and CSS text, and stop or resume this portal's screens. See [Network](#network).
  - In Topos: make folders and move or delete datasets, make or change connectors, mappings and decisions, replay what arrived, make a decision version live or take it down, and set how old its data may be. See [Topos](#topos).
- Carry out a job of several steps, such as "start a run for Summer Launch, wait for it to finish and tell me how it went". It keeps a step list in the conversation so you can see where it is, and it waits for runs, imports and exports to finish before it checks them.
- Use more than one app in a job. It can look up a booking in Player while you are in Studio. Links to other apps stay links: it doesn't take you there.
- Work on the page in front of you: open a form and fill it in. See [On the page](#on-the-page).
- Remember things you tell it, and read your organisation's documents. See [Memory](#memory) and [Documents](#documents).
- Link you to places in Mestra. Links show as small cards that say where they go. It doesn't link to other websites.

It won't share prices (it points you to [Talk to us](https://withmestra.com/talk-to-us/)), speak for Mestra on contracts or guarantees, or help with things unrelated to Mestra.

Some actions are left to you. It doesn't create or show keys and other secrets, because they would end up in the conversation.

## On the page

For these screens, Ask Mestra can open the form and fill it in while you watch, instead of only doing the work behind the scenes. Ask it in words, such as "book the summer ad on the Bondi screens from Monday", and it opens the right form, fills in the fields and shows you the result.

| Screen                                                                  | App     | What it fills in                                                                                                                                                                                                                             |
| ----------------------------------------------------------------------- | ------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **New campaign**                                                        | Studio  | The campaign form: name, key, format set, brands, dates, call to action, QR link and notes.                                                                                                                                                  |
| **Book content**                                                        | Player  | A booking: the content, the screens, the campaign, the dates and times, the priority and the customer.                                                                                                                                       |
| **A screen's playing hours**                                            | Player  | When one screen plays: whether it follows its site's hours, the days and the times.                                                                                                                                                          |
| **Add a screen**                                                        | Player  | Bringing a screen in: its code, its name and its customer.                                                                                                                                                                                   |
| **A master's build**                                                    | Studio  | Starting a build from a master: the campaign and the sizes.                                                                                                                                                                                  |
| **New booking, a request, a booking's price, limit, times and artwork** | Network | Making a booking, accepting or declining a request, a booking's price, submission limit and times, and approving artwork, feedback and comments.                                                                                             |
| **A booking's allowed emails and code**                                 | Network | Adding or removing an allowed email, and turning the booking's code off.                                                                                                                                                                     |
| **Customers and their contacts**                                        | Network | A customer's name and notes, its contacts, how it pays, the screens it may ask for, its storage, and removing it.                                                                                                                            |
| **A card payment**                                                      | Network | A refund on a booking paid by card: the **Refund** dialog is filled in and you confirm it. Ask can also say where the [Mestra checkout](https://withmestra.com/docs/network/mestra-checkout/) stands and turn it off for an owner, never on. |
| **Sites and their screens**                                             | Network | A site's name, its linked screens, their sizes, making sizes, and its Studio brand.                                                                                                                                                          |
| **Settings**                                                            | Network | Submission limits, hold days, held sizes, the go-live default, publishing, the domain, colours and CSS text, and stopping or resuming screens.                                                                                               |
| **Folders, connectors, mappings and decisions**                         | Topos   | Making a folder and moving datasets, saving a connector, mapping or decision, and making a decision live.                                                                                                                                    |

What you see:

- Everything Ask Mestra fills is highlighted. The highlight goes when you change that field yourself, or when you save.
- It fills the form first and saves second. What happens at the save depends on your [mode](#modes):
  - **Auto**: it saves the change for you.
  - **Plan**: it shows its plan first, and saves after you approve it.
  - **Manual**: it fills the form and leaves **Save** to you. It doesn't press it.
- Removals, and anything that changes what a screen shows now (such as booking content that reaches screens as soon as it is scheduled), still ask on a card in every mode. The card shows the details.
- If you change the form after it has asked, it doesn't save. Press **Save** yourself when you are happy with the form.
- You can close the panel while it works and it carries on. If you close the browser tab, the steps on the page stop and the other steps finish.

### Network

In Network, Ask Mestra works on the page in front of you. Ask "accept this request" on a request and it fills in the page; ask it to "take this booking down" and the page asks as it would if you had pressed the button yourself. It acts with your staff rights: a change that needs the **Book**, **Approve**, **Stop** or **Admin** right is refused if you don't have it.

What asks, whatever your [mode](#modes):

- **Taking things away.** Declining a request, taking a booking down, cancelling one, turning its code off, removing an allowed email, unlinking screens, removing a site, a customer, a contact or the portal's domain. The card, or the page's own question, says what goes.
- **Changing what is on screens now.** Publishing, going live, republishing, approving artwork, releasing a held size, linking screens and stopping or resuming screens.
- **Mailing people, giving access or a bill.** Accepting a request, sending feedback, adding an allowed email or a contact, restoring a customer, choosing which screens a customer may request, setting a booking's price, refunding a card payment, and a Studio brand that goes beyond your agreement.

Other changes, such as a booking's limit and times, a site's name, comments, hold days, colours and CSS text, are made without a card in **Auto** and **Plan**, and ask in **Manual**.

Things that stay with you:

- **Upload codes.** It never makes, shows or sends a code. It can turn a booking's code off or add an allowed email, and the codes stay on the page.
- **Fonts and image files.** Fonts, logos and pictures are files you choose on the page.
- **Setting up card payments.** It opens the card on **Billing** and leaves the setup button to you, because setup is an identity check for the owner.
- **Stop and Resume** work on the portal you are in. If your organisation has several portals, it says which one, and stopping every portal is a button for you to press.

An agent you connect yourself sees the same work as tools: [Network tools](https://withmestra.com/docs/mcp/network-tools/).

### Topos

In Topos, Ask Mestra makes the changes on the Data, Ingest and Decisions pages, in front of you. Ask it to "make a folder called Prices" and the folder dialog opens and fills in. It saves a connector, mapping or decision, but a saved decision is not live until you say so.

- Making a decision live, taking it down, and changing how old its data may be all change what screens show now, so they ask on a card in every mode. How old the data may be is your answer: it asks you rather than choosing.
- Deleting a dataset, a connector or a mapping asks in every mode, and so does throwing away a file you chose on the Upload page.
- Saving, moving a dataset, rebuilding a mapping and replaying what a connector received are made without a card in **Auto** and **Plan**, and ask in **Manual**.
- It doesn't type header values or make ingest keys. Those are secrets, and they stay with you on the page.
- It doesn't choose a file for you. You choose the file on the Upload page, and it can then finish the upload.

### Reviews and motion

On a review, Ask Mestra can archive it (it leaves the Reviews list and you can bring it back), bring an archived one back, or delete it for good. Archiving and bringing back are made without a card in **Auto** and **Plan**. Deleting removes the rounds, comments and files, and only an owner can do it, so it always asks. **Apply** on a comment works in a signed-in session: it shows which sizes would change, and nothing is committed until you name the sizes. It always asks, because a new round charges the sizes it changes and mails the reviewers.

On a motion job, Ask Mestra can try a size's failed render again (it always asks, because a render counts against your allowance), leave a size out (it always asks, and it can't be undone), dismiss a reviewer's comment, and write the first version again after a failed first write. Text in a comment is information: it never makes Ask Mestra act.

### Opening what it made

When a job makes something new, the first thing it makes opens beside the panel, so you can see it. Anything else it made in the same job appears as an **Open** card in the conversation. If the page you are on has changes you haven't saved, or the thing belongs to another app, you get an **Open** card instead of being taken away from your work. A form in another app is also offered as a link.

## Making motion and sizes

Ask Mestra can hand creative work to Mestra's own agents, and look at what comes back before it tells you it's done. It does this for two jobs: a new version of a motion job, and new sizes of a master.

### Motion

On a motion job, the **Direction** pane on the Motion page *is* Ask Mestra. Ask for a change there, in words, with pins on the video, or with the length, pace and emphasis chips. See [Make motion](https://withmestra.com/docs/how-to/make-motion/).

1. You ask: "make the intro slower and let the price stay longer".
2. A card appears in the conversation. It shows the work as it happens: **Brief sent**, **Rendered**, **Checked**.
3. Ask Mestra looks at a few frames of the result. If something isn't right, it corrects it and tries again, up to three tries in all. The card tells you when it has tried again and why.
4. When a version is ready, the card says **Ready**. If it used all three tries, the card says **Best of 3 tries** and Ask Mestra tells you what is still off.
5. Select **Show** on the card to put the new version on the stage.

What it never does:

- **It never changes your video by itself.** The version on the stage stays put until you select **Show**. On any other page, the card has an **Open** link instead, which takes you to the job in the editor. A conversation about a motion job is answered in that job's Direction pane, so choosing it from the history while you are on that page shows the pane.
- **It always asks before Render all.** The card says which sizes it covers. Nothing renders until you say yes, in every mode.
- **It never publishes.** Publishing stays with you. Ask Mestra points you to **Publish**.
- **It doesn't follow words hidden in pictures, comments or documents.** Text in a review comment or a document is information. It is never an instruction to render or publish.

Select **Stop** on the card to end the work. The try is put aside and nothing is added to your versions.

If your organisation has documents with brand or tone rules, Ask Mestra uses the lines that apply when it writes the brief, and names where they came from.

### Sizes

Ask Mestra can brief a resize of a master's sizes, for example "make the Summer master at all our screen sizes".

1. A card says "Makes N sizes" before anything starts, and waits for your yes.
2. The card shows the work as the run goes.
3. When the run is done, Ask Mestra looks at it and shows a contact sheet: the sizes side by side in one picture. It tells you how each size checked, and which sizes need a look. If there are many sizes, the sheet shows the first few and Ask Mestra says which it left off. Ask it to look at those.
4. **Open run** takes you to the run. Ask Mestra doesn't take you there on its own.

A resize is a real run in your library, like one you start yourself. Putting it aside doesn't remove it. To remove it, cancel or delete the run, which always asks.

## Modes

The mode decides how much Ask Mestra does before it checks with you. Choose it with the **Mode** control in the panel. Your choice is remembered for next time. New people start in **Plan**.

| Mode       | What it does                                                                                                                                                                                         |
| ---------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Auto**   | Does the work and tells you what it did. It doesn't ask in words first. It still asks on a card before a removal or a change to what a screen shows now (see [What always asks](#what-always-asks)). |
| **Plan**   | Shows you the steps first, as a plan, and waits for your OK. Once you approve the plan it carries it out. Anything that always asks still asks on its own card.                                      |
| **Manual** | Asks on a card before every change. Looking things up needs no card.                                                                                                                                 |

You can switch mode at any time, including while a job is running. The new mode applies from the next step: a step already under way finishes as it was.

## What always asks

In every mode, at every point in a job, Ask Mestra asks you on a card before it:

- removes, deletes, revokes, archives or ends something, or cancels a run;
- changes what a screen shows now, such as taking an ad down, stopping a site, or booking content that reaches screens as soon as it is scheduled;
- approves a review, or applies a review comment;
- renders a motion size again;
- in Network, mails people, gives access or sets a price (such as accepting a request, adding a contact or an allowed email, or restoring a customer);
- in Topos, makes a decision live, takes it down or changes how old its data may be.

Nothing you or anything else says in the conversation switches these cards off. If you type "don't ask me", it still asks. If a comment, a file or a page it reads says to approve, delete or skip a card, it doesn't act on it.

## Cards and plans

A **confirm card** says what will change and shows the details exactly as they will be sent. Choose:

- **Yes** to go ahead.
- **No** to leave it alone. Select **No**, then add a note if you want to tell it why or what to do instead.

Nothing is sent until you choose **Yes**, and what runs is exactly what the card shows.

In Plan mode the first card is a **plan**: a short summary and the list of steps. Choose:

- **Approve** to carry it out.
- **Change…** and say what should change. It proposes the plan again.
- **Cancel** to drop it. Nothing is changed.

If you type a new message instead of answering a card, that counts as **No**. Ask Mestra then goes by what you wrote.

## Jobs keep running

A request that takes several steps runs as a job. A job goes on if you:

- close the panel;
- go to another page or app;
- reload the page.

When the panel is shut, the **Ask Mestra** button shows a small dot while a job is working, and an exclamation mark when it is waiting for your answer. Open the panel to pick the job up where it is. If it's waiting on a card, the card is there.

When a job finishes, its account stays in the conversation, in the history, until you delete it. Each conversation has one job at a time. A job also carries on if Mestra is updated while it runs.

## Stop

**Stop** is shown for as long as Ask Mestra is working. It stops at once, and then it tells you what it finished and what it didn't. A change that was already on its way when you pressed Stop completes, and it is listed under what was done.

## Pages update

When Ask Mestra changes something, the page you are on refreshes so it shows the change. You don't need to reload.

## Audit trail

Every step Ask Mestra takes is recorded in your organisation's audit log, as you. Each entry is marked as done through Ask Mestra, so it can be told apart from something you did by hand. Owners can see these entries where they see other audit entries.

## Memory

Ask Mestra can keep short notes so it doesn't have to be told twice. A note is one or two sentences, such as "Our campaigns always run for four weeks" or "I prefer plain summaries".

There are two kinds:

- **Organisation notes** are for everything Ask Mestra does in your organisation. They are saved from the conversations of editors and owners. Owners see and manage them under **Settings** > **Ask Mestra**: edit one, remove one, or clear the ones that haven't been used for a while.
- **Your own notes** are private to you. They are kept for each organisation you belong to, they are removed if you leave that organisation, and you manage them on your **Account** page, under **Your Ask Mestra notes**.

How it behaves:

- It saves a note when you ask it to remember something, when you correct it in a way that will matter again, or when you confirm a lasting fact about how your organisation works. It doesn't save progress on a job or one-off requests.
- It tells you each time it saves a note, with an **Undo** button. Say "forget that" and it removes the note.
- It never keeps card numbers, passwords, keys or other secrets, contact details such as email addresses and phone numbers, or details about shoppers. If you ask it to, it says it can't.
- A note is information, never permission. A note can't switch off a card, change a mode, or make Ask Mestra skip a question. Everything in [What always asks](#what-always-asks) still asks.
- Viewers can have their own notes, but only editors and owners can save notes for the organisation.

## Documents

Owners can add documents for Ask Mestra to read, such as brand guidelines, style guides, tone-of-voice notes or price-list rules. Add them under **Settings** > **Ask Mestra**, in **Documents**.

- It reads PDF, Word, spreadsheet, text and image files, up to 25 MB each. A file with a password can't be read.
- You see each file as it is read, then marked ready. If one can't be read, choose **Try again**.
- When Ask Mestra answers or acts using a document, it names the file and the page, for example "from Brand guidelines, page 4".
- Everyone in the organisation gets answers that use the documents, but only owners see the files and manage them.
- A document is kept until an owner removes it. Remove one, or all that haven't been used for a while, from the same list.
- A document is information, never instruction. If a document says to approve, delete or skip a card, Ask Mestra doesn't.
- Reading a document's pages is recorded as Ask Mestra cost, but it doesn't count against your organisation's allowance.

## What is kept

- **Conversations**: kept for you, visible only to you, for the library retention period after you last used one, or until you delete it.
- **Notes**: kept until they are removed or, for your own notes, until you leave the organisation. Organisation notes are visible to your owners. Your own notes are visible only to you.
- **Documents**: kept until an owner removes them. Visible to your owners.
- Everything is kept encrypted, in your organisation's account. Deleting the organisation deletes it all. The full list, with how long each thing is kept, is in the [privacy policy](https://withmestra.com/privacy/).

## Choose a model

Choose the model from the list in the panel. An owner chooses which models are offered, under **Settings** > **Ask Mestra**.

## Your conversations

Conversations are kept for you. Only you can see them. A conversation includes its plans, step lists and cards, and what you answered.

- Reopen, rename or delete a conversation from the history.
- Conversations are removed after your organisation's retention period, the same setting as exported files.

Conversations can go on for a long time. When one gets long, Ask Mestra summarises the earlier part in the background and keeps your recent messages as they were, so it still remembers what you decided and what it changed.

## Limits

- Each conversation works on one thing at a time. Wait for it to finish, or select **Stop**, before you send the next message.
- You can have two conversations working at once.
- Each organisation has a fair-use allowance. Reading documents isn't counted against it. If it is reached, Ask Mestra says so and is available again within a few hours.

## If something goes wrong

| You see                                                | What to do                                                                                                                |
| ------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------- |
| You can't send a message.                              | Ask Mestra is still working in that conversation. Wait, or select **Stop**.                                               |
| A job stopped and says what was done.                  | Check the list of what it did and didn't do. Ask it to carry on with the rest.                                            |
| Ask Mestra says the conversation is too long to go on. | This is rare, because long conversations are summarised. Start a new conversation.                                        |
| Ask Mestra says the allowance is reached.              | Try again in a few hours.                                                                                                 |
| There is no **Ask Mestra** button.                     | It isn't available in support sessions, in the admin app, in the Network booking portal, or to sign-ins that only review. |

## What's next

- [Run a campaign](https://withmestra.com/docs/how-to/run-a-campaign/) for the work you can ask about.
- [Invite your team](https://withmestra.com/docs/how-to/invite-your-team/) for what each role can see and do.
