ThreadWare User Guide

AI Assistant

The chat robot in the corner of every screen. Ask it questions in ordinary English about your company data and documents. This guide explains what it can do, and - just as importantly - what it will refuse to do and why.

You only see what you have been given access to

ThreadWare is built from modules - Sales, Production, Quality and so on. An administrator gives you a role in each module, for each company you work in. The menu is built from those roles. So if something in this guide is not in your menu, it has not been given to you yet. Ask your administrator, or log a support ticket. To see what you currently hold, click your initials in the top right and choose My Access & Roles.

This matters more here than anywhere else in ThreadWare. The assistant will only ever tell you things you were already allowed to see. Two people can ask the same question and get different answers, and neither of them is broken.

Where to find it

Two ways, and they open the same thing:

It is not a page in the menu - it floats over whatever you are working on, so you can keep your place. On a phone it opens as a full screen.

Before it will answer anything

Six things all have to be true. If any one is missing, you get an explanation rather than an answer.

What is neededWhat to do if it is missing
You have agreed to the AI notice A banner appears at the top of the chat with an Agree and Enable AI button. Read the notice, then click it. You can withdraw later from the same banner.
The AI Assistant is part of your licence If your company's ThreadWare licence does not include the AI Assistant, it does not appear in the menu and the chat says you do not have permission. Ask your administrator.
AI is switched on An administrator turns AI on for the whole system. If it is off, nobody gets answers. Ask your administrator.
You are assigned to at least one site This one is easy to miss. With no site assigned, questions about orders, production, KPIs and machines quietly return nothing. Only general questions work. Ask an administrator to assign you to a site.
You belong to the right company You only get data for the companies and sites you are assigned to.
You hold the right role Some subjects need a specific role. The table further down says which.

There is a ? button in the chat window itself that shows this same list at any time.

Tell it what you are talking about

At the top of the chat window is a box called Talking about — Sales, Production planning, Stock, KPIs, Risks & governance, Quality, Support desk, or General. Each one gives the assistant its own instructions, its own set of tools and its own documents, so a question about "orders" on the Production page is answered from production orders, and the same word on the Sales page from sales orders.

Administrators write the instructions for each topic under Administration ▸ AI Assistant ▸ Prompts for Chatbot: what the user is doing, which figures matter, what to check before answering, which tools it may call and which documents it searches. A change applies to the next question.

Asking a good question

Be specific. The assistant is much better at a narrow question than a vague one.

Questions that work well

Useful things to know:

The buttons along the bottom

ButtonWhat it does
Microphone Speak your question instead of typing. Only if your browser supports it.
Paperclip Attach a file to this conversation. The file is held for 60 minutes and then forgotten - it is not added to the company document library. The second option on the menu, suggest for the document library, sends a copy to an administrator to decide on.
Web Search (a globe on a small screen) Broadens the question to the public internet. See the warning below. This button only appears if an administrator has switched the feature on.
Send Asks the question against your own company data and documents only. This is the one to use first, and the one to use for anything confidential.

What you get back

A document shown with a line through it is out of date on purpose

If a document has been marked Obsolete or Superseded, the assistant still shows it, struck through, with a warning telling you not to follow it. This is deliberate. Hiding it would make ThreadWare answer "we have no procedure for that" about a procedure the company clearly does have on record. Read the warning, then find the current version.

What it can answer, and what it cannot

This is the part people ask about most. The assistant checks your roles before every single question. Each subject area below has its own rule.

