How-to guides
How to see where an answer came from
Click the numbered chip after a claim to open the exact passage in your document that backs it. A quick guide to reading, trusting, and troubleshooting citation chips.
When an answer uses one of your project's reference documents, or a file you attached to a message, GPTree marks the claim with a small numbered chip. This guide shows how to use those chips and what to do when one does not behave as expected.
Open a citation
- Look for a small numbered chip after a sentence in an assistant answer.
- Click it. A panel opens showing the name of the document and the cited passage.
- Click anywhere outside the panel, or press Escape, to close it.
The panel adds a line only when there is something you should know. If the passage comes from an earlier version of the document, it says so and tells you whether the passage is unchanged, altered, or gone from the current version, or that it could not confirm either way. If the document has a newer version, it says that too. If the document is in any of your collections, the panel names them.
The passage you see is verified against the original document text before it is shown. If verification fails, GPTree tells you the passage is unavailable instead of guessing.
Add documents that can be cited
Citations come from a project's reference documents and from files you attach to a message.
For a project:
- Open the project and go to its settings and files area.
- Upload a PDF, Word, Excel, CSV, JSON, Markdown or plain text file.
- Give GPTree a few seconds to extract and index the text.
- Ask a question about the document in any conversation inside the project.
For a single conversation, attach the file to your message. GPTree breaks an attached file into passages the same way, so an answer that uses it carries chips that open the exact passage from the file you dropped in.
If chips are not appearing
- The document may still be processing. Ask again after a few seconds.
- Chips only appear for questions the assistant actually answered FROM the document. General answers that did not use a passage carry no chip.
- A project document must live in the project's settings and files area. A file attached to a message is cited in the conversation you attached it to.
- The assistant may say citations are unavailable for that turn. That means the stored passages for the project could not be checked against the current document text, so GPTree served the documents without chips rather than showing you a source it could not stand behind. Your documents are fine and the answer still uses them. Re-uploading the document rebuilds the passages.
If your project has a lot of documents
When a project's documents add up to more than one reply can read, the assistant searches them for each question instead of reading them all. The answer is built from the passages that match, and each passage it uses still carries its chip. The project's Files tab in settings says when a project is searched this way.
If nothing in the project matches, the assistant says it did not find the answer in the project's documents rather than guessing. It can offer a general answer instead, and if you accept, that answer is labelled as not coming from your documents. Asking with the words the document itself uses usually finds the passage.
A document uploaded a moment ago may still be indexing. The assistant says when some documents could not be searched yet; ask again shortly.
If the answer says it only saw part of a document
Long documents do not always fit in one turn. When that happens the assistant tells you how much it was shown, for example that it read 12 of 31 passages from a file, or that a file was left out of that turn entirely.
This is about the excerpt, not your file. Your document is complete and unchanged. Ask a narrower question, or ask about one document at a time, and the assistant can read more of the part you care about.
If a passage shows as unavailable
- The source document may have been deleted, or replaced with a new version whose text no longer contains the original passage.
- You may be viewing a citation from someone else's document that you do not have access to.
Either way, unavailable means GPTree refused to show a passage it could not verify. The rest of the answer is unaffected.
If the problem is with the project's stored passages rather than one chip, the assistant will say citations are unavailable for the whole turn instead of showing chips that might be wrong.