# MobiusFlow Data Agent

## Overview

The Data Agent introduces an agentic / chat style interface to interact with your MobiusFlow data. The enables tasks such as:

* Reporting what data exists
* Summarising data, both present and historical
* Making data comparisons between multiple data sets
* Drawing conclusions about the nature of data
* Making suggestions about changes which could be made to improve real-world systems

In the near future it will also allow:

* Generation of alerts
* Generation of graphs / cards to supplement data reports

The Data Agent can accessed via MobiusFlow View. The agent invokes the tools provided by the [Historian MCP Sever](/help/mobiusflow-v3/mobiusflow-historian-data-api-v3/mcp-server.md), whilst being powered by an OpenAI LLM.

## Limitations

The Data Agent only knows about the data within MobiusFlow Historian. It does not know anything about the underlying MobiusFlow Engine or its configuration (i.e. the plumbing behind the data). As such, it cannot do the following:

* Reporting of current MobiusFlow Engine configuration
* Reporting of service statuses
* Reporting / advising why a specific device / service is not connecting / not functioning as expected
* Making engine configuration changes such as populating a service or updating an object

Most of the above tasks can achieved via using the [MobiusFlow Engine Agent](/help/mobiusflow-v3/mobiusflow-engine-agent.md) instead.

## Requirements for Usage

The agent uses an OpenAI LLM backend. MobiusFlow does not currently manage token usage of this LLM and as such, it is left to customers to manage this themselves.

This means an account on the [OpenAI Platform](https://platform.openai.com/login) is required. Once created, ensure some credit is added to the account so tokens can be consumed by the agent.

The MobiusFlow Data Agent is linked to your OpenAI Platform account via and OpenAI API token. This token can be created on the OpenAI Platform website [here](https://platform.openai.com/settings/organization/api-keys). Once created, this key must be copied and pasted into the Data Agent when prompted:

<figure><img src="/files/plxuQOx3hLT8Hf3p2Aax" alt=""><figcaption></figcaption></figure>

If a key is already set but needs to be updated, the key button next to the chat bar should be used:

<figure><img src="/files/Nt4UNsCSxbHk1DXpu5FD" alt=""><figcaption></figcaption></figure>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.mobiusflow.com/help/mobiusflow-v3/mobiusflow-data-agent.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.