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
In a nutshell
  • 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.

Admin questionplain languageConversational AssistantMarvis iconanswerData, troubleshootingor documentation linksAdmin questionstructuredMarvis Query LanguageAsk a QuestionanswerLists, countsrankings, CSV

How it works

Opening each one

Conversational AssistantMarvis Query Language
How to openClick the Marvis icon at the top left or bottom right of the portalMarvis > Marvis Actions, then Ask a Question at the top right
InputNatural languageStructured query built from drop down options
Typical outputAnswers, troubleshooting steps, documentation linksLists, 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:

PromptUse
TroubleshootProblems with a site, application, device, or wired or wireless client
SearchFind users, devices and sites
DocumentationFind product documentation
Marvis ActionsShow 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.

Exam tip

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:

ElementMeaningExample
Query typeWhat you want Marvis to doLIST, COUNT, TROUBLESHOOT
ValueA value unique to your organizationA client or AP name
Query objectA Mist defined objectClientEvents, APEvents, Switches
ClauseA qualifier for the whole queryWITH, BY, OF
Filter typeA predefined filter that narrows resultsSite, 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 typeLISTthenQuery objectClientEventsclauseWITHAccessPoint nametimeDURINGduration

Query types

Query typeWhat it returns
LISTEvents or devices that match the filters
COUNTThe number of matching events or devices
RANKItems ranked by a measure, such as clients by authentication failures
TROUBLESHOOTA diagnosis of a client, AP or site, optionally for a specific problem
STATUSOFClients ranked by their number of connectivity issues
ROAMINGOFA client's roaming between APs
LOCATEA site, AP or client on a map or floor plan
UTILIZATIONOFAn 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.

Watch out

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.