RAG knowledge assistant for manufacturing

A self-hosted RAG assistant can answer engineers and shop-floor staff from manuals and procedures with citations, inside the plant's own network. This page covers the requirements, platforms and rollout that differ in manufacturing.

On this page

Why a RAG knowledge assistant for manufacturing needs a different plan

A plant engineer needs the current work instruction for a press changeover, and the answer lives in a scanned PDF, a spreadsheet of torque values and a revision folder where three versions of the same procedure sit side by side. A manufacturing assistant must cite the exact procedure revision and run on infrastructure the plant network can reach, because an answer that cannot be traced to a controlled revision is a quality risk, and a cloud service that the shop floor cannot reach is no use at the machine. Those two requirements shape every decision that follows, from parsing to hosting to who may see which documents. The plant network also brings operational technology into scope. The ISA/IEC 62443 series sets security requirements for industrial automation and control systems, and NIST SP 800-82 Rev. 3 covers OT security for SCADA, DCS and PLC environments with performance, reliability and safety requirements attached. An assistant that indexes maintenance procedures sits next to those systems, so the design must keep it out of the control network, decide which zone it belongs in, and document that boundary. NIS2 Annex II also lists manufacturing as a critical sector across NACE Rev. 2 divisions 26 to 30, so confirm with counsel whether your entity is in scope and, if it is, whether incident reporting timelines apply to the assistant's platform. For the platform, *Dify*, *RAGFlow*, *AnythingLLM* and *Open WebUI* all handle document retrieval with citations, but they differ in how they parse tables and scanned pages, how they expose permissions and how their licenses treat internal use. Check the Open WebUI branding clause and Dify's license before you choose, and test each candidate on a sample of your own scanned drawings and revision-controlled procedures. Pair the chosen application with a self-hosted Qdrant instance on plant-accessible storage. Qdrant's documentation says self-deployed instances are unsecured by default and need block storage, so plan authentication and storage from the start.

Which manufacturing requirements shape the build

This table maps each regulatory or security requirement that touches a manufacturing RAG assistant to what it means for network placement, logging, retention and access. Read it before choosing hosting, because several rules decide where the assistant can sit relative to plant networks. The main takeaway is that the assistant should be treated as a connected system in the plant's threat model, not just a document tool.

RequirementWhat it means for the buildEvidence to prepare
IACS security program and zone design (ISA/IEC 62443 series, ANSI/ISA-62443-2-1-2024, ANSI/ISA-62443-3-2-2020)Place the assistant and its vector store in a defined zone outside the control network, with a risk assessment that records which plant data flows reach it and which conduits are allowed.Zone and conduit diagram, risk assessment record, and a list of permitted data flows agreed with the asset owner.
OT monitoring guidance (NIST SP 800-82 Rev. 3)Treat the assistant host as an IT asset that touches OT-adjacent networks, so monitor its traffic, authentication events and changes alongside plant systems.Monitoring coverage map, alert rules for the assistant's network segment, and records of who reviewed alerts.
NIS2 Annex II manufacturing scope and incident reportingManufacturers within NACE Rev. 2 divisions 26 to 30 may fall in scope. Early warning within 24 hours, notification within 72 hours and a final report within one month (Article 23(4)) require logs that can establish a timeline quickly.Incident runbook naming the assistant, log retention long enough to rebuild a timeline, and contact paths to the national authority.
CRA Article 14 reporting for vendors of products with digital elementsApplies to manufacturers of products with digital elements. If the company ships connected products that embed or depend on this assistant, its vulnerability and incident reporting duties need a clear owner for the assistant's components.Software bill of materials for the assistant stack, a vulnerability intake process, and a named reporting owner.
Machinery Regulation Annex III 1.1.9 on connected devicesApplies from 14 January 2027. If the assistant or its connectors can reach machine controllers or remote devices, the design must prevent a connection from leading to a hazardous state, so read-only access to machine data is the safer default.Architecture showing no write path to controllers, connector permission review, and a machinery risk assessment reference.
21 CFR Part 11 electronic records, if records feed regulated quality workIf assistant answers or retrieved procedure versions are used in GxP quality decisions, the system needs audit trails, access controls and controlled document versions. Confirm with quality assurance whether Part 11 applies before design.Validation plan, audit trail configuration, procedure version control records and a sign-off process for changes.
AI Act Article 12 and Article 19 loggingArticle 12(1) requires automatic event logs for high-risk systems over their lifetime. Article 19(1) requires providers to keep those logs for at least six months unless other law sets a longer period. Confirm with counsel whether the assistant is high-risk in its use context.Log schema covering queries, retrieved sources and versions, retention settings and a documented retention period set by counsel.

