Skip to main content

How to improve your ARP knowledge base

Avatar

Fiix Documentation Team

  • Updated

Before you begin

Asset Risk Predictor must be purchased separately from a Fiix representative. To learn more, see ARP eligibility FAQ.

Asset Risk Predictor (ARP) uses data from your asset records and past work orders to automatically build a knowledge base for your ARP-enabled assets. It then uses this knowledge base to:

This means that the quality of the knowledge base greatly impacts the quality of the prescriptive work orders and chat answers it generates. In other words, populating the knowledge base with the right inputs will lead to better outputs. Further, your knowledge base is specific to your CMMS and is not shared with other customers—meaning that ARP relies solely on the data you provide as it can't leverage data in other customers' knowledge bases.

Although the knowledge base gets built automatically, there are a few steps you can take to help populate it with the right data:

Each of these steps is described in more detail in the sections below.

Note

If there isn’t enough data to build the knowledge base for one of your assets, your Fiix representative will provide a questionnaire for you to complete. Your completed questionnaire is then used to help populate that asset's knowledge base.

Step 1: Collect or create your assets

The documents attached to your asset records are a key part of your ARP knowledge base. Each ARP-enabled asset should have at least one document. These can be existing documents your organization already uses (manuals, SOPs, etc.) or ones that you create specifically for use with ARP.

Your ARP documents must:

  • Include detailed troubleshooting information for each sensor, with instructions for what to do at each risk level (low, medium, and high).

Note

In this step, you’re just making sure that your documents have the right information—and creating new ones, if necessary. You'll learn how to upload them in step 3.

Step 2: Use consistent and descriptive sensor names

During initial setup for ARP, we created child assets for each sensor under the appropriate asset record:

In the example above, the six child assets (Combustion Chamber Temperature, Drain Flow Rate, etc.) under Steam Generation represent its sensors.

Note

Depending on your configuration, these might not be actual sensors; they could be data tags that represent the machine and process data you want to capture, such as measurements, calculations, ratios, and fault codes.

In order for ARP to associate a sensor with the right document, the sensor names in Fiix must match the sensor names in your asset documentation.

For example, a sensor called “Combustion Chamber Temperature” in your documentation should use the same name in Fiix. If you used a different name (e.g. “CC Temp”), ARP wouldn’t be able to associate it with the right docs.

To update a sensor name in Fiix:

  1. Go to Assets > All Assets:
  2. Make sure you’re in the hierarchy view, which displays parent and child assets in a “tree”, rather than as a flat list:
  3. Find and expand the parent asset in the hierarchy.
  4. Click the sensor you want to rename:
  5. Update the name field to match what appears in your asset documentation:
  6. Click Save.
  7. Repeat steps 3-6 for any other sensors you need to rename.

Step 3: Upload your docs

Once you’ve collected the necessary documents (in Step 1) and updated sensor names to match the documentation (in Step 2), you can start uploading them to your asset records.

To upload your documents:

  1. Go to Assets > All Assets.
  2. Click the asset you want to add the document to.
    Note: This asset must be one of the ones you’ve included in ARP.
  3. In the Files tab, click the + button:
  4. Click the file you want to upload.
    Note: The file should use the naming convention mentioned in the Step 1 section above.
  5. Repeat steps 2-4 for any other assets you want to add documents to.
  6. Once you’ve finished uploading your documents, contact your Fiix representative. They will work with our dev team to transfer the documents so they can be used in prescriptive maintenance work orders.

Step 4: Update prescriptive work orders

In addition to your asset documentation (covered in the sections for steps 1-3), ARP also uses work order data to build and improve your knowledge base.

Once ARP starts generating prescriptive work orders, you can help improve the knowledge base by:

  • Adding completion notes to prescriptive work orders (in the Completion notes field) and tasks (in the Task completion notes field)
  • Completing tasks that are correct (see instructions for web and mobile)
  • Not completing tasks that are wrong

Over time, ARP uses this information to improve the tasks and work orders it creates. It updates your knowledge base automatically every time you upload a new document or close ten (or more) new work orders.

To learn more about prescriptive work orders, see About Fiix Prescriptive Maintenance.

Related articles