# Asystent awarii oparty na instrukcjach serwisowych (RAG) EN: **Retrieval-augmented troubleshooting over technical manuals** · id `maintenancerag` · aliases: RAG for maintenance, technical manual RAG, fault code recommendation, troubleshooting assistant, asystent serwisowy RAG, wyszukiwanie w dokumentacji technicznej Path: [AI Atlas](https://aiatlasgraph.com/llms.txt) › [AI w przemyśle](https://aiatlasgraph.com/t/industrialai.md) › [Asystenci językowi dla przemysłu](https://aiatlasgraph.com/t/industrialassistants.md) › Asystent awarii oparty na instrukcjach serwisowych (RAG) ## Description - PL: Zastosowanie RAG do diagnozy usterek: odpowiedź modelu językowego jest ugruntowana we fragmentach instrukcji technicznych lub tabelach kodów usterek. - EN: Applying RAG to fault diagnosis: the language model's answer is grounded in technical-manual passages or fault-code tables. ## In one sentence - PL: Asystent, który na opis usterki odpowiada fragmentami z instrukcji serwisowych tej konkretnej maszyny, a nie ogólną wiedzą z internetu. - EN: An assistant that answers a fault description with passages from this particular machine's service manuals, not general internet knowledge. ## Problem it solves - PL: Instrukcje mają setki stron, mechanik stoi przy zepsutej maszynie, a ogólny czatbot potrafi z pełnym przekonaniem zmyślić procedurę. - EN: Manuals run to hundreds of pages, the mechanic is standing at a broken machine, and a general chatbot can confidently invent a procedure. ## What it does - PL: Jak doświadczony kolega, który zanim coś doradzi, otwiera segregator z dokumentacją na właściwej stronie i pokazuje palcem. - EN: Like an experienced colleague who, before advising, opens the binder at the right page and points to it. ## Everyday example - PL: Operator wpisuje „pompa hydrauliczna głośno pracuje po rozruchu” i dostaje prawdopodobny kod usterki z odnośnikiem do rozdziału instrukcji. - EN: An operator types 'hydraulic pump runs loud after start-up' and gets a likely fault code with a link to the manual chapter. ## This concerns you if you… - PL: szukasz rozwiązań w grubych instrukcjach maszyn - PL: budujesz czatbota dla serwisu lub utrzymania ruchu - PL: boisz się, że AI wymyśli procedurę naprawy - EN: search thick machine manuals for fixes - EN: are building a chatbot for service or maintenance - EN: worry AI will invent a repair procedure ## Keywords retrieval-augmented generation · fault code recommendation · technical manuals · sentence-transformers · vector database · LLM-as-judge · hallucination rate · PyMuPDF ## How it works - PL: Tekst instrukcji wyciąga się z PDF, dzieli na fragmenty, zamienia na wektory i indeksuje; tabele usterek można indeksować po kodzie. Opis objawów służy jako zapytanie, a znalezione fragmenty trafiają do modelu, który proponuje diagnozę. Ewaluację warto prowadzić na zestawie scenariuszy, nie na pokazach. - EN: Manual text is extracted from PDFs, chunked, embedded and indexed; fault tables can be indexed by code. The symptom description serves as the query and retrieved passages go to the model, which proposes a diagnosis. Evaluation should use a scenario set, not demos. ## Limits - PL: W badaniu na instrukcji pojazdów RAG zmniejszył zmyślenia w swobodnej rozmowie, ale przy wyborze z ustalonej listy kodów samo wyszukiwanie wypadło lepiej niż RAG. Instrukcje bywają skanami z tabelami i rysunkami, a historia napraw często nie jest podłączona. - EN: In a study on a vehicle manual, RAG cut fabrications in free chat, but for picking from a fixed list of codes plain retrieval beat RAG. Manuals are often scans with tables and drawings, and repair history is often not connected. ## Key terms - PL: **RAG**: Model najpierw wyszukuje dokumenty, potem odpowiada na ich podstawie. - PL: **kod usterki**: Ustalony numer opisujący konkretny rodzaj awarii w dokumentacji. - PL: **fragmentacja (chunking)**: Cięcie długiego dokumentu na kawałki do wyszukiwania. - EN: **RAG**: The model first retrieves documents, then answers from them. - EN: **fault code**: A fixed number naming a specific failure type in documentation. - EN: **chunking**: Cutting a long document into pieces for search. ## Know first - [Wyszukiwanie i RAG (Retrieval-augmented generation)](https://aiatlasgraph.com/t/retrieval.md) - [Ekstrakcja tekstu ze stron i PDF (Text extraction from HTML and PDFs)](https://aiatlasgraph.com/t/textextraction.md) ## Related topics Untyped, symmetric "see also" links. - [Wyszukiwanie i RAG (Retrieval-augmented generation)](https://aiatlasgraph.com/t/retrieval.md) ## Sources - [An Evaluation Framework for Fault Diagnosis Using Technical Manuals in Retrieval-Augmented LLMs]() `lukens-rag-fault-diagnosis-manuals-2025` · by Sarah Lukens, Matthew Bishof, Nadir Siddiqui, Destiny West --- AI Atlas revision 122 (2026-10-30) · HTML: https://aiatlasgraph.com/t/maintenancerag · index: https://aiatlasgraph.com/llms.txt · everything: https://aiatlasgraph.com/llms-full.txt · updated 2026-10-30