SubjectWhat opens it
How to use ThreadWare ("how do I add a new site?") No special role needed. Answered from these user guides. The administrator steps are given to administrators only.
KPIs, Risks, Governance No special role needed. Any signed-in user can ask. Results are then filtered to your companies, your sites and your access level (see below).
Your own support tickets No special role needed. You can always ask about tickets you raised.
All support tickets A Support Desk role and membership of the queue the ticket is in.
Leave ("who is on leave today", "how many days leave has John Smith had since March") The Leave Viewer role (or T&A Admin) in Time & Attendance to ask about other people. With any other T&A role - T&A Viewer included - you can ask about your own leave only, and the answer says so. It never tells you whether somebody else was off. Leave cannot be booked or changed from the chat. See Time and Attendance.
Visitors ("who was on site yesterday", "how many times has ABC visited") A Visitor Cards role (Visitor Viewer, Security or Visitor Admin) in the company. Phone numbers, e-mail, ID digits and number plates are never shown. See Visitor Cards.
Sales orders A Sales role (Viewer, Rep, Editor or Admin), or Production Planner, in the company that holds the data.
Production orders, job cards A Production role (Viewer, Editor, Planner or Admin) in the company that holds the data.
Machine and sensor readings An Instrument Graphs role (Viewer, Home Dashboard Viewer or Admin), and the tag must be at one of your sites and not hidden.
Discarded readings - whether any readings of a sensor were rejected as impossible, how many, and which sensors have a suspected fault An Instrument Graphs role, and the tag must be at one of your sites and not hidden. The assistant only reads the list: putting a reading back or changing a believable range is done by an administrator on the Data Quality page. See Readings that were discarded.
Performance reviews HR Executive or Administrator - and you must actually type the words "performance review" in your question. This is deliberate: it stops HR data appearing in an answer to a question that was about something else.
Job applicants and CVs The Recruitment role only. An ordinary Administrator cannot see these - it is the one subject where being an admin is not enough. See the Recruitment guide.
IP shift handover notes A Production role in the company that holds the report. Only 10. Hand Over Notes is searchable - absentee reasons, injury details and thread issues are never indexed at all. See Production.
The production plan - how full a machine's shifts are, which orders will be late, why an order sits where it does, "what if we give order X priority 1", how an item is made A Production role in the company the plan belongs to. If you work for more than one company, say which one. Asking it to propose a better plan needs Planner or Production Admin. See "It suggests, a planner decides" below.
Customer certificates - whether a certificate has gone out for an order, a customer's certificates, which were issued under a concession or withdrawn A Production role in that company, and the company must use the op-spec forms. The assistant only reads certificates: preparing, issuing and withdrawing one happen on the Certificates page. See Certificates for customers.
Output, waste and material usage - what was recorded against an item, a machine or an order, and material used against standard A Production role in that company. Cost is never shown in the chat - the value of a variance is on the Usage Variance page, for a Production Admin only.
Stock - what is on hand, what is planned to come in and go out, when an item runs out, which items will run out A Stock role (Viewer, Editor or Admin) in that company; a Production Planner can ask too. If the company's on-hand figures are not loaded the assistant says so: planned receipts and issues are still answered, shortages are not judged. It never records a stock movement. See the Stock guide.
Customer stock - what a customer's store is using, what is low there, what it will use next, what we are sending it and why, and what still has to be captured in the ERP The same Stock gate, including the Customer Stock Planner role. A forecast is always given with how good it has been - the assistant will not quote one on its own, and it says plainly when a store has too little history to forecast at all. It can explain a replenishment; approving one, issuing a request and accepting a stock count are a person's, on the Customer stock pages. See the Stock guide.
Company documents No role, but filtered by your company, your site and your access level.

Access levels 0 to 3

Every document in ThreadWare carries an access level, and so do you. You can only ever read a document at or below your own level.

LevelNameRoughly
0PublicEverybody in the company.
1StandardManagers and above.
2ConfidentialSenior managers and above.
3RestrictedExecutives and administrators.

Your level comes from whichever is higher: the roles you hold, or the level set on your job definition by HR. Administrators, CEOs, executive committee members and superadministrators sit at level 3.

What a lower-level user can and cannot do

Take somebody who is approved, has agreed to the notice, is assigned to one site, and holds no module roles at all. They can:

They cannot get sales figures, production orders, machine readings, performance reviews, other people's tickets, or any document above Public. When they ask, the reply says so in plain words:

You do not have permission to view sales order data.

That is not a fault and it is not a bug. It is ThreadWare telling you the truth about your permissions. If you need that data for your job, ask an administrator for the role named in the table above.

The production plan: it suggests, a planner decides

With Talking about set to Production & Planning you can ask about the plan as well as about what happened:

The assistant can never change the plan

A proposal is a suggestion. It sits on the Production Plan board until a planner reads it and presses Apply or Reject; the assistant has no way to apply one itself. The sums are done by the planning engine, the same one behind Recalculate Plan - the assistant only decides what to ask it and explains the answer.

The plan is never filled to 100 % of a shift. Every figure the assistant gives is against the planning line (usually 80 %), and it will tell you which line was used. "Full" means full to the line: the rest of the shift is the buffer for breakdowns and missing stock, not spare time. These answers read the last plan that was saved; if nobody has saved one yet, it says so.

Three messages people misread

"Relevant information exists in documents that are above your current access level"

The answer to your question does exist in ThreadWare. You are not allowed to read it. The assistant tells you it is there rather than pretending nothing was found, so that you know to ask rather than assume the company has no answer. Contact an administrator to request access.

