Marvis Virtual Network Assistant · Topic 2 of 3
Marvis Queries and the Conversational Assistant
Learn Marvis queries in Juniper Mist: the conversational assistant, its prompts, and Marvis Query Language types such as LIST, COUNT and TROUBLESHOOT.
- 5 min
- Conversational Assistant: Marvis icon, plain language, prompts Troubleshoot, Search, Documentation and Marvis Actions.
- Marvis Query Language: Marvis > Marvis Actions > Ask a Question.
- MQL elements: query type, value, query object, clause, filter type.
What it is
Marvis answers questions about your network in two ways. The Conversational Assistant takes plain language questions, such as "How many switches are connected?", and replies with data, troubleshooting results or documentation links. The Marvis Query Language (MQL) takes structured queries, built word by word from options Marvis offers, and returns lists, counts and rankings.
Both pull from the same Marvis data about sites, devices, clients and applications. The difference is how you ask and where you type.
How it works
Opening each one
| Conversational Assistant | Marvis Query Language | |
|---|---|---|
| How to open | Click the Marvis icon at the top left or bottom right of the portal | Marvis > Marvis Actions, then Ask a Question at the top right |
| Input | Natural language | Structured query built from drop down options |
| Typical output | Answers, troubleshooting steps, documentation links | Lists, counts, rankings, downloadable CSV |
The Conversational Assistant needs a qualifying Marvis subscription and a user account with access to all sites in the organization.
The Conversational Assistant
When it opens, the assistant offers four starting prompts:
| Prompt | Use |
|---|---|
| Troubleshoot | Problems with a site, application, device, or wired or wireless client |
| Search | Find users, devices and sites |
| Documentation | Find product documentation |
| Marvis Actions | Show pending items from the Actions dashboard |
You can also type questions directly. Examples from the Juniper documentation include "troubleshoot" followed by a site name, "which users are having issues", "how is" followed by an AP name, "find" followed by a client name, "does" an AP "have enough capacity", "how to set up RRM", "do I have rogue APs" and "do I have bad cables".
Answers follow the question type. A troubleshoot question returns a list of detected problems, such as slow association or poor coverage. A find question returns the client's site, MAC address and IP address. A how to question returns links to documentation. A question about bad cables points you to Marvis Actions.
Each response has thumbs up and thumbs down icons. Feedback helps the assistant learn, and rephrasing helps when Marvis misreads a word, for example treating a mistyped word as a client name.
The assistant also appears when you create a support ticket, so you can troubleshoot the affected sites, devices and clients before you submit.
The assistant needs access to all sites. An administrator limited to a few sites is a common reason the assistant is not available in an exam scenario.
Marvis Query Language
An MQL query is built from up to five elements, entered one after another:
| Element | Meaning | Example |
|---|---|---|
| Query type | What you want Marvis to do | LIST, COUNT, TROUBLESHOOT |
| Value | A value unique to your organization | A client or AP name |
| Query object | A Mist defined object | ClientEvents, APEvents, Switches |
| Clause | A qualifier for the whole query | WITH, BY, OF |
| Filter type | A predefined filter that narrows results | Site, Model, Problem |
Click the Enter a query box, choose an option from the drop down, and press the space bar to see the next options. Marvis guides you step by step until the query is complete. You can add a duration at the end with DURING, and download results as a CSV file.
Query types
| Query type | What it returns |
|---|---|
| LIST | Events or devices that match the filters |
| COUNT | The number of matching events or devices |
| RANK | Items ranked by a measure, such as clients by authentication failures |
| TROUBLESHOOT | A diagnosis of a client, AP or site, optionally for a specific problem |
| STATUSOF | Clients ranked by their number of connectivity issues |
| ROAMINGOF | A client's roaming between APs |
| LOCATE | A site, AP or client on a map or floor plan |
| UTILIZATIONOF | An AP's channel use across the 2.4, 5 and 6 GHz bands |
Examples written in the documentation's syntax:
LIST ClientEvents WITH AccessPoint <AP name> DURING <time duration>LIST Switches WITH Model <model number> AND Site <site name>STATUSOF Clients WITH Site <site name>ROAMINGOF <client name> DURING <time interval>TROUBLESHOOT <client, site or AP name> WITH Problem UnableToConnect DURING <time duration>
WITH introduces a filter, AND combines filters and DURING sets the time window. STATUSOF is a good place to start a troubleshooting session, because it shows which clients have the most problems before you drill into one with TROUBLESHOOT.
COUNT uses the same structure as LIST but returns only a number. If a question asks how many APs match a filter, the answer is COUNT; if it asks which APs, the answer is LIST.
Common mistakes
Mixing up the entry points. Ask a Question on the Marvis Actions page is the query language. The Marvis icon opens the conversational assistant.
Thinking MQL is free text. MQL is structured: query type, value, object, clause and filter. Marvis offers the next valid option after each space.
Choosing LIST for a ranking. RANK and STATUSOF order results; LIST simply returns matching items.
Forgetting the all sites requirement. The conversational assistant needs a user with access to all sites in the organization.
What to remember for the exam
- Conversational Assistant: Marvis icon, plain language, prompts Troubleshoot, Search, Documentation and Marvis Actions.
- Marvis Query Language: Marvis > Marvis Actions > Ask a Question.
- MQL elements: query type, value, query object, clause, filter type.
- Query types include LIST, COUNT, RANK, TROUBLESHOOT, STATUSOF, ROAMINGOF, LOCATE and UTILIZATIONOF.
- WITH adds a filter, AND combines filters, DURING sets the time window.
- Query results can be downloaded as CSV.
- Thumbs up and thumbs down feedback trains the assistant.
Check yourself
Where do you type a structured Marvis Query Language query?
On the Marvis > Marvis Actions page, by clicking Ask a Question at the top right.
Which MQL query type shows a client moving between APs?
ROAMINGOF, which shows a client's roaming between APs, optionally for a DURING time interval.
A help desk user wants to ask Marvis "which users are having issues" in plain English. Which feature do they use?
The Conversational Assistant, opened from the Marvis icon in the portal.
Topic 2 of 3 in Marvis Virtual Network Assistant
Test yourself on Marvis Virtual Network Assistant
The full Juniper JNCIA-MistAI JN0-253 question bank has 668 questions, with timed practice exams and an explanation for every answer.
This study guide is independent and is not affiliated with, endorsed by, or sponsored by Juniper. Vendor names, certification names and exam codes are trademarks of their respective owners and are used for identification only.