Ask
Ask Ysra questions about your work and get answers with sources — choose sources, speed and depth, get spreadsheets, documents and charts, and turn an answer into a routine or a Code thread.
On this page
Ask is where you put questions to Ysra about your work: decisions, incidents, customers, what changed this week. You get an answer with the sources it came from, and, when you need one, a spreadsheet, a document or slide deck or a chart or interactive View. This page is for anyone using Ask: it covers the options that shape an answer, what Ysra can do here, and what to do when an answer doesn't come out as expected.
To change code, use Code. For a job that repeats, use a routine. To study a course or learn a topic, use Learn.
Open Ask from the rail in the web or desktop app. Home in the web app starts with the same box; on the phone, Ask is Home.
Ask, a colleague, a public colleague or Ysra help?#
Rule of thumb: ask the built-in Ysra for one-off questions, make a colleague for a kind of question you ask again and again, publish a colleague only for people outside your team, and use help for questions about Ysra itself.
| Ask (built-in Ysra) | A colleague | A public colleague | Ysra help | |
|---|---|---|---|---|
| What it is | Ysra answering from the sources you tick. | A saved purpose, instructions, default sources and capabilities. | One of your colleagues, open to anyone with a link or on your website. | Questions about using Ysra, answered from these docs and your account’s setup. |
| Best for | One-off questions, research, reports. | Recurring questions: release status, a weekly support digest. | Customers and visitors asking about your offer. | “How do I…?”, “Why isn’t this working?” |
| Not for | Code changes (use Code). | Visitors outside your team (publish it instead). | Anything needing your connected tools: it reads only the files you choose, and the web if allowed. | Research, writing, code or your files. |
| Cost | Your credits; depends on the question and what is read. | Same as Ask. | The owner’s credits, within the limits you set. | Free, 20 questions a day. |
| Who can use it | You. | You, and people you share it with (with their own sources). | Anyone; only an owner or admin can publish on an organisation. | Anyone signed in, even with no credits. |
More on each: Colleagues, Public colleagues, Ysra help. Every number is also on Limits and costs.
How Ask uses your sources#
Ysra searches company sources only when the question needs them, only the sources ticked for this question, and cites what it used. Everything it reads is information, never instructions, and it changes nothing outside Ysra without your approval of the exact action (Actions and approvals).
What decides an answer#
Ask starts with one message box. It starts two lines tall and grows as you write, up to about half the window. + at the start of its row attaches files and holds the options, such as Learn mode; a longer list, such as Sources, opens from its own row. Who answers, Answer or Deep dive and the Speed sit next to it, and the microphone, voice and send buttons are together at the end. On a phone, + opens from the bottom of the screen. A small line under the box says how many free quick answers you have left, only when few are left.
| Control | What it decides | Default |
|---|---|---|
| Who answers | The built-in Ysra, or one of your colleagues, which brings its own instructions, sources and capabilities. | Ysra |
| Sources | Which connected sources may be read. Untick any it shouldn’t read. “Your files and anything you attach are always used.” A colleague with web research adds “This colleague can also search the web.” See Sources and citations. | A colleague’s own sources; otherwise all of them ticked |
| Speed | How much Ysra does for the answer: Auto (“Ysra picks for each question”), Quick (“Fast answers for chat, rewording and short questions”) or Thorough (“Research, files and reports”). See below. | Auto, or a colleague’s own speed |
| How far it looks | Answer: “A direct answer, with where it came from”. Deep dive: “Slower: reads more sources and can write a report”. | Answer |
| Learn mode | A tutor that gives hints before answers. See Learn mode in Ask. | Off |
| Your question | Enter sends it. A suggested question only fills the box, so you can change it first. Follow-ups continue the same conversation. | — |
See examples you can run opens Start here. In the web app’s sidebar, conversations being answered now are under Answering, the rest under Earlier.
Long conversations and follow-ups#
Keep going in the same conversation for as long as you like. Ysra remembers the whole conversation, not only the last few questions: in a long one, it keeps a short summary of the earliest part and the recent questions in full.
A follow-up reuses what earlier answers already found: the files, pages and sources they read. You don't need to attach a file again or say where something was:
What does page 4 say?
Compare that with the figures in the second report.
Which of those sources was the most recent?
To start fresh on a different subject, start a new conversation.
Edit, retry or copy a message#
Point at a message you sent (on a phone, tap it) to see when you sent it and three actions:
| Action | What it does |
|---|---|
| Retry | Asks the same message again for a new answer. The answer you have is kept. |
| Edit | Opens the message in place. Change the words and choose Save & send to ask again from that point; Cancel or Escape keeps it as it was. The earlier version is kept. |
| Copy | Copies your message. |
A message with more than one version shows ‹ ½ ›: use the arrows to switch between versions and the answers they got. Edit and Retry wait while an answer is on its way.
Auto, Quick or Thorough#
The Speed sets how hard Ysra works on an answer. Leave it on Auto and Ysra picks for each question; pick Quick or Thorough to decide yourself. Under each answer, beside its credits, the answer says which speed it was worked on: Quick or Thorough.
| Quick | Thorough | |
|---|---|---|
| Best for | Chat, rewording and short questions. | Research, files, reports, spreadsheets and anything about what is true now. |
| What happens | Ysra answers straight away, with a short look on the web at most. | Ysra thinks longer and reads as widely as the question needs. |
| Credits | Fewer | More |
What Auto picks#
On Auto, chat, rewordings and short questions are answered Quick. Research, comparisons, reports, spreadsheets, PDFs, plans, questions about what is true now, and questions with files or a named source are answered Thorough. A Quick answer that turns out to need more is moved up to Thorough by itself.
Deep dive is always worked on Thorough, and so are Ysra help questions.
Where the speed is set#
| Place | How |
|---|---|
| A conversation | Speed in Ask’s start box or the follow-up box. A new pick applies from that question on, for the rest of the conversation. The app remembers your last pick for the next conversation. |
| A colleague | Speed in the colleague’s settings: it answers on that speed unless you pick another in the box. See Colleagues. |
| A public colleague | Its colleague’s speed. On Auto, a public colleague answers Quick. See Public colleagues. |
The phone and ysra ask |
Auto. |
Answer or Deep dive#
| Answer | Deep dive | |
|---|---|---|
| Use it when | You want a quick, direct reply. | The answer is spread across several places. |
| What happens | Ysra answers, searching sources only if the question needs them. | Ysra investigates across several sources before it writes. Slower. |
When you ask for a number of results#
The request sets how deep Ysra goes. Ask for a number, such as “50 companies”, or ask it to look at each one’s website, and Ysra searches from several angles and reads each site until it reaches that number or the most one answer can do; a Deep dive goes further. The answer says how many it reached. When it finds fewer than you asked for, it says so and lists only what it found: it doesn’t make entries up to fill the number.
When you ask the way#
Ask “how do I get to …?” and Ysra answers in a few short lines (the usual way to come, with “about” for times and distances), then gives a link, Open the route in Google Maps, that opens the route turn by turn in your own Maps app. With no starting point, Maps starts from where your phone is. Paste a Google Maps link and Ysra reads the place it points to, so “I’m here” works as a starting point. A colleague with a Location uses its own address as the destination.
When you write in another language#
Ysra answers in the language of your latest message, the first message of a conversation included, even a short sentence. Only a message it can't tell, such as a name, one word or a link, is answered in the conversation’s or your account's language. The conversation's title is written in your message's language too.
In Arabic, Ysra answers in Modern Standard Arabic. Ask for a dialect by name, such as Moroccan or Egyptian Arabic, and it uses that one. This is the same in Ask, colleagues, routines, Code and Mayz.
When you close the page during research#
Research keeps going. Come back to the conversation to see what has been done so far, and the answer when it’s ready. A question sent from an app that closed before the answer could start doesn’t wait forever: after a few minutes the conversation says so, and you can ask again.
When you stop an answer#
Stop in the message box stops it. The conversation says: “Stopped before this finished. The question is saved — ask again to continue from it.”
When Ysra won’t answer#
The answer says so plainly.
Questions about Ysra itself#
Ask also answers questions about using Ysra, such as “How do I add a machine?” or “Why can’t I pick a repository?”, from these docs, with the steps and a link to the page it used. For these, Ysra help is free.
It answers for you, not for anyone. It knows facts about your account, never their content:
- your organisation, your role, what your role may not do and who can do it;
- how many credits are left;
- which tools are connected, which need reconnecting, and which are missing;
- your repositories, devices and routines, and what is waiting on you;
- which apps you are signed in on.
When one of these is what’s in your way, the answer says so first, with where to fix it or who can. For example: GitHub isn’t connected, so there is no repository to pick.
What Ysra can do in Ask#
| Ysra can… | Details |
|---|---|
| Search connected company sources | Slack, Jira and Gmail sources you connected. See Integrations. |
| Search your workspace files | Uploaded files are indexed so their contents can be searched. |
| Use the web | Search the web, read a page, and read a PDF. |
| Open a website in a real browser | For pages that read as almost empty otherwise, such as listings, maps and social pages: Ysra opens the page, reads, scrolls, clicks and takes screenshots. Read-only: no sign-ins, no forms. It never uses your own browser. Not on Quick answers; it counts towards the answer’s credits. |
| Make images, and save images from the web | A visual, an illustration or a quick logo idea, up to 4 an answer, charged per image; or a photo or logo from a page, saved into the conversation’s files. |
| Make a document, a deck or a PDF | A Word file, a PowerPoint deck or a PDF, with tables, charts and sources. See Documents and slides. |
| Show a chart or an interactive View | A chart, a diagram or a small interactive page inside the answer. See Views. |
| Answer with a spreadsheet | An Excel workbook or a CSV file. See Spreadsheets. |
| Remember something for later | Saves a memory when you ask it to. |
| Use the services you connected | Any service connected in Plugins, such as Linear, Notion or Microsoft 365. Mention it with @, for example @linear. |
| Email a report | With Microsoft 365, a PDF report is emailed with the PDF attached, after you approve the email. A follow-up such as “send it to Sam too” reuses the same email. |
| Propose Slack and Jira actions, and changes in connected services | Nothing happens until you approve. See Actions and approvals. |
What each colleague may actually do depends on its capabilities. Ask “can you open this link?” or “what can you do here?” and Ysra answers from what is on in that conversation, says what is off and where to turn it on. See What Ysra can do. Ask cannot read or write GitHub. Repositories are not available as an Ask source yet.
Spreadsheets#
Ask can answer with a spreadsheet: an Excel workbook (.xlsx) by default, a
CSV file if you ask for one, or both. A colleague answers with one only when it
has the Spreadsheets capability.
| A workbook can have | Limit |
|---|---|
| Sheets | Up to 20 |
| Typed columns | Text, number, currency, percentage, date and link |
| Formulas | On each row, from the functions below |
| Charts | Bar, column, line and pie; up to 12 on a sheet |
| Formatting | Conditional formatting; a frozen header row with filters |
| A Sources sheet | Optional: where the figures came from |
| Cells in one answer’s spreadsheet | At most 50,000 |
Formulas use SUM, AVERAGE, MIN, MAX, COUNT, COUNTA, PRODUCT,
ROUND, ROUNDUP, ROUNDDOWN, ABS, IF, AND, OR, NOT, VLOOKUP,
INDEX, MATCH, SUMIFS, COUNTIFS, AVERAGEIFS, DATE, DAY, MONTH
and YEAR. A formula can’t refer to another sheet or to a whole column.
When research finds text where a number belongs, such as “about 200” or “not disclosed”, the spreadsheet is still made: the number cell stays empty and the text goes in a “… note” column beside it.
The file appears as a card on the answer, with its type (XLSX or CSV) and Download, which works on iPad and in Safari too. Workbooks are downloaded, not previewed in the app. Reports and workbooks Ysra makes are kept in your workspace files, later questions can search them like any other file, and they can be chosen for a public colleague.
Files made in an Ask answer, each with Download.
When a spreadsheet or report isn’t made#
| What the answer says | Why | What to do |
|---|---|---|
| The spreadsheet is too large to build here… | It would hold more than 50,000 cells. | Ask for fewer rows or columns, or split it into several answers. |
| …took too long… | Building it ran out of time. | Ask again, or for a smaller spreadsheet. |
| The answer is marked incomplete | It was meant to come with a spreadsheet or a PDF and couldn’t make it. | Ask again; the answer never reads as finished when a file is missing. |
Attaching a spreadsheet#
You can attach .xlsx and .csv files wherever you can attach a PDF or a
Word file. Older Excel .xls files are accepted too. Ysra reads them sheet
by sheet, and they can be searched like your other files.
Changing a spreadsheet#
Ask for a change to a spreadsheet already in the conversation, one Ysra made in an earlier answer or one you attached: “add charts”, “add rows for October”, “add a dashboard sheet”. Ysra changes that file and keeps everything already in it: the other sheets, the formulas, the links and the charts. You don’t need to attach it again.
Share or delete a conversation#
Share this chat makes a read-only copy anyone with the link can open, for 24 hours, 7 days or 30 days. See Sharing. To remove a conversation, use Delete on it: “It's removed from Ysra, with its share links. This can't be undone from the app.” See Data, privacy and deletion.
Citations and the Sources panel#
Statements that come from a source carry a citation pill. The Sources panel lists what the answer used, so you can open each one and check it. More in Sources and citations and How Ysra finds and uses your information.
When an answer should become work#
| You want | Use | What happens |
|---|---|---|
| The same job on a schedule (“check our website every day”) | A Routine card | It appears under the answer by itself, with when it would run, what it would read, what it would do and what it would ask you first. Start this routine switches it on. When no card comes, choose Make this a routine in the latest answer’s … menu. See Start a routine from Ask. |
| Code built or changed from the answer (desktop app only) | Hand to Code | A brief goes to a Code thread on this computer. See below. |
A routine started from a conversation stays tied to it. Its runs are posted into the conversation as short cards, and the header’s Routines · N opens a panel beside it with each routine’s switch, Run now, Edit, its runs and what waits for your approval. See Runs and approvals and How routines work. The routine can open the conversation’s files and update a spreadsheet among them in place: each run starts from the version the last run left.
Hand an answer to Code#
In the desktop app, the latest answer has Take this further: with Hand to Code, which works only there, where Code runs on that computer. A line beside it may say what it would do for this answer, or why it doesn’t fit, such as “Nothing here to build”; the button works either way.
Hand to Code writes a brief from the conversation and switches to Code with the brief in the message box, for you to read and send. It starts a new thread in a folder on this computer, or goes to the thread that’s open. Nothing is sent until you send it.
| Situation | What the app says |
|---|---|
| A thread is open | “Brief added to the composer. Review it and send.” |
| No thread is open | “Brief ready. Open a thread and it will be in the composer.” |
Once handed off, the conversation shows a Code card naming the folder and the thread’s status; it opens the thread. See Code.
Slash commands and mentions#
Inside a conversation, type / in the message box to go straight to an
action. In the web app, the commands aren’t offered on Ask’s start page: ask
your first question, then use them in the conversation.
| Command | Use it to |
|---|---|
/slack send |
Prepare a Slack message for your approval. |
/slack users |
Find people in Slack. |
/slack summarize |
Summarize Slack conversations. |
/jira status |
Check the status of Jira work. |
/jira create |
Prepare a new Jira issue for your approval. |
/jira comment |
Prepare a Jira comment for your approval. |
/jira move |
Prepare a Jira status change for your approval. |
Mention your own things#
Type @ to point Ysra at something of yours. The picker offers:
| Kind | Ysra… |
|---|---|
| A file | Reads it like one of the conversation’s own files |
| Another Ask conversation | Reads it |
| A Code thread, in the desktop app | Reads it |
| A routine | Reads it |
| A colleague | Lets that colleague answer this one message |
A connected service, such as @linear |
Uses that service’s tools for this message. See Plugins |
The web app doesn’t list Code threads: they live on the computer where they
run. @workers offers Automate this, which does what Make this a
Routine does. In the desktop app, once there is a conversation, the @ menu
also offers both Hand to Code and Automate this.
Mentions only ever reach your own things, and colleagues shared with you. A mention is read, never run: mentioning a routine or a Code thread doesn’t start, stop or change it. The desktop and web apps have the picker. The phone shows mentions in a message as names: tap a conversation or a routine to open it, or a file to open the file. A mention of a colleague or a Code thread is a name only.
| Mentions also work in | What the mentioned file does |
|---|---|
| A Code thread’s message box (desktop app) | It is given to the work. |
| A routine’s instructions | The routine reads it and can update it, run after run. |
| A colleague’s instructions | It comes with every answer the colleague gives. |
When you mention people, mentions resolve to real people from your connected sources, not guesses.
On the phone#
Home on the phone asks “What do you want to know?” You can:
- pick a colleague;
- open the sources sheet, “Sources for this question”;
- turn on Deep dive: “Reads more sources. Slower.” instead of “One pass over the selected sources.”;
- approve proposed actions with Approve, Edit or No.
Questions from the phone are answered on Auto, or on the colleague’s own speed.
See Mobile for the rest of the phone app.
If it doesn’t work#
| Symptom | Why | What to do |
|---|---|---|
| The answer ignores a Slack channel or mailbox | That source was unticked, the colleague has its own sources, or the question didn’t need company context. | Tick it under Sources, or name it in the question. See Sources and citations. |
| No web results | The colleague doesn’t have Web research. | Choose a colleague that has it. |
| Fewer results than asked for | Research reached the most one answer can do. | Use Deep dive, or ask for the rest in a follow-up. |
| A short answer to a question that needed research | The answer was worked on Quick. | Pick Thorough under Speed, and ask again. |
| The conversation says it couldn’t start | The app closed before the answer started. | Ask again. |
| An upload is refused | The box says why, in your language: the file's type, size or content. | Do what the message says, such as saving it in another format, and attach it again. |
| No totals or trends, and a note that the exact calculation needs Starter or Thorough | The answer couldn't run calculations (the Free plan, or a Quick answer), so it gave only figures your files show. | Pick Thorough, or move to the Starter plan or above. |
| No Hand to Code | You are in the web app or on the phone. | Open the conversation in the desktop app. |
| No credits left | Paid answers don’t start. | See Limits and costs. Ysra help still works. |
In this section#
-
How Ysra finds and uses your information
Every source, and where each one is used.
-
Files, connected sources, the web, and how citations look.
-
Instructions, sources and capabilities for recurring kinds of questions.
-
What Ysra carries from one conversation to the next.
-
Slack and Jira changes that happen only when you approve them.
-
Share a read-only copy of a chat, or share a colleague.
-
Charts, diagrams and interactive pages inside an answer.
-
Word documents, PowerPoint decks and PDFs made from your sources.
Related#
- Limits and costs — every number for Ask, uploads and public colleagues.
- Colleagues — when to make one, and what it may do.
- How routines work — what happens after Start this routine.
- Set up with Ysra — a workspace with colleagues and routines made from a short talk.