Which open-source platforms fit plant document assistants

Dify is an LLM application development platform that builds RAG pipelines and agents through a visual interface, with a prompt IDE, support for many model providers and LLMOps monitoring. It fits teams that want to design retrieval flows for maintenance procedures and quality documents without writing a custom pipeline for each one. Its license needs a careful read. Dify is released under a modified Apache License 2.0 that forbids using the source code to operate a multi-tenant environment without written authorization, and one tenant means one workspace. An internal plant assistant with a single organization is usually not a multi-tenant service, but you should confirm this with counsel. The free self-hosted Community edition is limited to a single workspace, so separate plants or business units that need their own workspaces will need the Enterprise edition, which adds SSO and multiple workspaces. Key points to review:

  • Workflow design: Engineers can build and test RAG flows visually, which helps when procedure owners want to review logic.
  • Single-workspace limit: The Community edition covers one workspace, so multi-plant separation may point to Enterprise pricing.
  • Enterprise SSO: SSO with OpenID Connect, SAML or OAuth2 is part of the Enterprise edition, not Community.
  • Deployment footprint: Docker Compose starts several services including PostgreSQL, Redis and Weaviate, so plan for the operations work.
  • Vector store choice: Dify defaults to Weaviate, and Qdrant can be configured instead, so confirm the connector before the build.

Confirm the license reading, workspace model and edition needs in writing before you commit to Dify.

How the rollout moves from one manual set to plant-wide access

The sequence starts with one controlled manual set and widens only after parsing quality, network zoning, access rules and the re-indexing procedure have each been tested and handed over. Each phase produces a named output that the plant owner signs off before the next begins.

  1. Inventory documents and name revision owners

    The team lists the manuals, maintenance procedures and quality documents in scope, records file types, scan quality and where each controlled copy lives, and names an owner for every document family who approves revisions. The output is a document inventory with owners, retention notes and a list of documents excluded from the first phase. The step closes when the plant quality lead confirms that the inventory matches the current controlled revisions.

  2. Agree zone and network design with OT security

    Engineers and OT security staff agree where the assistant, its vector store and its model endpoints sit relative to plant networks, which users in which zones may reach it, and how documents cross from the business network into the index. Reference material for this design includes the ISA/IEC 62443 series, which explains zone and conduit thinking for industrial systems. The output is a signed zone diagram and a list of permitted flows, and the step closes when OT security has reviewed and accepted both.

  3. Run a parsing pilot with an evaluation set

    The team ingests one manual set that includes scanned pages and tables, then builds a question set drawn from real engineering and shop-floor tasks with the expected answer and source page for each. Parsing output for tables and scanned text is checked against the source, and failures are sorted by cause, such as OCR errors, split tables or missing figure captions. The output is a scored evaluation set and a parsing configuration that the plant owners accept, and the step closes when answers cite the correct revision and page.

  4. Harden the Qdrant vector store

    Qdrant is not secure by default, so the engineers bind the service to the intended interface only, configure API keys and enable TLS for REST and gRPC, and define per-collection access for read and write roles where the version supports it. They also enable audit logging of authenticated operations and confirm that no default open listener remains on any host. The output is a hardening record covering keys, TLS and listener checks, and the step closes when a scan from an unapproved network segment fails to reach the service.

  5. Integrate identity and enforce source permissions

    The team connects the assistant to the plant's directory so that staff sign in with their own accounts, and it maps the permissions on each source system to collections or metadata filters so retrieval returns only documents the user may open. Test accounts from several roles, including contractors and shift staff, are used to confirm that restricted procedures never appear in answers or citations. The output is a permission matrix and test results, and the step closes when every test account sees only its approved documents.

  6. Roll out in stages by production line

    Access is granted line by line, starting with a small group of engineers and one shop-floor area, with feedback collected against the evaluation set and on reported wrong answers. Each stage adds a line only after the owners of that line's documents have reviewed the answers and the logs show no access outside the approved groups. The output is a stage log that records which lines are live, open issues and who approved each expansion, and the step closes when all lines in scope are live with agreed support contacts.

  7. Hand over the re-indexing procedure on revision change

    DeployOpen documents how a new revision of a controlled document is approved, ingested, re-indexed and retired from the index, including how the superseded revision is removed so that old procedures cannot be cited. The plant team runs one revision change under supervision and then performs a second one alone. The output is a written runbook, a revision checklist and a record of both changes, and the step closes when the plant owner confirms that a retired revision no longer returns in answers.

