TotalApp Docs

Finding Similar Records

How AI-powered screens across TotalApp find and rank the records most relevant to what you're working on, before running a deeper AI analysis.

Overview

Some screens across TotalApp — particularly in the Patent & R&D Operations and Customs & Global Trade Operations add-ons — need to find the records most relevant to what you're currently working on before they can give you a useful AI-powered analysis. Rather than asking the AI to reason over your entire list of records at once (slow, and easy to overwhelm with irrelevant material), these screens rank your records by relevance first, then hand only the closest matches to the AI.

This ranking step is called Finding Similar Records, and it works the same way everywhere it appears: your search text and every candidate record are converted into numeric representations of their meaning (not just their exact wording), and the candidates are sorted by how closely their meaning matches yours. This is the same underlying technology behind Semantic Search in My Knowledge and the Writer Tools — it's the same idea, applied to a screen's own records instead of your personal knowledge library.

In one sentence

Before running a deep AI analysis, some screens first show you a short, ranked list of your most relevant existing records — so the analysis that follows is more focused and more accurate.

How It Works

You type or paste text
Records are ranked by relevance
You review and select matches
AI analyzes only what you selected

On a screen that supports this, you'll see a button like "Search Similar Rules" or "Find Similar Patents" above or inside the AI analysis form. Clicking it ranks your existing records against whatever you've typed so far, and shows the closest matches — usually the top handful, not the whole list — each with a small relevance percentage. You can then narrow that selection further (uncheck anything that isn't actually relevant) before running the AI analysis itself, which only considers the records you've kept selected.

Meaning, not keywords

Two records can be ranked as closely related even if they don't share any of the same words — the comparison is based on what the text means, not on literal text matching.

Focused AI results

Handing the AI a short, relevant shortlist instead of your entire record list produces sharper, more specific analysis and avoids diluting the result with unrelated records.

You stay in control

The ranked matches are suggestions, not a final decision — you review and deselect anything before the AI analysis step runs on them.

Runs on your own computer

The ranking step never sends your records to TotalApp's servers — it uses a local AI model running on your own machine (see "Where It Runs" below).

Where It Runs

Finding Similar Records always runs locally, through Ollama on your own computer — it never proxies through TotalApp's servers, regardless of which AI engine you've selected for the deeper analysis that follows it. This means:

  • Your records and search text never leave your machine for the purpose of ranking.
  • You need Ollama installed and running, with an embedding model selected in Settings → Agentic — see Embedding Model for setup.
  • The deeper AI analysis step that follows (interpreting the matches, producing a risk score, a diagnostic summary, etc.) is separate and follows your usual Settings → Agentic AI engine choice — it can run locally or route through TotalApp's server, independently of the ranking step above.

Two separate steps, two separate settings

Ranking (this feature) always uses your local embedding model. The AI analysis that follows always uses your chosen AI engine. Changing one setting never affects the other.

Graceful Fallback

If your local AI model for ranking isn't set up, or isn't reachable, screens never fail outright:

  • If a simple keyword match can still find something relevant in your records, you'll see those results instead, clearly marked as a less precise fallback.
  • If nothing relevant can be found at all, you'll see a message explaining that no similar records were found, with a pointer to set up an embedding model for better results.
  • Either way, you can still run the deeper AI analysis directly, without a ranked shortlist — it will simply consider a broader set of records instead of a narrowed one.

For Developers

This page is the plain-language explanation. For the technical reference — the shared engine every screen's ranking is built on, its caching and fallback logic, and how a new screen wires into it — see Knowledge Engine under Engines.

Where You'll See This Today

Add-onWhat it ranks
Patent & R&D OperationsCompetitor patents, prior art references, academic literature, legal guidelines, market benchmarks, grant requirements — depending on the screen
Customs & Global Trade OperationsTrade compliance and sanctions rules, ranked against a proposed shipment's details

This same underlying technology is designed to be reused by any future screen that needs to shortlist its own records before an AI analysis — the list above will grow over time.

Frequently Asked Questions

Is this the same as Semantic Search in My Knowledge?
It's the same underlying technology, applied differently. Semantic Search ranks your personal knowledge library for the Writer Tools; Finding Similar Records ranks a screen's own operational records (patents, compliance rules, etc.) before an AI analysis on that screen.
Do I have to use it before running an AI analysis?
No. On every screen where it appears, it's an optional first step. You can always skip straight to the AI analysis with your full, unranked record list.
Why do I need to click a separate button instead of it happening automatically?
Ranking is a distinct step so you can review and adjust the shortlist before committing to an AI analysis — and because it depends on your local Ollama setup, which not every user has configured. Skipping straight to analysis always works as a fallback.
Does this send my data anywhere?
No. The ranking step runs entirely on your own computer through your local Ollama instance. Nothing is sent to TotalApp's servers for this purpose.
Why does the relevance percentage sometimes disappear?
When your local AI model for ranking isn't available, screens fall back to a simpler keyword match — which doesn't produce a reliable percentage score, so it's hidden rather than shown as misleading.