A partial answer with a note attached

Some questions touch more than one subject at once. For example, "what is running on Line 3" needs both machine readings and production orders. If you have one and not the other, you get the half you are allowed to see, plus a note saying the rest was left out. Better than refusing the whole question.

"Another company has had similar issues"

Something matching your question exists at a company you do not have access to. You are told it exists, and nothing more - no content, no company name.

Web Search - read this before you use it

Web Search sends your text outside the company

Normal Send keeps everything inside ThreadWare. Web Search broadens the question to the public internet and the outside AI service, and it takes some of your own document context with it to make the answer useful.

Because of that, ThreadWare asks you to tick a box confirming your question holds no confidential and no personal (POPIA-protected) information, every single time. Every one of those sends is written to the audit log with your name on it.

Use ordinary Send first. Only broaden to the web when you actually need general knowledge from outside, and always check what comes back before acting on it.

You do not have to press the button. If you type something like "search the web for that" or "check the internet", the assistant recognises it and offers the confirmation box itself. If that was not what you meant, click Search local data instead.

Web Search can also return files for you to download - either files it finds online, or files it creates for you.

Asking for a picture

If you just want to see something, say so - "find me a picture of a safety boot", "show me what a lockout tag looks like" - and press Web Search. The pictures come back as cards underneath the answer. Click one to open the page it came from.

You do not have to attach anything for this. Describing the thing in words is enough.

Searching with a picture

The other way round: you hand the assistant a picture and ask it to find things that look like it - shoes, tools, components, packaging - and it comes back with matches, each as a card with a picture and the site it was found on. Click a card to open that site.

There are two ways to give it the picture:

Then type what you want - "find things that look like this" - and press Web Search. You will be asked to confirm the send in the usual way; the picture goes to the search provider along with your question.

No prices. This search finds pictures and the pages they came from. It does not return prices, and the assistant will not quote you one. If you need a price, open the page and check it there, or ask the supplier.

If your administrator has not switched picture searching on, the assistant says so in its answer rather than leaving you wondering - and it still gives you everything else it can. Everything else in the assistant works exactly the same without it.

Finding a document on the web

Describe the document you are looking for - "a Word template for a quality manual", "an example supplier audit checklist" - and press Web Search. Matches come back as boxes with the file type and where they came from, each with a Download button.

If what you actually want is a document written for you rather than one found on the web, just ask for it that way. That is document generation, described below, and it stays on your own company data.

Anything you download from the web is somebody else's work. Check the licence and the content before you use it, and never assume it fits your requirements.

Pictures of documents

When the assistant finds a document, or creates one for you, it shows a small picture of its first page so you can tell at a glance which one it is. PDFs and image files show a real page.

Word, Excel and PowerPoint are different: nothing on the server can draw a page of those formats, so instead you get the opening text of the document laid out on a page, with a coloured strip naming the file type. That is enough to recognise the document, but it is not the document's real layout - no tables, no logos, no columns. Where even that is not possible, you get a plain coloured tile with the file type on it, which is more honest than a blank box.

The picture is only ever a first page. It tells you which document you are looking at; it is not a way to read it. Download the file to read it, and the same access rules apply as always - if you cannot open a document, you cannot see a picture of it either.

Asking it to create a document

If your administrator has switched it on, you can ask the assistant to produce a Word document, spreadsheet, presentation or PDF from information it has gathered, and download it.

You can also ask for marketing material - "design a brochure about X", "draft a social media post about Y". It styles the result using your company brand documents. For that you need access to the Marketing documents (level 1 or above); with none, it refuses rather than inventing a look. Administrators and document uploaders can save a good result back into the library.

Things to be careful about

When it is not working

What you seeWhat it means
A banner asking you to agree to the AI notice You have not given consent yet, or you withdrew it. Click Agree and Enable AI.
"AI is not enabled" An administrator has AI switched off system-wide.
Data questions return nothing, general ones work Almost always: you are not assigned to any site. Ask an administrator.
"You do not have permission to view ... data" You are missing the role for that subject. Check the table above and ask for it.
"No reply within ... seconds" The request took too long. Your connection is fine. Try a narrower question.
"Your session has expired" Sign out and sign back in.

If an administrator needs to work out why you specifically are not getting answers, they have a report for it: Administration ▸ AI Assistant ▸ AI Access Matrix. It shows, per person, their access level, whether they consented, how many sites they have, and a tick or cross for every subject area.