Skip to main content

Talking to Qry

Besides dictating a prompt, you can talk to Qry: ask out loud, hear a short spoken answer, and ask the next question without touching the keyboard. Every question you ask this way is an ordinary turn of the conversation on screen, so the full answer — the table, the chart, the details — stays written there.

Goal​

You finish this page having asked two questions out loud, the second one following on from the first, and ended the conversation by saying goodbye.

Prerequisites​

  • A working microphone and the browser's microphone permission for your Qry address.
  • Voice conversation switched on for your installation. It is off by default. With nothing typed in the prompt, the main button (where Send goes) is the waveform (〰) — on a phone, a dark Talk button. If you only ever see Send, an admin has not turned voice on (Admin › System configuration › Platform › Voice conversation).

Steps​

1. Find the Talk button​

With the prompt empty, the button at the right of the prompt is Talk to Qry: the waveform on a computer or tablet, a labelled Talk button on a phone. As soon as you type, it turns into Send; clear the text and it comes back.

The first time it appears in your browser, a short note above it — You can now talk to Qry — says what it does. Close it, or just use the button, and it does not show again.

2. Pick your microphone (once)​

On a computer or tablet, click the small arrow next to the waveform. The bar at the top moves as you speak — it shows the microphone is hearing you. Pick a different one from the list if it does not. Qry remembers your choice in this browser.

3. Start the conversation​

Click the waveform (or Talk). The prompt turns into the voice bar: an animated circle on the left, what is happening in the middle, and Mute, the microphone arrow and End on the right. When it is ready it reads Listening to you… with a pink dot.

4. Ask​

Speak naturally. As you talk, the bar shows what it heard. When you stop, Qry says something short ("Let me check") and the bar shows what it is doing — looking up tables, querying the data — with the seconds elapsed. Your question appears in the conversation, marked by voice, and the answer is written below it as usual. If it takes a while — a question that needs several queries can take a minute — Qry tells you now and then what it is doing.

You can ask for a chart or a table out loud — "make me a chart of sales by region" — and Qry draws it in the conversation while the voice sums it up.

5. Listen, then ask the next one​

While it answers, the bar reads Qry is speaking…. Qry sums the answer up in a sentence or two and offers more detail when there is more. Follow up the way you would talk — "and in August?" — it uses the conversation so far. You can speak over Qry at any time: it stops and listens.

6. End​

Say goodbye — "bye", "that's all, thanks" — and Qry says goodbye and closes the conversation. A bare "thanks" does not end it, so you can thank it and keep asking. You can also click End or press Esc.

The prompt comes back; the conversation, with every question and answer, stays in your history.

If you can't see the screen​

Voice conversation is built to work without looking:

  • Qry never tells you to look at the screen. When an answer has a chart, the voice says in words what it shows — the trend, the highest and the lowest — and the written answer to a spoken question describes its charts and tables too.
  • You can end the conversation by saying goodbye, without finding End.
  • The voice bar announces its state to screen readers as it changes (listening, what Qry is doing, speaking).

See also Accessibility.

On phones and tablets​

  • Phone: the voice conversation takes the lower half of the screen, with the state in large words, what it heard, a reminder that you can say "bye" to end, and large Mute and End buttons.
  • Tablet held sideways: it docks at the right as a panel with a short transcript of your last question and Qry's last answer, so you can follow it with the sound off; the chat keeps writing beside it.

See Using Qry on phones and tablets.

What's happening behind the scenes​

  • A real-time voice model holds the spoken conversation. It does not look at your data: every question goes to Qry's chat as if you had typed it — with the model selected in the prompt, the datasource and workspace you are in, and your own permissions.
  • The footer of the voice bar names both: the model that speaks (Voice) and the one that answers (Answers).
  • Your audio goes to the voice provider your installation uses (for example Azure OpenAI in the EU data zone). Qry does not keep the audio; the conversation keeps the text of your questions and Qry's answers.

Common issues​

There is no waveform or Talk button. Voice conversation is off for your installation. Ask an admin.

"Qry cannot use the microphone." Your browser blocked it. Allow the microphone from the padlock in the address bar and click Try again.

Qry answers itself or keeps getting interrupted. The answer is coming out of your speakers and back into the microphone. Use headphones, or a microphone with echo cancellation.

The bar says Listening to you… but nothing happens when I speak. The wrong microphone is selected. Open the arrow and watch the level bar while you talk; pick the one that moves.

"The conversation reached its limit." Conversations close after a time an admin sets (15 minutes by default). Click Start again; the conversation on screen carries on.

See also​