> ## 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.

# Rare Event Detection Agent

> Detects known faults and failures by matching new data against a handful of labeled examples. Each sensor data window is classified as normal or abnormal, with a confidence score.

The agent identifies specific, rare events — faults that are easy to miss in a long stream of
events — using a small number of labeled examples of each fault alongside examples of normal
behavior. These faults do not stop the process; they require post-process remediation or
maintenance.

## Use Cases

* **Detect known failure modes:** Classifies each window as normal or one of your labeled
  faults, so a fault you've characterized is caught wherever it recurs.

* **Identify critical operational events:** Returns each detected fault timestamped and scored,
  so high-stakes events surface instead of staying buried in the stream.

* **Monitor infrequent quality or safety issues:** Catches issues for which it is too rare to
  build a conventional detector.

* **Reduce missed detections despite limited training data:** Recognizes a fault by its
  signature, not its exact waveform, so a few labeled examples catch it across other assets.

## See an Interactive Example

Try out the Rare Event Detection agent with a predefined data set using our interactive example.

<Card title="Rare Event Detection: Water Pump Agent" icon="pump" href="https://agents-playground.archetypeai.workers.dev/?agent=red">
  Detects rare failures in an industrial water pump. Reads sensor channels (e.g. motor speed,
  bearing and lube-oil temperatures) and flags each window as normal or breakdown.
</Card>

## Using the Archetype AI Python Client

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

<Card title="Rare Event Detection Agent Example" icon="python" href="https://github.com/archetypeai/python-client/tree/main/examples/agents/agent_red.py">
  An example that runs a Rare Event Detection agent on sensor data using a platform-hosted
  quick-start bundle.
</Card>