03Documentation
Evidence and trust
How to check an answer, read a case file, and know what Vernais will not do.
Check where a number came from
Every number carries its receipt. Open the thinking to see which tool ran, what it was scoped to, and the record behind every claim.
One constraint shapes most of what follows: when Vernais answers from your connected data, every claim has to trace back to a record it can point at. It will not invent a cause. A question it cannot ground in your data returns nothing rather than a guess. Questions about the outside world, or about general knowledge, it answers like any good assistant — and tells you which world the answer came from.
That promise is only worth something if you can check it. So every answer ships with its work: the tools that ran, what each one was scoped to, and the sources behind a web claim. Here is where to look.
Open the thinking block
Click the header above any answer — it holds every action the AI took to build that answer.
- 1Find the header
A collapsible row sits above each answer. While the turn runs it reads
Thinking…(orLooking it up…,Searching the web…,Investigating…) with aLIVEmarker. When it settles it collapses toReasoned across 4 stepswith the elapsed time and step count beside it, plus a lane tag likeData lookup. - 2Click it open
The body lists each action in the order it happened, top to bottom. A running turn opens itself and scrolls as new steps arrive, so you can watch it work.
- 3Read a step row
Each row has an icon, a title, and the tool's real name in mono capitals on the right —
KG_COUNT,WEB_SEARCH,READ_PAGE,KG_WHO_IS. That name tells you which tool produced the fact. - 4Read the detail line under it
A data step carries a short scope line — the counting step prints the exact filter it ran. A web search opens out into the pages it found, and a page it read shows as a card. A file read shows the lines it opened.
Two rows are worth learning to spot. A step whose detail reads data worker unavailable or workspace data worker mismatch means the tool itself broke — the answer should tell you the lookup failed rather than give a number. A row reading Skipped repeat · <tool> means a loop guard blocked a call the AI had already run with the same arguments; the result would not have changed. That one is a safety net, not a fault.
The lookup failed is literal. It reports a broken tool, not an empty result. Ask again rather than reading it as "you have no data".
Reasoning, tool steps, and the answer
Only tool steps fetch facts — reasoning is the model talking to itself, and the answer summarises both.
The model's own thinking, drawn in a muted rail marked reasoning. It plans, weighs and second-guesses. It fetches nothing, so on its own it proves nothing.
One real action against your data, the web, or your files. It returns a result and a receipt. Every trustworthy number in the answer is born here.
The prose below the block. It should only restate what the steps returned. The product's own rule is blunt: a data answer with no tool call before it is wrong.
The two are interleaved in the order they happened — a burst of reasoning, then a step, then more reasoning. Read top to bottom and you get the story of how the answer got built. If a number appears in the answer and no step above it went and got that number, stop trusting the number.
Read the receipt on a number
The counting step prints the exact filter it ran. Read the filter, not just the figure.
A count runs as its own step, and its detail line is the literal filter the database used:
Counting events KG_COUNT
integrations=['stripe']That line is the receipt. The number itself lands in the answer below. When the filter set is empty the line reads no filters (whole corpus) — meaning the number covers everything you have connected, not the one tool you had in mind.
Other tools hand their own receipts to the model, and the grounding rule allows it to report only what they returned. A breakdown returns each value with its count, then (+N more across M other values) for the tail, plus a separate count of records that had no such field — so nothing is dropped in silence. An outcome question returns the concrete values behind each bucket, like success: 90 (Purchase=33, Add to Cart=30, Sign Up=27). That list is where you check its judgement, because no tool literally stores the word "successful".
A count with no date range is a true database count and is exact. A count with a date range has to open each record and read the date out of its fields, so it is capped and can be a floor.
scan capped at N rows — count may be a lower bound(+N more across M other values)Check the receipt answers your question
A wrong number is easy to catch. A right-looking number that answers a slightly different question is the real risk, and the recipe is how you catch it.
integrations=['stripe'] — that is every Stripe record across every stream, not just charges. The second scopes to the stream you meant. Same shape of answer, different question. The recipe is what tells them apart.since April and the total fell further than expected. A record whose date cannot be read from its own fields is dropped from a dated question, not counted as unknown.Checking every receipt on every number is overkill. Do it when the number will drive a decision, when it surprises you, or when it disagrees with a number you got earlier in the thread. The test: would you be comfortable repeating this number in a review?
Open the sources panel
A web fact in the answer maps to a chip — click it to open the exact page it came from.
When a turn used the web, an N sources pill sits under the answer beside Copy and Regenerate. Click it and a panel slides in from the right. It lists every source the turn surfaced: favicon, publisher, title and a snippet. A read chip marks the pages the AI actually opened, as opposed to merely found — that difference matters, because on a substantive question it is told to open the best two to four results rather than answer from search snippets. Each card opens in a new tab. Close the panel with the ✕ or Escape; the chat behind stays readable.
Inside the answer, a web fact is cited as a plain [n]. The UI turns that marker into a small chip carrying the site's favicon and name, linking straight to the page. A run of markers collapses to the first source plus +N. So a citation number is a promise: that sentence came from that page. Citation chips cover the web only — facts from your connected tools are traced through the tool steps instead, and a case file cites records.
Trace an investigation's numbers
A case file cites records, not pages — every citation chip expands the record it rests on.
An investigation carries its receipts inside the case file. Open Evidence chain and each claim sits beside a citation chip. Click the chip and the record expands underneath it: the Jira issue, the Sentry error, the Stripe charge — its source text, its readable fields, and its links out. You read the text the claim came from without leaving the answer. Measured impact (telemetry) holds the counts, scoped to that incident rather than your whole corpus, with sample failing events you can expand one by one. What I'm not sure about lists the evidence that was missing and the evidence that pointed the other way.
At the bottom sits a grey line: NLI ground-check: 7/10 claims entailed by their sources. That is a separate verifier re-reading each claim against its own cited record and asking whether the source really says it. A low ratio is not proof the answer is wrong — the verifier scores plenty of correct prose near zero, so it is held back when the structural evidence is strong. Read it next to the confidence badge, not instead of it. Confidence covers how that badge gets set.
Develop your intuition
These are starting points, not rules. When a number looks off, ask yourself:
- Does the counting step's filter name the tool and the stream I actually meant?
- Am I reading the match total, or counting the rows on screen?
- Did I add a date bound that could be dropping undated records?
- Is there a step behind this number at all, or did the answer assert it?
- Did a
scan cappedwarning turn this count into a floor? - On an outcome split, do I agree with the values it counted as success?
Related resources
Read an investigation case file
Every answer is built to be argued with. You get a primary explanation, the rivals it beat, and a record behind each claim.
One constraint shapes most of what follows: when Vernais answers from your connected data, every claim has to trace back to a record it can point at. It will not invent a cause. A question it cannot ground in your data returns nothing rather than a guess. Questions about the outside world, or about general knowledge, it answers like any good assistant — and tells you which world the answer came from.
Watch the plan while it runs
The timeline is the receipt for the wait. Read it while it runs, and you already know what the answer is made of.
An investigation takes a few minutes. A box appears in the chat labeled Thinking… with a live timer. Stage cards stack up inside it. Each card shows a title, a spinner while it works, and the model's own reasoning as plain prose.
These are the stages that matter most to you:
Breaking down the question— your question is split into 3 to 5 sub-questions.Picking the relevant topics— the search area. Open the card to see which topics it entered and how close each one was.Forming candidate explanations— the rival theories, written before it looks at any evidence.Convening the node jury— the long one. A progress bar counts records as they are judged.Pressure-testing the verdict— a PM lens and an engineer lens argue over the result.Writing the cited answer— the case file is assembled.
A card with a chevron is clickable. The jury card is the one worth opening, and it renames itself to Jury verdict in once it lands. It lists the records that survived, each with the quote the juror had to copy out of it.
When the run finishes, the box collapses to Thought for 3m 12s. Your timeline is not gone. Click it to open the whole thing again, case file included.
Read the answer, then the case file
Read the prose answer first. Then read the sections that try to break it.
The answer is written prose with citation markers in it. Under the answer sits the case file: a confidence badge and a stack of sections. A section only appears when it has something in it, so no two case files look the same.
| Section | What it answers |
|---|---|
Evidence chain | The claims, one per row, each with a citation you can open |
Measured impact (telemetry) | How big it is: failures by version, top errors, affected users |
Tracking metric (North-Star) | One number to prove a fix worked, with its maths shown |
Hypotheses considered | Every explanation it wrote, and how each one fared |
Ruled out | The rivals that lost, and the reason each lost |
What I'm not sure about | Missing data, and evidence pointing the other way |
Evidence graph | Every record in the bounded search, as clickable chips |
Follow a citation to the record
Check one citation on every investigation you act on. It takes ten seconds and it is the whole point of the design.
- 1Find the evidence chain
It sits at the top of the case file, already open. Each row is one claim. The mark beside it says whether a verifier could tie that claim back to its source, or could not, or did not check it.
- 2Click the citation chip
The chip at the end of the row is a button. A chip with no record behind it is greyed out and will not click — that claim is framing, not evidence.
- 3Read the record in place
It opens right under the claim, not on a new screen. You get the record's own text, or its real field values when it is telemetry with no prose.
- 4Keep walking
Factslists what Vernais pulled out of that record.Connected toshows the records it links to, so you can follow the trail further.
The same click works everywhere a record appears. The chips in Evidence graph, the rows in Matching records, the Sample failing events under measured impact, and the open links in the graph exploration trace.
Read the competing explanations
The rivals exist so the answer has something to lose against. Read them before you trust the winner.
Before it looks at a single record, Vernais writes 2 to 4 candidate explanations. The rules on that step are strict. Each one must name exactly one specific cause. They must be mutually exclusive, so evidence for one is evidence against another. Each must be testable on its own. And at least one has to be a genuine alternative — an outside cause, or a problem that was already there before the change you suspect.
That last rule is the important one. It forces the system to carry a theory that would embarrass its favourite. Without it, an investigation grades its own first guess.
Hypotheses considered shows each theory with a badge: likely, possible, or ruled out. Ruled out then lists the losers, each with a reason line. Read those reason lines closely, because two very different outcomes share that heading:
The reason line ends with Evidence against: and the records that contradicted it. Something actually disproved this one.
The reason line reads No grounded record supports this hypothesis. It was never disproved — no record ever spoke to it either way.
Read the reason lines together. If not one of them names a record that contradicted its rival, nothing was disproved and the winner took the field by default. That is a thin win, not a clean one. Go find the data that would settle it before you ship a fix.
Check the confidence badge
The badge can only go down. Deterministic checks lower the model's own label, never raise it.
A colour-coded badge sits above the case file: green for high, amber for medium, red for low. The model states a label first. Then post-checks run, and if a check objects, the label drops. The prose is rewritten to match the badge, so the words and the badge can never disagree.
Reachable. It means no objection survived the checks.
A specific objection stands. The caveat line at the bottom names which one.
It is not confident. A withheld causal verdict also lands here.
Nothing is claimed — either no record survived the evidence checks, or the run halted before it could answer.
hypothesis only is a different badge, and it lives on the timeline rather than the case file. When the final gate refuses to certify a cause, the candidate-explanations card is retitled Candidate explanations — causal verdict withheld and wears that badge. Open it and it names the reasons. Confidence is forced to low.
Several checks can pull a high down to medium, and the caveat line names whichever fired. Two come from the causal check. One: a symptom in the timeline predates the first dated change you blamed. Two: the error it named covers only part of the cohort that is actually failing. Both are worth acting on — a medium here usually means the pattern is real and the mechanism is incomplete.
A third is on you. Name a tool in your question, and it may turn out to supply under about a third of the grounded evidence. The answer then calls that angle tangential and knocks the high down. Confidence covers what each level should change about your next move.
Read the measured impact
The header carries the headline — 183 failed · 47 users. What is underneath is the shape of the problem, not its size.
Inside are the real counts from your event tools. A by-version table with a failure percentage per version. Top errors with how often each fired. The most-affected users. A bar per event name. And sample failing events you can click open like any other record.
These counts are scoped to this incident, not to your whole workspace. The scan starts from the records that survived the jury and counts the telemetry the graph ties to them.
No quantitative measurement available instead. The investigation still answers, but qualitatively.Take the tracking metric
This is your before number. Read the formula, not the value.
After the answer lands, Vernais derives a metric for the problem it diagnosed. The section reads Tracking metric (North-Star) when it settled on one, and Tracking metrics when it derived a set — a north star plus the supporting metrics around it.
Each card shows the metric name, the value right now, and the formula in monospace. Under that sit the numerator and denominator with the exact events counted on each side, why it picked that metric, and a suitability badge.
Check that the events in the numerator are the failure you care about. The formula is shown so you can disagree with it.
This is a read-only preview. Locking the value as a baseline and watching it move happens in the initiative's Measure tab — see Prove it worked.
Read what it couldn't check
Open What I'm not sure about before you act, not after.
That section carries two things: the data it went looking for and did not find, and the evidence that pointed the other way. A grey line at the very bottom of the case file adds a machine check: NLI ground-check: 7/10 claims entailed by their sources. Any caveat sits on the same line.
A low ground-check ratio on its own is not proof the answer is wrong. The verifier scores correct, well-written prose near zero, so a good answer can score badly. That is why the ratio is suppressed as a caveat when the underlying data structure is strong. Read it as one voice, not the verdict.
Develop your intuition
The caveat line is where a run admits it is uneasy. It shares that grey line at the bottom with the ground-check, and it is the fastest read in the whole case file. Four things show up there, and each one changes what you should do next.
Four or fewer grounded records, and the caveat says so outright: limited evidence, lower certainty. Open Jury verdict in and count them yourself.
You named a tool, and most of the evidence came from elsewhere. Treat that angle as tangential — and note the high already dropped to medium.
Enough candidates lost every vote to provider rate-limits that the pool may be incomplete. Re-run rather than reason around the gap.
A deterministic check re-does the sums written in the prose and reports them when they do not add up. Trust the check over the sentence.
Related resources
Confidence levels
Four levels, one rule: a check can lower the number, never raise it. Here is what each level means and what to do about it.
One constraint shapes most of what follows: when Vernais answers from YOUR CONNECTED DATA, every claim has to trace back to a record it can point at. It will not invent a cause. A question it cannot ground in your data returns nothing rather than a guess. Questions about the outside world, or about general knowledge, it answers like any good assistant — and tells you which world the answer came from.
The four levels
The badge above the case file is the level. When a check lowered it, the reason prints as a caveat at the foot of the case file, on the ground-check line.
| Level | What it means | What to do next |
|---|---|---|
| High | The pattern is proven in your records, and the named mechanism covers the failures. | Act on it. Use Generate initiative under the answer, then pick a fix. |
| Medium | The pattern holds. One check objected, and the caveat names which one. | Read the caveat. It names the single thing to confirm before you commit. |
| Low | Either the model's own cautious call, or a verdict the evidence gate withheld. A withheld verdict also carries a hypothesis only badge. | Read the caveat. It names what was missing. |
| No badge at all | Not one record survived the evidence checks, so the answer says so in plain words. | Name a tool, a metric, or a time frame and ask again. See When there is nothing to find. |
hypothesis only is a refusal, not a failure. Vernais found records that describe possible friction, but could not establish that they caused your outcome. So it withholds the verdict, keeps the facts it does have on screen, and sets the level to low. The caveat names what was missing. That is one of three things: outcome telemetry that clears the evidence contract, a claim chain the entailment check can verify, or a causal path its own cited evidence supports.
What moves the number
The model states a level in its answer. Deterministic checks then run against your real counts, and each one can only pull that level down.
- The model's own call — the answer states a level. That is the starting point, not the verdict.
- The mechanism coverage check — if the error named in the root cause covers less than 80% of the worst-hit cohort, a causal high is capped at medium. The caveat prints the real percentage.
- The timeline check — if a symptom is dated earlier than the first dated candidate change, a causal high is capped at medium. The change cannot have caused something older than itself.
- The root-cause quote check — an entailment model re-reads the root-cause sentence against its cited sources. If none of them entail it, high drops to medium.
- The named-tool check — name a tool, and if under a third of the surviving evidence comes from it, high drops to medium and the caveat calls that angle tangential.
- The withheld verdict — the causal evidence gate refused the verdict, so the level is forced to low and the answer is labelled
hypothesis only.
The checks never run the number up. A cautious medium from the model stays medium even when the structure looks like a smoking gun. That costs you the occasional under-read, and it buys something worth more: the badge can never contradict the words next to it.
Why a causal answer can reach high
A causal answer can reach high. There is no blanket cap on why-questions. The cap is medium only when one of two named objections fires, and the caveat prints the reason.
- Coverage — the error named in the root cause covers less than 80% of the highest-failure cohort. The answer says so, with the real percentage.
- Order — a relevant symptom predates the first dated candidate change.
With neither objection, the cap stays high. There is a third guard worth knowing. The root-cause quote check would normally knock high down to medium, but it yields when the structure underneath is strong. Strong means all of: one version failing at 85% or more against a clean comparison build, at least 30 failures on it, and three or more tools reporting failures. That exception exists because the entailment model scores correct free prose near zero. Without it, the strongest cases would be marked down for being well written.
Medium is not a warning label. A medium answer can still name a real cause with a real mechanism, with one check that asked for more. The test: does the caveat name something that would change which fix you pick? If not, medium is enough to act on.
What stays the same when you re-run
Ask the same question against unchanged data and you get the same level. The level is arithmetic over your records, not a mood.
- Stable — the level, the surviving records, and the leading hypothesis. The question breakdown is cached against the question itself, and the candidate explanations against a fingerprint of your graph, so the hosted-model steps before the jury cannot drift between runs.
- Varies a little — the wording. The models that write the prose are hosted and not byte-identical, so two runs can phrase the same finding differently.
- Changes on purpose — add data and the fingerprint changes. The cache misses, the candidate explanations are made fresh, and the number can legitimately move. If the answer changed, the data usually moved.
So a level that flips run to run is a signal, not a glitch. Check what synced between the two runs.
Initiative confidence is a different number
The confidence on an initiative's Validate tab is not the investigation badge in another costume. It answers a different question and it is built a different way. Do not read one as the other.
| Investigation confidence | Initiative confidence | |
|---|---|---|
| Where | The badge above the case file in chat | The hypothesis cards on an initiative's Validate tab |
| Shape | high, medium, low — or no badge | A score per hypothesis, shown as 0.00–1.00 and on an R / 10 gauge |
| Asks | Did we find the real cause? | How much evidence stands behind this explanation? |
| Built from | The model's call, lowered by the checks above | Six scored factors, which anchor every card |
The six factors are scored out of 100 between them, with 60 as the decision-ready line. Each factor gets its own bar showing its score out of its maximum, so you can see which one is holding the number down.
| Factor | Points | Full score at |
|---|---|---|
| Evidence volume | 25 | 200 grounded signals |
| Grounding strength | 25 | every checked claim entailed by its cited source |
| Source diversity | 15 | 6 tools |
| Outcome signal | 15 | a 50% failure rate |
| Internal corroboration | 10 | 50 surviving records |
| Graph connectivity | 10 | 40 links in the evidence subgraph |
Each hypothesis card is anchored to that measured number, then scaled by its own evidence balance. Receipts for it nudge the score up, capped; receipts against it pull it down, harder and also capped. The cards sort highest first.
Generate initiative if you want a scored numberRelated resources
Fix "I could not find grounded evidence"
This is the system working. Here is how to read the message, and what to change before you ask again.
One constraint shapes most of what follows: when Vernais answers from your connected data, every claim has to trace back to a record it can point at. It will not invent a cause. A question it cannot ground in your data returns nothing rather than a guess. Questions about the outside world, or about general knowledge, it answers like any good assistant — and tells you which world the answer came from.
What the message means
You asked a why-question. The investigation ran, then ended with this:
I couldn't find grounded evidence for this in your connected tools. The closest area was <topic>, but no records there actually speak to your question — so I won't guess. Try naming a specific tool, metric, or time frame, or rephrasing the question.
Here is the machinery behind it. Every candidate record is judged on its own by a small AI juror. The juror votes one of three ways: this supports the idea, this contradicts it, or this is neutral. To take a side, the juror has to copy a real quote out of that record. If the quote is not really in the record, the vote drops to neutral. Records that survive with a real quote become your evidence.
This message means zero records survived. Not few — zero. That is why there is no confidence badge on it. There is nothing to be confident about, so nothing is claimed.
Read this as a scope problem, not a bug: your question and your data did not meet.
Work through the causes in order
Start at the top. The first two are workspace-level and cost nothing to rule out — you can check both from the Data section before you touch your wording.
- 1The brain has not been run here
Open
Data. If it readsNo knowledge-graph data yet, the map does not exist yet. Syncing a tool brings records in raw. Corvex is the separate step that turns them into the graph Vernais reasons over. Go toIntegrationsand run Corvex once. It runs 15 stages and takes a few minutes. Running it needs an elevated permission, so ask your workspace owner if you cannot see the button. - 2The tool holding the evidence is not connected
Open
Dataand read theSourcefilter. Each row carries the real number of records that tool put into this workspace's graph. If the tool you expect is missing there, Vernais has never seen its data. Connect it and sync it. Each workspace has its own graph, so a tool connected in another workspace does not count here. - 3The question named a tool that does not hold it
Naming a tool folds all of its records into the search and seeds the search there. A named tool with no records in your workspace is dropped instead. Three tool names are ordinary English words — teams, linear, notion — so they count as tools only with context. Write
in Linearorlinear ticket, neverthe linear drop in signups. If you are not sure the evidence lives in that tool, drop the name and ask again. - 4The window has no data
A live sync is capped, not a full history backfill. Each stream stops at 20 pages or 2,000 records. Analytics exports such as Amplitude and Mixpanel cover about the last 30 days. Ask inside the period you actually synced. To check what you have, open
Data, filter to that tool, and sort byMost recent. - 5The question was too broad
Vernais matches your wording against the topics it discovered in your own data. A question with no symptom and no subject matches nothing worth entering. "why is our product bad?" gives the search nowhere to push off from. Rewrite it with a symptom, a subject, and an anchor — the next section shows how.
Rephrase so the question can land
Give it three things: a symptom, a subject, and an anchor such as a version, an error name, or a date.
Naming a tool is not free. If under a third of the grounded evidence comes from the tools you named, the answer gains a caveat calling that angle tangential. A high confidence is knocked down to medium at the same time. The test: name a tool only when you would bet the evidence is inside it.
What this message is not
Questions people ask
Why is my Data section empty?
Data always reads the active workspace's graph. It stays empty until Corvex has run inside that workspace. Connecting a tool and syncing it is not enough — sync stores raw records, the brain builds the map. Go to Integrations and run Corvex once.I connected Jira yesterday. Why can't it see my tickets?
It named the closest topic. Why didn't it use that?
Data and read its members to see what it actually holds.Develop your intuition
These are starting points, not rules. When you hit this message, ask yourself:
- Was the question too broad — did I give it a symptom and a subject?
- Did I name a tool that does not hold the evidence?
- Did I ask for a cause when I only wanted a count?
- Does my wording use the words my data uses, or my own shorthand?
- Has Corvex ever been run in this workspace?
- Am I asking about a period my synced data actually covers?
Related resources
What Vernais will not do
Vernais refuses five things on purpose. Each refusal exists to stop a confident wrong answer — the most expensive kind there is.
One constraint shapes most of what follows: when Vernais answers from YOUR CONNECTED DATA, every claim has to trace back to a record it can point at. It will not invent a cause. A question it cannot ground in your data returns nothing rather than a guess. Questions about the outside world, or about general knowledge, it answers like any good assistant — and tells you which world the answer came from.
A tool that cannot say "I don't know" cannot be trusted when it says it knows.
It will not invent a cause
A record becomes evidence only when a juror can copy a real quote out of it.
Every candidate record is judged on its own. A small AI juror reads it and votes: does this support the explanation, contradict it, or neither? To take either side, the juror has to copy a real quote from that record. The system then checks that the quote really appears in that record.
No quote means the vote is thrown out. It drops to neutral. So a record cannot become evidence because it sounded right. Only because a sentence in it actually exists.
Why — an invented cause needs invented evidence. Invented evidence has no quote behind it, so it never survives the vote. This is the single check that makes the rest of the answer worth reading.
It will not store a cause as a fact
The graph holds records and provable links. It never holds a why.
Vernais writes down what your data literally says. Two records touch the same version. One ticket names another by number. A charge failed at 4:02. Each of those has a receipt.
"The v2.2.1 deploy caused the promo failures" is in no record. Nobody wrote it down. So Vernais never stores it. The cause is worked out fresh, the moment you ask, from evidence gathered right then. Even the timeline you read is derived at question time.
Why — a stored cause ages badly. It gets copied into a doc, quoted in a review, and believed months after the data it came from moved. A derived cause carries its evidence with it, every single time.
Deriving a cause is real work, so an investigation takes a few minutes. Asking the same question on unchanged data is designed to return the same answer — the reasoning is cached against a fingerprint of the graph. Add data, the fingerprint changes, and it thinks again.
It will not answer a data question it cannot ground
Every number about your data comes from a tool call you can see in the timeline.
For any question about your connected records — a count, a list, a top 5 — the model has to call a data tool before it answers. It cannot answer from memory. It cannot guess a number. It cannot even tell you it lacks access without trying first, because the tools are its access. When a tool returns nothing, it says so in those words.
An investigation runs a harder version of the same rule. If not one record survives the jury, the run stops and tells you so. It reports that it found no grounded evidence, names the closest area it looked in, and says it will not guess. No confidence badge appears, because there is nothing to be confident about.
hypothesis only at low confidence, with the missing test namedThe no-evidence message tells you to name a specific tool. Do that only when you are confident the evidence is there. If your named tools supply under a third of the grounded evidence, the answer gains a "treat that angle as tangential" caveat, and a high confidence drops to medium. The test: could you say which record in that tool proves it? If not, leave the tool out and let the search find it.
It will not take your word over your account
Who you are comes from your signed-in account, and from nothing else.
Two kinds of source exist here, and Vernais keeps them apart.
Your account record. Signed in, checked, authoritative.
Anything you say about yourself: a chat message, your own site, your LinkedIn, a bio you wrote.
Those are all you, speaking through different channels. Your own site repeating your claim adds nothing. It is the same assertion wearing a citation. So Vernais will not web-search to settle who you are — a search there hands your words back to you and makes them look proven.
It will not argue, either. It says once that the account lists one thing while you are telling it another, points you to Settings → Profile, then answers your real question. Edit the account and the answer changes.
Why — your title shapes what the AI assumes about your work. A title it adopted because you repeated it would be a fact with no source, and it would outlive the conversation that created it. Asking a fourth time is not evidence.
It will not edit your code
The code analyst reads, searches, and traces. It holds no tool that writes.
Ask about the source and it plans, searches by meaning, searches for exact strings, reads files, and follows the call graph. It answers with exact path:line citations, and a checker on the server verifies each one against the files it actually opened.
It cannot change a line. This is not a rule it was asked to follow nicely. No write tool is registered, so there is nothing for it to call. Its shell access is an allowlist of read-only inspection commands.
Two more edges sit around it. Only a repo URL you typed in that message can be cloned — not one from earlier in the thread, and not one it found itself. And the whole capability is permission-gated: without codebase.analyze, one of the AI permissions an owner assigns, the code tools are left out of its belt entirely.
What it answers without hesitation
The refusals above are narrow on purpose. They cover your data and your identity. They are not a rule about knowledge in general, and reading them that way would make the tool useless.
Ask what a transformer is and it explains. Ask for an opinion and you get one. Ask about the news, a price, or a public company and it searches the web, reads the pages, and cites them with numbered chips. Tell it not to search and it answers from what it knows. It will not refuse the question.
| You ask | Where the answer comes from | What happens |
|---|---|---|
| what is a transformer? | Model knowledge | answers directly, no tool |
| latest news on tesla | The public web | searches, reads pages, cites them |
| who is the ceo of openai? | The public web | an outside person is a fair web question |
| how many stripe charges failed? | Your connected data | runs a counting tool, or reports that it returned nothing |
| who am i? | Your account | reads the account record, never searches |
The answer always tells you which of those worlds it came from. That is the whole point of the constraint, not a side effect of it.
Related resources
What Vernais knows about you
It answers who you are from your account, not from what anyone types in chat — including you.
One constraint shapes most of what follows: when Vernais answers from your connected data, every claim has to trace back to a record it can point at. It will not invent a cause. A question it cannot ground in your data returns nothing rather than a guess. Questions about the outside world, or about general knowledge, it answers like any good assistant — and tells you which world the answer came from.
Who you are is a record too. Your account is that record. Vernais reads it on every message, and it does not take your identity from anywhere else.
Two kinds of source
Your account is verified. Everything else said about you is a claim.
Vernais sorts information about you into two buckets, and it never mixes them.
Your signed-in account. Vernais reads your name, email, title, and About you line from it, plus which workspace you are in.
Anything you say about yourself: a chat message, your personal site, your LinkedIn, your GitHub profile, a bio you wrote.
The second bucket is the surprising one. Your own website is not proof. It is you, speaking through a different channel. If you tell Vernais you are the founder, and then send it a link to your site that says you are the founder, it has one claim, not two. Nothing was confirmed. The link is the same claim wearing a citation.
The answer to "so who am I?" does not change because you asked a fourth time.
Why it holds the line
This is an anti-impersonation guard. Your name and title travel: they sit on your profile card, and they are attached to the things you create. A title accepted in a chat box would spread from there.
Picture the rule without the guard. Anyone in a chat box could type a title and be believed. Anyone could paste a link to a page they made an hour ago and be believed twice. Repetition would work, because a model that gives ground once tends to give ground again. So the guard is not about doubting you. It is about the fact that a chat message and a self-published page carry the same weight — and that weight is not enough to change a record.
What it does when you disagree
It says so once, plainly, and moves on. You will get something close to: your account lists this title, you are telling it that one, and it can only verify the account. Then it answers your actual question.
It will not tell you it is taking the correction. It will not promise to treat you as the new title going forward. It will not call your account stale. It cannot know that, and it cannot edit your account from a chat message. Saying otherwise would be a promise it has no way to keep.
Settings → Profile, then ask againThat second line matters. A web search about you can only return what you published about yourself. It would hand back your own claim with a source number next to it. That produces confidence, not evidence — so the search is refused for you and allowed for everyone else.
Change the record, not the chat
To change what Vernais says about you, edit your profile — that is the record it reads.
Open Settings → Profile. Three fields shape how you are described:
- Display name — up to 80 characters. Shown on activity, on the member list, and on anything you create.
- Role / title — up to 120 characters. This is the title Vernais reports when you ask what your role is.
- About you — up to 300 characters. A short line about what you do, shown on your profile card.
Save, and the change is authoritative. It is not a request Vernais weighs against your chat history. It is the record. Changing the email you sign in with works differently — you confirm from the new address before it takes effect.
Your account is cached for about a minute to keep replies fast. A profile edit lands within that minute, not always on the very next message.
A name you ask to be called is a nickname, not an identity. Vernais can use it in the conversation, but it never replaces the verified name on your account. To be called something different everywhere, change Display name in Settings → Profile.
What it remembers between chats
Vernais keeps durable preferences across conversations. How you like answers shaped, what you care about, a standing goal, a constraint you work under. Those carry from one chat to the next, so you do not repeat yourself.
Identity claims never make that trip. When a turn ends, a background pass pulls out anything durable you revealed. A guard then reads each candidate before it is written. Any line that asserts your name, role, job title, or employer is dropped on the spot. The same guard runs again when memory is read back — so if a claim ever slipped in, it stops surfacing and heals itself.
So the split is clean. Your profile answers who you are. Memory answers how you like to work. Neither one can quietly become the other.
