How the agent works

Interaction with an AI system. Responses may contain errors. Validate before use.

Acting on your behalf

The agent uses the same functions as the user interface. It acts on your behalf with your permissions: it can only see and change what you are permitted to see and change. If a permission is missing, the agent tells you that the action was rejected.

The chat tells the agent which page you are on and which device is open. You can therefore refer to "this device".

Rules the agent follows

No guessing: the agent answers with data from the Smart Operations Toolkit. If it cannot get the data, it says so.
Confirmation: before the agent changes or deletes existing data, it shows what it will do and asks for confirmation. If information is missing or not unambiguous, it asks.
IDs: the agent shows the IDs of the objects it works with, so that you can refer to them.
Facts and interpretation: the agent separates the returned values from its own interpretation. Values it calculates itself, for example a mean, are marked as approximations.
No rating without limits: if no limits are defined for a measuring point, the agent does not rate values as OK or NOK.

After a change, the agent shows the result:

Time ranges

Relative time ranges such as "yesterday" are interpreted in UTC.
The agent states the time range it used.
"Last week" means the last seven days up to now, unless you ask for a calendar week.

Limits for evaluations

To give reliable answers, the agent loads all values of the requested time range. The following limits apply:

at most 10,000 values per measuring point,
at most 30,000 values per answer.

If the requested time range contains more values, the agent does not load any values. Instead, it tells you how many values exist and proposes shorter time ranges. Choose one of the proposals or name another time range.

Tips for good questions

Name the device, the measuring point and the time range, for example "<measuring point> of <device> yesterday between 8:00 and 12:00 UTC".
For changes, give all values in one message, for example name, device, measuring point and thresholds of a rule.
Ask follow-up questions in the same conversation. The agent knows the previous answers.
Start a new chat when you change the topic. See Starting a new chat.

Arbeitsweise des Agenten

Interaktion mit einem KI-System. Antworten können Fehler enthalten. Bitte vor der Verwendung prüfen.

Handeln im Auftrag des Benutzers

Der Agent nutzt dieselben Funktionen wie die Benutzeroberfläche. Er handelt im Auftrag des angemeldeten Benutzers und mit dessen Berechtigungen: Er sieht und ändert nur, was der Benutzer sehen und ändern darf. Fehlt eine Berechtigung, meldet der Agent, dass die Aktion abgelehnt wurde.

Der Chat teilt dem Agenten mit, welche Seite geöffnet ist und welches Gerät angezeigt wird. Deshalb kann sich eine Frage auf „dieses Gerät“ beziehen.

Grundsätze des Agenten

Kein Raten: Der Agent antwortet mit Daten aus dem Smart Operations Toolkit. Kann er die Daten nicht abrufen, teilt er das mit.
Bestätigung: Bevor der Agent vorhandene Daten ändert oder löscht, zeigt er, was er tun wird, und fragt nach einer Bestätigung. Fehlen Angaben oder sind sie nicht eindeutig, fragt er nach.
IDs: Der Agent zeigt die IDs der Objekte, mit denen er arbeitet. So lässt sich in weiteren Fragen auf diese Objekte Bezug nehmen.
Fakten und Interpretation: Der Agent trennt die gelieferten Werte von seiner eigenen Interpretation. Selbst berechnete Werte, zum Beispiel einen Mittelwert, kennzeichnet er als Näherungswerte.
Keine Bewertung ohne Grenzwerte: Sind für einen Messpunkt keine Grenzwerte festgelegt, bewertet der Agent Werte nicht als OK oder NOK.

Nach einer Änderung zeigt der Agent das Ergebnis:

Zeiträume

Relative Zeiträume wie „gestern“ legt der Agent in UTC aus.
Der Agent nennt den verwendeten Zeitraum.
„Letzte Woche“ bedeutet die letzten sieben Tage bis jetzt, außer die Frage nennt ausdrücklich eine Kalenderwoche.

Grenzen für Auswertungen

Für verlässliche Antworten lädt der Agent alle Werte des angefragten Zeitraums. Dabei gelten folgende Grenzen:

höchstens 10.000 Werte je Messpunkt,
höchstens 30.000 Werte je Antwort.

Enthält der angefragte Zeitraum mehr Werte, lädt der Agent keine Werte. Stattdessen nennt er die Anzahl der vorhandenen Werte und schlägt kürzere Zeiträume vor. Einen der Vorschläge wählen oder einen anderen Zeitraum nennen.

Tipps für gute Fragen

Gerät, Messpunkt und Zeitraum nennen, zum Beispiel „<Messpunkt> von <Gerät> gestern zwischen 8:00 und 12:00 Uhr UTC“.
Bei Änderungen alle Werte in einer Nachricht angeben, zum Beispiel Name, Gerät, Messpunkt und Schwellenwerte einer Regel.
Folgefragen im selben Verlauf stellen. Der Agent kennt die vorherigen Antworten.
Beim Wechsel des Themas einen neuen Chat starten. Siehe Neuen Chat starten.