Sources and citations
Choose what Ask reads — your files, attachments, Slack, Jira, Gmail, the web and memory — check where an answer came from, and fix a source that isn't used.
On this page
A source is anything Ask may read to answer: your files, connected Slack, Jira and Gmail, the web, and your memories. Look here when you are adding a source, checking where an answer came from, or wondering why a source wasn’t used. Where each source is used outside Ask (Code threads, routines) is on How Ysra finds and uses your information.
How Ysra uses sources#
Ysra searches the selected, permission-checked sources, and only when your question needs them. Every statement taken from a source carries a citation, and what a source says is information, never an instruction.
The sources Ask can use#
| Source | What it covers | How to add it |
|---|---|---|
| Workspace files | Files uploaded to your workspace, searchable by their contents. | + Upload files on the Files page. See Files. |
| Attached files | Files you add to one question in the message box. | The files control under the message box. |
| Connected company sources | Slack, Jira and Gmail content you connected. | Integrations. |
| The web | Web search, web pages and PDFs. | Available when the colleague has the Web research capability. |
| Memory | Facts and preferences you asked Ysra to keep. | Memory. |
Repositories are not available as an Ask source yet. They show as coming soon in the message box. Ask cannot read or write GitHub.
Files#
Upload files once and use them in any conversation. Workspace files are searchable in Ask and in Code threads. Routines cannot reach workspace files; they read company sources only.
| Control | What it does |
|---|---|
| + Upload files | Adds files to the workspace. Each file is processed so its contents can be searched. |
| Search contents | Finds words inside your files, not only in file names. |
| Retry indexing | Processes a file again if it could not be read the first time. |
| Limit | Value |
|---|---|
| One file | 100 MB |
| File types | PDF, Word (.docx), Markdown, text, Excel (.xlsx, .xls), CSV/TSV, PowerPoint (.pptx), HTML, JSON, RTF; images PNG, JPG, WebP, GIF |
| Older Word and PowerPoint files (.doc, .ppt) | Refused: save them in the newer format first |
| Pages in one PDF | 2,000 (300 scanned) |
| Scanned pages and pictures read | 3,000 a day per person |
Connected company sources#
Slack, Jira and Gmail become sources once you connect them under Settings → Connectors. Ysra keeps them up to date about every 15 minutes.
| Source | What Ysra can read |
|---|---|
| Slack | Channels, private channels, direct and group messages it was granted. |
| Jira | Issues, statuses and comments in the connected site. |
| Gmail | A mailbox you connected for search. It appears as a source named like “Gmail · email”. |
A colleague’s Sources decide which sources it uses by default; Sources in the message box changes them for one question.
The web#
Ysra can search the web, read a web page, and read a PDF. Web appears under the message box as an indicator when the colleague you chose has web research. It is not a toggle: to answer without the web, choose a colleague that doesn’t have the Web research capability.
How citations look#
| Where | What it shows |
|---|---|
| In the answer | A small numbered citation pill on each statement that comes from a source. |
| Sources panel | The sources the answer used, so you can open each one and check it. |
| Steps above the answer (web and desktop apps) | Only what Ysra looked at, counted: searching the web, reading a file or a page, searching a source, reading Ysra’s help. Finished “Thinking” steps aren’t listed. |
| A shared copy of the chat | Each source by name only; nothing links out. |
Sources are data, never instructions#
Everything Ysra reads, whether a Slack message, an email, a Jira comment or a web page, is information to reason about. Text inside a source that tries to give Ysra orders is not followed.
If a source isn’t used#
| Symptom | Why | What to do |
|---|---|---|
| A file can’t be found by its contents | It wasn’t read when it was uploaded. | Retry indexing on the file. |
A .doc or .ppt file is refused |
Older Word and PowerPoint formats aren’t read. | Save it as .docx or .pptx and upload again. |
| A large PDF or file doesn’t go in | Over 2,000 pages (300 if scanned), or over 100 MB. | Split it into smaller files. |
| Scanned pages stop being read | 3,000 scanned pages and pictures a day per person. | Wait until the next day, or upload text PDFs. |
| Slack, Jira or Gmail isn’t cited | The question didn’t need company context, the source was unticked, or the colleague’s Sources leave it out. | Tick it under Sources, or name it in the question. |
| A message sent minutes ago isn’t found | Connected sources update about every 15 minutes. | Ask again a little later. |
| No web results | The colleague doesn’t have Web research. | Choose a colleague that has it. |
| A repository isn’t offered | Repositories aren’t an Ask source yet. | Use a Code thread. |
Related#
- How Ysra finds and uses your information — each source in Ask, Code and routines, and how to remove it.
- Ask — choosing sources and Answer or Deep dive for a question.
- Limits and costs — upload and search limits in one place.
- Integrations — connecting Slack, Jira and Gmail.