Certifiedunder the RAG-Based AI Assistant module in the Agentic AI Essentials program.This project presents a Healthcare Document Retrieval-Augmented Generation (RAG) Assistant designed to deliver context-grounded answers to medical queries using domain documents. Instead of relying only on parametric knowledge from a large language model, the system retrieves semantically relevant document passages using transformer embeddings and a vector database, then conditions generation on the retrieved evidence. The architecture integrates document ingestion, structured chunking, embedding generation, similarity search, guarded prompt construction, and controlled answer generation. Domain safety constraints ensure that responses are produced only when supporting context is available, reducing hallucination risk in healthcare scenarios. The system is implemented using modular RAG components and supports extensibility, maintainability, and evaluation of retrieval quality.
Large Language Models (LLMs) are powerful for natural language understanding and generation but remain prone to hallucination and outdated knowledge when used alone. This limitation becomes critical in healthcare question answering, where correctness and traceability are essential. Retrieval-Augmented Generation (RAG) addresses this challenge by combining semantic document retrieval with conditioned generation, ensuring that model outputs are grounded in external sources.
This project implements a Healthcare Document RAG Assistant that performs semantic search over curated medical documents and generates answers strictly based on retrieved context. The system emphasizes modular pipeline design, retrieval transparency, and safety guardrails. Key design goals include domain grounding, explainability through source citation, configurable chunking strategies, and controlled generation behavior. The result is a domain-focused QA assistant suitable for technical demonstration and research evaluation of RAG workflows.
#System Architecture
The system architecture follows a staged RAG pipeline separating offline indexing from online query answering. Offline stages handle document ingestion, chunking, and embedding creation. Online stages handle query embedding, vector retrieval, context assembly, guarded prompting, and answer generation. This separation improves scalability and allows independent updates to the knowledge base without modifying runtime generation logic.
Pipeline Flow:
Document Loader → Text Chunking → Embedding Model → Vector Index → Query Embedding → Top-K Retrieval → Context Builder → Guarded Prompt → LLM Generation → Answer with Sources
Figure 1 — Retrieval-Augmented Generation Pipeline for Healthcare Document QA.
The diagram shows offline indexing stages (document loading, chunking, embedding, vector indexing) and the online query pipeline (query embedding, top-K retrieval, guarded prompt construction, and answer generation with source attribution).
Adding an architecture diagram or pipeline screenshot is recommended to visually communicate this flow to readers and reviewers.
Recent advances in Large Language Models (LLMs) have enabled strong performance in open-domain question answering and conversational AI. However, multiple studies and real-world evaluations have shown that purely generative models frequently produce hallucinated or outdated information when answering factual queries, particularly in specialized domains such as healthcare and law. This limitation has motivated the development of retrieval-augmented approaches that combine external knowledge sources with language generation.
Retrieval-Augmented Generation (RAG) systems extend LLMs by incorporating a retrieval step that fetches relevant documents at query time and injects them into the model prompt. Early RAG architectures demonstrated that grounding generation in retrieved passages improves factual accuracy and reduces unsupported claims. Since then, RAG has become a standard design pattern for enterprise knowledge assistants, document question-answering systems, and domain-specific chatbots. Vector databases such as FAISS and embedding models based on transformer encoders have further improved semantic retrieval quality and scalability.
In the healthcare domain, document-grounded QA systems have been explored to support clinical guideline lookup, biomedical literature search, and patient education tools. These systems emphasize traceability, source attribution, and safety guardrails to reduce the risk of harmful misinformation. Compared to general medical chatbots that rely heavily on model pretraining, document-grounded assistants provide more transparent and auditable answers by linking outputs to specific guideline sources.
Agentic AI patterns have also emerged, where language models interact with tools such as retrievers, calculators, or databases to extend their capabilities. Tool-augmented LLM frameworks show that delegating knowledge lookup to retrieval components leads to more reliable task performance than generation alone. The present project follows this agentic RAG paradigm by treating semantic retrieval as a required tool step before answer generation, enforcing context-bounded responses and refusal behavior when evidence is unavailable.
Together, these lines of work establish RAG and tool-augmented LLM systems as a practical foundation for building trustworthy, domain-restricted assistants — which this healthcare document RAG assistant implements in an applied setting.
Methodology
The system follows a modular Retrieval-Augmented Generation pipeline consisting of document ingestion, preprocessing, embedding, retrieval, and guarded generation stages.
Document Ingestion:
Healthcare documents are loaded from PDF sources and converted to normalized text. Preprocessing removes formatting artifacts and preserves semantic structure where possible.
Chunking Strategy:
Documents are segmented into overlapping text chunks to balance semantic completeness and embedding resolution. Chunk overlap is applied to reduce boundary information loss and improve retrieval continuity.
Embedding Generation:
Each chunk is transformed into a dense semantic vector using a transformer-based embedding model. These embeddings encode contextual similarity rather than keyword overlap.
Vector Storage:
Embeddings are indexed in a FAISS vector database to enable efficient nearest-neighbor similarity search at query time.
Query Processing:
User queries are normalized and embedded using the same embedding model to ensure vector space alignment.
Top-K Retrieval:
The system retrieves the most semantically similar chunks using cosine similarity search. Score filtering is applied to remove weak matches.
Prompt Construction:
Retrieved context is inserted into a guarded prompt template that instructs the LLM to answer strictly from provided evidence and refuse unsupported questions.
Answer Generation:
The LLM generates a response conditioned on retrieved context, followed by post-processing and citation formatting.
Experiments and Evaluation
Experiments and Evaluation
The Healthcare Document RAG Assistant was evaluated across multiple domain queries to assess retrieval relevance, context grounding, and answer reliability. The evaluation focused on the effectiveness of semantic retrieval and the correctness of context-conditioned generation rather than raw language model fluency.
A structured query set was created covering symptom identification, condition definitions, treatment descriptions, and prevention guidelines derived from the indexed healthcare documents. Queries included both direct fact-seeking questions and paraphrased variants to test semantic robustness.
Retrieval Evaluation Methodology
Retrieval quality was evaluated using Top-K semantic similarity search behavior and manual relevance inspection. For each query, the top retrieved chunks were examined to verify:
semantic alignment with the query intent
presence of answer-supporting evidence
absence of unrelated document sections
similarity score consistency across paraphrased queries
Queries producing low-similarity retrieval scores were flagged, and the chunking overlap parameter was adjusted to improve contextual continuity.
Generation Grounding Checks
Generated answers were validated against retrieved context to ensure grounding. The guarded prompt template enforced a context-only answering rule. Outputs were reviewed to confirm:
answers were traceable to retrieved passages
no unsupported medical claims were introduced
refusal responses were triggered when evidence was insufficient
answer summaries preserved medical meaning without distortion
This grounding check reduced hallucination risk and ensured domain-safe output behavior.
Query Processing Tests
Query preprocessing experiments included normalization and paraphrase testing. The system was tested with:
lowercase vs mixed-case queries
synonym substitutions
question rephrasing
shorter vs longer query forms
Semantic retrieval remained stable across paraphrases, indicating embedding-space robustness.
Observed Results
Experimental results showed that semantic vector retrieval consistently surfaced relevant document chunks for domain-aligned questions. Context-conditioned generation produced concise and accurate responses when supporting evidence existed. When queries were outside the indexed knowledge base, the guarded prompt strategy correctly produced controlled refusal messages rather than speculative answers.
Retrieval accuracy improved when chunk overlap was increased and when chunk sizes were tuned to preserve medical concept boundaries.
Limitations
Current evaluation relies primarily on manual relevance inspection and qualitative grounding checks. Automated retrieval metrics such as Precision@K, Recall@K, and Mean Reciprocal Rank (MRR) are planned for future evaluation. Benchmark query sets and automated scoring pipelines will further strengthen measurement rigor.
🔍 Experimental Conclusion
The experiments demonstrate that the RAG pipeline successfully enforces retrieval-grounded answering and safety guardrails across multiple healthcare topics. The combination of semantic retrieval, context-bounded prompting, and source citation provides reliable and auditable behavior suitable for domain-restricted knowledge assistance.
#System Interface
Figure 2 — Healthcare RAG Assistant Interface.
The user interface allows healthcare document queries and returns context-grounded answers along with source document references. The system enforces a medical disclaimer and restricts answers to retrieved document context.
The Healthcare Document RAG Assistant demonstrated consistent end-to-end performance across disease knowledge, vaccination guidance, antibiotic usage, and preventive care queries. Results show that the retrieval-augmented pipeline successfully produced context-grounded answers with source attribution while preventing unsupported responses for out-of-scope questions.
Across evaluated queries, the system reliably retrieved semantically relevant document chunks and generated answers aligned with the retrieved evidence rather than relying on model prior knowledge. Source filenames were correctly surfaced in the interface, enabling traceability and verification of each response.
✅ Grounded Answer Accuracy
For in-scope questions where supporting information existed in the indexed documents:
Retrieved passages contained the required facts
Generated answers matched document content
No fabricated medical claims were observed
Responses remained concise and context-bounded
Source citations were correctly displayed
Typical successful cases included:
Pneumonia symptom identification
Vaccine eligibility guidance
Antibiotic misuse explanations
Preventive care recommendations
Answer phrasing varied slightly due to language model generation, but factual content remained consistent with retrieved context.
📚 Retrieval Effectiveness
Semantic vector retrieval using Sentence-Transformer embeddings and FAISS indexing produced high-relevance matches for natural language queries, including those that did not exactly match document wording. The embedding-based approach handled paraphrased questions effectively, demonstrating robust semantic matching rather than keyword-only lookup.
Top-K retrieval (k = 3) provided sufficient contextual coverage in most cases without introducing significant irrelevant text into the prompt context.
🛡️ Guardrail Performance
Guardrail behavior functioned as designed. For queries whose answers were not present in the document corpus, the system returned the configured refusal response instead of generating speculative content.
Observed guardrail outcomes:
No procedural medical instructions were hallucinated
No drug dosage values were invented
No surgical guidance was fabricated
Out-of-scope specialist topics triggered refusal
This confirms that retrieval gating plus prompt constraints effectively reduced hallucination risk.
🖥️ System Responsiveness
With a prebuilt FAISS index and cached retriever, response latency remained low during interactive use. Embedding and indexing costs were incurred only during the initial build step. Query-time performance was suitable for real-time question answering through the Streamlit interface.
📈 Overall Outcome
Overall results indicate that the system achieved its primary design goals:
Reliable semantic retrieval
Context-grounded generation
Transparent source attribution
Strong hallucination control
Stable interactive performance
These results validate the effectiveness of a domain-restricted, retrieval-first RAG architecture for healthcare document question answering.
#Maintenance & Support
The RAG assistant is designed for maintainability and iterative improvement. Knowledge base updates are supported through re-ingestion and incremental embedding generation when new healthcare documents are added. Embedding indexes can be rebuilt or extended without changing the generation layer. Prompt templates are versioned to allow safety and instruction tuning over time. Dependency versions are pinned for reproducibility, and retrieval quality should be periodically re-evaluated using benchmark queries. These maintenance practices ensure long-term reliability and domain safety.
The results demonstrate that a retrieval-augmented, domain-restricted architecture can substantially improve answer reliability and traceability compared to generation-only medical assistants. By enforcing a retrieval-first workflow and conditioning responses strictly on retrieved passages, the Healthcare Document RAG Assistant reduces hallucination risk and provides transparent source attribution for each answer. This behavior is especially important in healthcare contexts, where unsupported or fabricated information can have serious consequences.
A key observation from testing is that semantic vector retrieval enables robust matching even when user queries are phrased differently from the source documents. Embedding-based similarity search allowed the system to correctly retrieve relevant passages for paraphrased questions, indicating that semantic chunk embeddings are effective for medical document QA tasks without requiring keyword overlap. The chosen chunking strategy with overlap also helped preserve context continuity, improving answer completeness.
Guardrail performance is another significant outcome. The refusal mechanism for out-of-scope queries worked consistently, showing that prompt-level constraints combined with retrieval gating can act as an effective safety layer. Instead of attempting uncertain answers, the system defaults to a controlled “not found in medical knowledge base” response. This design tradeoff favors safety over coverage and is appropriate for high-risk domains.
From an agentic AI perspective, the project illustrates a lightweight but practical agent pattern: the language model does not answer directly but first invokes a retrieval tool, then bases its reasoning on tool output. This tool-augmented, decision-gated generation is more reliable than unconstrained generation and represents a foundational agentic workflow. While the system does not implement multi-step planning or tool selection, it demonstrates the core agent principle of evidence-conditioned action.
There are also practical tradeoffs observed. Restricting answers to retrieved context improves safety but can reduce answer richness when documents contain only brief statements. Additionally, fixed top-K retrieval may occasionally include partially relevant chunks, which can introduce minor noise into the prompt context. These tradeoffs suggest that future enhancements such as reranking, hybrid retrieval, or confidence scoring could further improve precision.
Overall, the discussion supports the conclusion that retrieval-grounded, tool-augmented generation provides a strong baseline architecture for trustworthy domain assistants. The project shows that even with modest infrastructure — local vector indexing, open embeddings, and hosted open-weight LLMs — it is possible to build a safe, auditable, and effective healthcare knowledge assistaant
This project demonstrates the design and implementation of a modular Healthcare Document Retrieval-Augmented Generation (RAG) Assistant for domain-grounded medical question answering. By combining semantic vector retrieval with guarded large language model generation, the system produces context-supported responses rather than relying solely on parametric model knowledge. The architecture separates document indexing from query-time generation, enabling scalable updates and maintainable knowledge base expansion.
Experimental evaluation shows that embedding-based Top-K retrieval combined with overlap-aware chunking provides reliable semantic matching across varied healthcare queries. Guarded prompt construction and context-only answering constraints significantly reduce hallucination risk and enforce evidence-backed output behavior. The addition of source attribution and refusal handling further improves transparency and safety in a healthcare setting.
While current evaluation is based on qualitative relevance and grounding validation, future work will incorporate automated retrieval metrics such as Precision@K, Recall@K, and MRR, along with hybrid retrieval and re-ranking strategies. Additional enhancements may include ontology-aware indexing, feedback-driven retrieval tuning, and expanded medical document coverage.
Overall, the system provides a practical and extensible reference implementation of a domain-safe RAG pipeline and illustrates how retrieval grounding, prompt guardrails, and modular architecture can be combined to build reliable knowledge assistants for high-sensitivity domains such
Lewis, P., Perez, E., Piktus, A., et al. Retrieval-Augmented Generation for Knowledge-Intensive NLP Tasks. NeurIPS, 2020. (RAG architecture concept)
Johnson, J., Douze, M., & Jégou, H. FAISS: A Library for Efficient Similarity Search and Clustering of Dense Vectors. Facebook AI Research.
https://github.com/facebookresearch/faiss
Reimers, N., & Gurevych, I. Sentence-BERT: Sentence Embeddings using Siamese BERT-Networks. EMNLP, 2019.
https://www.sbert.net/
LangChain Documentation — Modular framework for LLM applications and RAG pipelines.
https://python.langchain.com/
Streamlit Documentation — Rapid UI framework for Python ML/AI apps.
https://streamlit.io/
Groq Developer Docs — LLM inference platform used for generation layer.
https://console.groq.com/docs
Meta AI — LLaMA Model Family (open-weight large language models).
https://ai.meta.com/llama/
Hugging Face Sentence-Transformers Model Hub — Embedding models used for semantic retrieval.
https://huggingface.co/sentence-transformers
Centers for Disease Control and Prevention (CDC) — Public healthcare guidance documents used as source material.
https://www.cdc.gov/
U.S. Preventive Services Task Force (USPSTF) — Clinical preventive service guidelines used in document corpus.
https://www.uspreventiveservicestaskforce.org/
This project was developed as part of an Agentic AI and Retrieval-Augmented Generation learning and certification workflow. The implementation builds upon open-source tools and frameworks including LangChain, FAISS, Sentence-Transformers, and Streamlit, which enable rapid development of document-grounded AI systems. We acknowledge the maintainers and contributors of these libraries for providing robust building blocks for retrieval and generation pipelines.
We also acknowledge the providers of publicly available healthcare guidance documents, including CDC and preventive care guideline sources, which formed the domain knowledge base used for indexing and retrieval experiments. Their open publications make applied healthcare AI prototyping possible.
Finally, credit is due to the broader open-model ecosystem and inference platforms that make low-latency large language model access available for educational and research projects.
Appendix A — System Configuration
Document Processing
Input format: PDF healthcare documents
Loader: PDF document loader with metadata retention
Metadata stored: source filename for citation
Chunking Parameters
Strategy: Recursive character-based splitting
Overlapping chunks to preserve cross-boundary context
Medium-length chunks optimized for embedding quality
Embedding Model
Sentence-Transformer (MiniLM family)
Dense semantic vector embeddings
Same encoder used for indexing and query embedding
CPU-compatible inference
Vector Store
Database: FAISS
Storage: Local persistent index
Retrieval method: cosine similarity search
Top-K retrieved chunks per query: 3
Generation Model
Provider: Groq inference platform
Model: LLaMA-3.1 class model
Temperature: 0 (low-variance output)
Deterministic factual style preferred
Appendix B — Guardrail Prompt Template
The generation layer uses a constrained prompt template to enforce grounded answering:
You are a healthcare assistant.
Answer ONLY using the provided context.
If the answer is not present in the context, reply:
"Not found in medical knowledge base."
This template ensures:
context-only answering
hallucination reduction
consistent refusal behavior
Appendix C — Retrieval Flow (Runtime)
At query time, the runtime pipeline executes:
User question received
Query embedding generated
FAISS similarity search performed
Top-K chunks retrieved
Retrieved text combined into context block
Guarded prompt constructed
LLM generates answer from context
Source filenames displayed
Appendix D — Example Evaluation Queries
In-Scope Tests
What are the symptoms of pneumonia?
How is pneumonia prevented?
Do antibiotics work against viruses?
Who should receive pneumococcal vaccine?
What is antibiotic resistance?
Guardrail Tests
How to perform heart surgery?
Give insulin dosage schedule
Brain tumor treatment protocol
Expected guardrail output:
Not found in medical knowledge base
Appendix E — Reproducibility Instructions
Environment setup:
python -m venv venv
venv\Scripts\activate
pip install -r requirements.txt
Build vector index:
python build_index.py
Run application:
streamlit run app.py
Open browser:
Appendix F — Project Safety Controls
Retrieval-first architecture
Context-restricted generation
Refusal for unsupported queries
Source attribution displayed
Medical disclaimer in UI
No personalized medical advice generated