Documentation / AI Clinical Assistant
AI Clinical Assistant
The Folklore AI Assistant provides conversational access to the current case, recorded variant evidence, and the local literature index. It helps geneticists inspect results, compare findings with the phenotype, and prepare reviewable clinical interpretation drafts.
Model inference runs on dedicated infrastructure within the EU. Case data is not sent to external hosted language-model services during assistant use.
How It Works
Context Loading
When a conversation starts, the assistant loads the complete analysis context for the current case: ACMG classifications, pathogenic variants, phenotype matching results, screening tiers, clinical profile, and any previously generated interpretation.
Natural Language Interaction
The geneticist asks questions in natural language. The assistant can answer directly from its clinical knowledge, or invoke tools to query the patient database or search the literature database.
Tool Execution
When a question requires data, the assistant automatically translates it to SQL, executes it against the appropriate database, and incorporates the results into its response. Up to five sequential tool calls can be chained in a single interaction.
Streaming Response
Responses are streamed in real-time via Server-Sent Events. Text appears token by token, with structured events for query results, literature findings, and visualization suggestions.
Key Principles
The assistant only discusses genes and variants that are present in the patient's data. It does not invent findings or add textbook examples that are not in the actual results.
All responses are grounded in the analysis data. When the assistant references a variant, it has either seen it in the loaded context or queried it from the database.
The assistant uses a phenotype-first approach: it considers the patient's clinical presentation to identify candidate genes, then checks whether those genes appear in the variant data.
Clinical interpretation reports clearly separate AI-generated content from template-based sections (patient demographics, legal disclaimer). The AI never fabricates patient information.
Conversation history is maintained for 24 hours in an encrypted cache, enabling multi-turn discussions that build on previous questions and findings.
EU-Hosted Model Inference
The Folklore AI Assistant runs on dedicated GPU infrastructure within the EU and is accessed through an internal service path. This design keeps model inference within the controlled processing environment and supports the platform's data-protection controls.
In This Section
Capabilities
What the Folklore AI Assistant can do: variant queries, literature search, interpretation drafting, report generation, and visualization.
Asking Questions
How to interact with the AI assistant effectively -- question patterns, tool invocation, and multi-turn conversations.
Clinical Interpretation
AI-generated diagnostic reports with four interpretation levels, structured headers, and legal disclaimers.
Database Queries
Natural language to SQL translation against patient variant and biomedical literature databases.