This feature is in beta. Machinery is not available on AIP Now enrollments.
Machinery's process optimization is even more powerful when you integrate AIP Logic. As depicted in the process optimization setup documentation, take advantage of Actions backed by LLM responses to optimize and push your process from one state to another.
When fully configured, Machinery processes can be integrated into operational applications using dedicated widgets in Workshop. While the Machinery application illustrates the process definition, the Machinery widgets show the actual state across process objects.
The Process Log
object, managed by Machinery, responds to changes in process objects asynchronously. As a result, there may be a slight delay in registering events, and aggregated metrics (excluding state count) might not include the most recent events. If you need real-time performance, consider using the manual setup or contact Palantir Support for assistance.
The two main usages of the widgets are:
There are two ways to integrate a Machinery process to Workshop, detailed in the following sections:
Machinery offers a way to generate a Machinery Express application that serves as a ready-to-use analysis tool that you can customize and use to build your own application. Use this feature to share the process immediately with operational users that need to be given context.
To build the express Workshop application, open your process in the Machinery application, then navigate to the Modules menu in the Overview side panel and select Create Module. The new express application will be added and linked in this area after it is generated. This application provides you with:
From here, you can review your existing process, and then navigate back to the Machinery application to reconfigure or update your processes to optimize then.
For a more manual approach, you can create a Machinery Process Overview widget in a new or existing Workshop application to view your process. Choose the Machinery resource that contains the process you want to visualize. The Ontology configuration, as well as the node positions, will be discovered from that process.
The Machinery Process Overview Widget displays a specific set of process objects. You can supply these objects through a Workshop object set variable. To ensure consistency, you should obtain the variable for process logs through a search-around from the processes.
By default, last updated at refers to the timestamp of the most recent log entry for each process object. You can choose to maintain an Updated at property on the process object type yourself if you wish to manually specify the timestamp.
The Machinery Process Overview widget computes a set of default metrics based on the latest state and the time it entered that state. To understand the behavior of your process objects, you can add context from other properties. You can define numerical metrics based on all properties of the process and the log object types in the Custom Metrics section.
In the node and edge styling sections, you can define the physical appearance of the process to your user.
You can use the Machinery Process Overview widget to control other parts of your Workshop application. User interactions on the graph can either control an object set filter, or a String-type variable containing the ID of the selected element.
Generally, you should first establish an abstract process definition, and then match the observed data against it. However, if your primary aim is to understand your log data and the journey of process entities, it might be premature to define the process in Machinery. For this scenario, Machinery offers live mining, the ability to abstract a process definition from your operational data in real time.
You have the option to leave the Machinery graph empty and create a Workshop module with a Machinery widget. We recommend using the Create module feature.
To Enable live mining, open the Machinery widget configuration in Workshop's Edit mode and toggle the option on. When live mining is enabled, Machinery will identify all states and transitions present in the log object set variable that you provide and lay out the resulting nodes. You can filter this object set to explore subsets of your data and observe in real time the processes formed by these objects.
Process definitions mined live are not saved permanently. You can adjust node positions on the canvas, but the positions will reset when the log object set changes. Due to the temporary nature of live mining, setting up automations is not permitted in live-mining mode.