Integration points between the plant network and the assistant

A manufacturing assistant touches document systems, a parsing pipeline, a vector store, identity and the plant network, and each connection is a place where permissions, data and logs can leak or go missing. The cards below cover the integration points that need a design decision before build starts. Check each one against your own network zones and document systems.

Document source connectors

Connectors pull manuals, maintenance procedures and quality records from the document management system, shared drives and quality system exports. Each connector must carry the source file's access control list into the index, not just the file text. Confirm whether the document management system exposes change history and approval status, because a connector that ingests a superseded procedure will answer with out-of-date instructions. List every source, its owner and its refresh method before scoping.

Parsing and OCR pipeline

Scanned work instructions, marked-up drawings and spreadsheet-based inspection logs need an OCR and table extraction stage before chunking. Errors here are the most common cause of wrong torque values or part numbers in answers, so the pipeline needs sample-based checks against the original scans. Run this stage inside the plant zone or a processing zone with no outbound internet access, and confirm which parser versions and languages your document mix requires.

Qdrant cluster placement and storage

Qdrant needs block-level storage with a POSIX-compatible file system and cannot run on NFS or object storage such as S3, so placing it on a shared file share is a design error. SSD or NVMe drives are recommended. Production clusters should run at least three nodes so quorum survives a node failure. Place the cluster in the server zone the assistant uses, not on a plant-floor device, and ask your infrastructure team to confirm the storage class before sizing.

Identity and SSO

Engineers and shop-floor staff should sign in through the plant's existing identity provider, and retrieval should filter results by each user's group membership at query time. Self-deployed Qdrant is not secure by default: it listens on all interfaces with no authentication, so API keys, TLS and per-collection permissions must be enabled. Confirm which identity protocol your directory supports, and whether contractors and shift accounts need separate groups.

Plant-network access through a DMZ

Users on the plant network should reach the assistant through a reverse proxy in a DMZ, with no direct route from the plant floor to the vector database, the model server or the document systems. Restrict the proxy to the web interface and the API paths the assistant needs, and log every request at the boundary. Ask your network team to document which firewall rules open, who approves them and how the rules are reviewed after changes to the plant.

Logging for AI Act records

Article 12(1) of the EU AI Act requires high-risk AI systems to technically allow automatic recording of events over their lifetime, and Article 19(1) requires providers to keep those logs for at least six months unless other law provides otherwise. Whether a manufacturing assistant is high-risk depends on its use, such as safety-related decisions, so confirm classification with counsel. Record queries, retrieved sources, cited answers and user identity, and set retention in line with your other quality and plant records.

What auditors and plant reviewers will ask to see

Which document revision did the assistant use to answer a question?

Each answer should record the source document, its revision identifier and the chunk it was drawn from, so a reviewer can open the exact version that was live at the time. The record is produced by the ingestion pipeline and the retrieval layer of the RAG engine, such as RAGFlow, AnythingLLM or Dify, which store document IDs and chunk references with each citation. Confirm during design that your revision scheme (for example, a controlled document number plus revision letter) is carried into metadata at ingestion rather than inferred from file names. DeployOpen prepares these records and tests them, but the auditor decides whether they are sufficient.

How do we prove who approved a procedure version before it was indexed?

Approval evidence normally lives in your document control system, not in the assistant. The assistant should only ingest documents whose status is approved and effective, and the ingestion job should log the approved version, approver and effective date it received. Ask your partner how the connector reads status from the source system and what happens to a superseded revision. Where electronic records and signatures are in scope, the requirements in 21 CFR Part 11 are a useful reference for what the approval trail must show.

Which access logs show who queried the assistant and what they asked?

Query logs should capture the user identity, the time, the question, the collections searched and the documents returned. In a self-hosted stack these come from the application layer (the RAG engine or chat front end), optionally forwarded from an AI gateway such as LiteLLM or Apache APISIX. Confirm that the platform can attribute each query to a named user through your directory and that logs are written to storage you control. Dify, for example, documents separate SSO scopes for workspace access and web app access, which matters when reviewers ask who could see which collection.

How long must query and answer logs be kept?

Retention depends on the rules that apply to your plant and products, so set it from a written requirement rather than a default. For high-risk AI systems under the EU AI Act, Article 12(1) requires technical support for automatic event logging over the system's lifetime, and Article 19(1) requires providers to keep those logs for at least six months unless other law provides otherwise. Whether your assistant is in that category is a classification question to settle with counsel. Ask your partner to configure retention per log type and to show how deletion is enforced and recorded.

