> ## Documentation Index
> Fetch the complete documentation index at: https://docs.archetypeai.app/llms.txt
> Use this file to discover all available pages before exploring further.

> ## Agent Instructions
> Start with /introduction/getting-started. Use the Direct Query API (POST /query) with the Newton Fusion model (text, image, and video reasoning) or the Newton Omega encoder (time-series embeddings). ATAI_API_ENDPOINT must include the version path: /v0.5 for most APIs, /v0.6 for the Fine-Tuning Service. Pages whose descriptions are marked (Archived) document the legacy Lens runtime — do not use them for new projects.

# Operational State Monitoring Agent

> Continuously monitors machines and industrial processes by identifying changing operating states from multimodal sensor data. Every window comes back with a predicted state and a confidence score.

The Operational State Monitoring (OSM) agent continuously labels which operating regime a system
is in, from a small set of N-shot labeled examples gathered across environments or sessions.
There is no concept of normal or anomalous; every regime is a valid state, and the agent simply
reports which one the system currently occupies. Unlabeled data can be incorporated to improve
coverage.

## Use Cases

* **Monitor asset condition and performance:** Classifies every window into an operating state,
  turning the raw sensor stream into a continuous, timestamped state record.

* **Detect process drift and degradation:** Tracks each state’s dwell time over rolling periods,
  so slow decline shows up early.

* **Identify and maintain optimal operating envelopes:** Reveals the operating envelope as the
  states an asset normally holds, so out-of-range behavior stands out.

## See an Interactive Example

Try out the OSM agent with predefined data sets using our interactive examples. We have two
examples available:

<Columns cols={2}>
  <Card title="OSM Drill Agent" icon="oil-well" href="https://agents-playground.archetypeai.workers.dev/?agent=osm-drill">
    Classifies the operational state of a drilling rig. Reads nine sensor channels from a North
    Sea well and labels each time window as one of six states: drilling, reaming, off bottom, in
    slips, trip in slips, or shut in.
  </Card>

  <Card title="OSM HVAC Agent" icon="air-conditioner" href="https://agents-playground.archetypeai.workers.dev/?agent=osm-hvac">
    Classifies the operating state of a fan coil unit. Reads six sensor channels and classifies
    them as a stuck valve, a stuck damper, or a heating-side fault.
  </Card>
</Columns>

## Using the Archetype AI Python Client

How to use the [Archetype AI Python client](https://github.com/archetypeai/python-client/) to
work with the OSM agent.

<Card title="Operational State Monitor Agent Example" icon="python" href="https://github.com/archetypeai/python-client/tree/main/examples/agents/agent_osm.py">
  An example that runs an Operational State Monitor (OSM) agent on sensor data using a
  platform-hosted quick-start bundle.
</Card>