FreeMee — Failure Analysis

Failure analysis is FreeMee's ability to turn the noisy history of an asset or work order into a ranked list of plausible root causes plus concrete next actions. It's included on every plan (metered by your monthly FreeMee AI credits). It runs a reasoning model over a structured case file (history, downtime, meters, peer assets) and — when documents are uploaded — over the relevant chapters of your own manuals and SOPs.

How to run an analysis

Open any asset or work order detail page and click 'Analyze with FreeMee'. Optionally add a one-line symptom hint to focus the analysis (e.g. 'unusual noise on startup'). The model returns a summary, 2–5 ranked hypotheses with evidence, 2–5 recommended actions, and citations to the documents it drew from. Past analyses are listed at /ai-sherlock for re-review and audit.

How the RAG layer works

When you upload a PDF or DOCX in the Documents module, FreeMee extracts the text, splits it into ~1200-character chunks with overlap, embeds them via the same provider used by the chatbot cache, and stores them per-tenant. At analyze time it pulls the top-4 most semantically relevant chunks and injects them into the prompt. Ingestion is best-effort and fire-and-forget: uploading is never blocked, and RAG silently degrades to structured-context-only if extraction or embedding fails.

Strict tenant scoping

Every context query is filtered by company. Data belonging to another tenant is never reachable — a request for it returns 'not found' rather than 'forbidden', so its very existence stays private. Document retrieval is company-scoped at the database level too, and every analysis is kept in an audit trail.

Permissions and tier gating

• Feature: AI_SHERLOCK — available on every plan, including free Core. Access is metered by FreeMee credits (5 per analysis) rather than restricted by tier.
• Permission: ai:sherlock — seeded for ADMIN by default. Grant via /people/roles for any other custom role.
• Analysis results never override your data — they're advisory; verify against your maintenance procedures before acting.

Cost and configuration

Each analysis costs 5 FreeMee credits, drawn from your company's monthly allowance. Indexing your documents costs nothing. Your remaining balance is shown in the app, and every AI action appears in your credit history.