What evidence shows the index was rebuilt after a revision changed?

Re-indexing evidence is a job log that links each superseded revision to its removal and each new revision to its embedding run, with timestamps and counts. The ingestion scheduler and the vector database record these events; Qdrant, for example, can be configured with a JSON audit log of authenticated API operations from v1.17.0 onward, and snapshots can preserve the index state before a change. Ask the partner to demonstrate that a withdrawn procedure no longer returns in answers after its replacement is indexed, and to keep that test as a repeatable record.

What evaluation results show the answers are accurate enough for shop-floor use?

Reviewers will want a documented test set of real questions with expected source passages, scored for retrieval hits, citation correctness and answer faithfulness, with results kept per release. Observability tools such as Langfuse or Phoenix can store traces and evaluation scores in your infrastructure, which gives you a time series across changes. Agree acceptance thresholds and who signs off on them before go-live. Ask what the test set covers for scanned pages and tables, since those are the most common failure points.

Which records show the network zoning between the plant and the assistant?

Network zoning evidence is an architecture diagram with the assistant placed in a zone that is separated from control networks, plus firewall rules, the list of permitted flows and change records. For industrial environments, the ISA/IEC 62443 series describes zones and conduits and the security levels expected of them, and NIST SP 800-82 Rev. 3 covers OT security more broadly. The assistant should not sit in a control network. Your network team owns the firewall and conduit records; DeployOpen can document the application side and the flows it needs, and confirm them against your design.

Running the assistant from plant networks without exposing OT

The assistant should run in the IT network or a DMZ and read documents through one-way, read-only paths. It should never sit on a control network, and nothing on the OT side should accept inbound calls from it. The design decision to make first is which system holds the authoritative copy of each manual and procedure, because that system is the only source the assistant pulls from. A document share or document management system in the IT zone, replicated outward by a scheduled job, keeps the assistant one hop away from the plant without giving it a route into PLCs, SCADA or historians. The ISA/IEC 62443 series is the reference most plant security teams use to define these zones and conduits, so ask your OT security lead to map the assistant's placement onto the zone model already in use.

Shop-floor access needs its own decisions. Terminals and tablets should reach the assistant through the web interface over a segment that allows only the required ports, with authentication tied to your identity provider. Confirm with your vendor whether the chosen interface works well on the tablets you already issue, and test it on the plant's wireless network before rollout. Offline or degraded connectivity is an open question for many plants: decide whether shop-floor users may lose answers during a network outage, whether a cached copy of approved procedures is acceptable, and who owns the decision to serve stale content. Treat these as requirements to confirm with operations, not as features to assume. Outbound behavior is where the assistant can reach beyond its zone, so restrict it deliberately. Dify's SSRF_PROXY settings route outbound requests through a proxy that blocks internal and private IP ranges, which limits server-side requests toward plant addresses, and its agent sandbox can be placed behind network isolation through a Squid proxy as described in the 1.16.1 release notes. Verify both in your own build: confirm the proxy is enforced for every outbound path, that the sandbox cannot reach plant subnets, and that SECRET_KEY is set before go-live, since changing it later logs out all users. Also confirm the platform's own network egress rules at the firewall, because a proxy setting alone does not stop a misconfigured container.

How long, costly and hard is this for a plant to run?

What drives the cost of a RAG assistant for a manufacturing plant?

The cost is driven mostly by the document work, not the software. The main components are the parsing pipeline for scanned drawings, manuals and spreadsheets, the vector store, the compute for embeddings and answer generation, evaluation work to check answers against known procedures, and ongoing maintenance as manuals change. Open-source components such as RAGFlow, AnythingLLM, Dify or Open WebUI carry no license fee for most plant uses, but you still pay for infrastructure, implementation labor and the people who review answers. Ask any quote to split one-time build work from recurring operations, and to show how the parsing and evaluation effort scales with the number of documents and revisions in scope.

Can plant IT run a RAG assistant on its own?

Plant IT can run it alone only if it already operates containers, a database, backups and identity integration, and has someone who can judge answer quality against the source manuals. Most teams find the hard parts are the first ingestion of messy documents, re-indexing when procedures change, and checking that retrieval respects document permissions. Dify's self-hosted Community edition is documented as a Docker Compose deployment that starts several core services plus PostgreSQL, Redis and Weaviate, so someone must patch and monitor that stack. Ask a partner which tasks they hand over, which they leave with your team, and what runbooks you receive.

What do document owners and OT security need to provide?

Document owners must identify which manuals, maintenance procedures and quality records are current, name the approver for each revision, and confirm which documents are controlled and which are reference copies. OT security must review the network path from the assistant to plant systems, because the topic standards ISA/IEC 62443 and NIST SP 800-82 Rev. 3 treat industrial control environments as a separate security zone. Expect security to ask where the vector store sits, how it is authenticated, and whether any plant network segment is reachable from the internet. Confirm these needs with your OT security team before scoping.

How long does it take to reach a pilot?

The time to a pilot is set in the written scope, which is agreed before work starts. It depends on how many document sources are connected, how many scanned or tabular files need parsing review, whether the assistant must run inside a segmented plant network, and how quickly your team can name approvers and test users. Ask for a scope that lists the document set for the pilot, the connectors, the test questions used for acceptance, and the dates that depend on your side. DeployOpen does not publish a standard duration, so a timeline should come from the scope, not from a general figure.

Are Community editions enough for a plant deployment?

Community editions can be enough for a single-workspace pilot, but several factors need checking first. The Dify Community edition is free for self-hosting but limited to a single workspace, and Dify Enterprise adds SSO, multiple workspaces, advanced security and professional support. Dify's license also restricts operating it as a multi-tenant service without authorization, which matters if plants from several sites or a partner share one instance. Confirm whether you need SSO integration with plant or corporate identity, audit trails, vendor support hours and a commercial license before choosing an edition.

What does a plant need to keep in the vector store?

A plant should keep only the document-derived embeddings needed for retrieval, stored on infrastructure it controls. Qdrant, for example, needs block-level storage and cannot run on NFS or S3-style object storage, and by default self-deployed instances listen on all interfaces with no authentication. Ask the partner to enable API keys, TLS and per-collection access controls, and to size storage for replication, since a replication factor of 2 doubles storage. Qdrant's Hybrid Cloud and Private Cloud options are priced through sales, so request that quote separately if you consider them.

How is an RFP quote for this work built?

A quote follows from a written scope, so ask every bidder to price the same list of components. The list should cover the parsing pipeline and document review, connectors and identity integration, the vector database and its sizing, model and inference compute, evaluation against agreed test questions, deployment into the plant network, documentation and handover, and the first year of support. Separate one-time build costs from recurring costs such as compute, patching, re-indexing and retainers. Ask each partner which assumptions drive the price, such as document count, scanned page volume and the number of users. DeployOpen does not publish a price list and provides a quote after the scope is agreed.

How DeployOpen scopes and supports a plant document assistant

DeployOpen is a Chainscore Labs company that plans, implements, hardens, backs up and supports self-hosted open-source platforms inside the client's own infrastructure. For a plant document assistant, that means the ingestion pipeline, the parser for scanned pages and tables, the vector store, the chat front end and the model gateway can all run in the plant's data center or cloud account, reachable from the plant network and nowhere else. The first decision is which of those components sit inside the OT boundary, which sit in the corporate zone, and which are reached only through a controlled transfer path. DeployOpen scopes that placement in writing before any build work starts, so the boundary and the data flows are agreed with your security and OT teams rather than discovered during rollout.

Engagements are fixed-scope. The written agreement names the document sources, the file types in scope (for example, scanned maintenance records and spreadsheet-based inspection logs), the roles that will query the assistant, the evaluation set used to test answers and the acceptance criteria for go-live. Deliverables such as hardened configuration, backup and restore runbooks, and operator documentation are listed individually so the buyer can check them against the scope. DeployOpen does not publish a price list, and a quote follows from that scope. Ask any partner to show how a change request is priced and approved once the assistant is live, because document volume and user counts usually change after launch.

Security testing covers the RAG application itself, not only the servers beneath it. Testing should include prompt injection carried in uploaded documents, attempts to retrieve restricted procedures through the chat interface, and checks that source permissions are enforced at retrieval time. DeployOpen runs security testing of applications, APIs and AI systems as a separate service, so the findings are independent of the build team. After go-live, a retainer can cover platform upgrades, patch rollouts and continuous testing. Upgrades matter here because the chosen components release frequently, and each update to the parser, embedding model or vector database can change which procedure revision an answer cites. Ask for the upgrade test plan and the rollback steps before signing.

Talk to our team.

Tell us what you're working on, whether it's a deployment, an audit, a security test or a cyber range. You'll speak with an engineer who can help you scope it.

  • 30-minute call: free, with no obligation.
  • NDA on request: we can sign before you share details.
  • Clear next steps: a scope and plan after the call.