Using the agent for master data

The agent reads and changes master data for you: devices, device types, measuring points and facilities. Open the agent with Chat in the menu or with Open chat. See Chatting with the agent.

Prerequisite

ai_chat:read permission to use the agent
The permissions for the master data, for example devices:read or devices:write. The agent can only do what you are permitted to do.

Asking about master data

Replace the values in angle brackets with your own names.

Topic Example

Topic	Example
Devices	`Which devices are assigned to <facility>?`
Device details	`Which measuring points does the device <device> have?`
Device types	`Which device types exist, and how many devices does each have?`
Measuring points	`Which measuring points have the unit °C?`
Facilities	`Show the facility tree.`

Devices

Which devices are assigned to <facility>?

Device details

Which measuring points does the device <device> have?

Device types

Which device types exist, and how many devices does each have?

Measuring points

Which measuring points have the unit °C?

Facilities

Show the facility tree.

Creating and changing master data

Describe what you need. The agent creates the objects in the right order: first measuring points, then device types, then devices.

Create a measuring point <name> with the unit <unit>.

Create the device type <device type> with the measuring points <measuring point 1>, <measuring point 2> and <measuring point 3>.

Create the device <device> with the technical ID <technical ID> of type <device type> in the facility <facility>.

Add the measuring point <measuring point> to the device <device>.

If information is missing or not unambiguous, for example the type of a new facility, the agent asks for it. Before it changes or deletes existing master data, the agent shows what it will do and asks for confirmation:

After the change, the agent shows the result with the IDs of the objects:

Rules of the agent for master data

Measuring points that a device gets from its device type are removed on the device type. On the device, only measuring points that were assigned directly can be removed.
A device type can only be deleted when no device uses it.
A measuring point can only be deleted when no device type or device uses it.
The agent uses the IDs of the objects exactly as returned. It shows them in its answers so that you can refer to them.

Agent für Stammdaten nutzen

Der Agent liest und ändert Stammdaten: Geräte, Gerätetypen, Messpunkte und Anlagen. Der Agent öffnet sich über Chat im Menü oder über Chat öffnen (Open chat). Siehe Mit dem Agenten chatten.

Voraussetzung

Berechtigung ai_chat:read, um den Agenten zu nutzen
Die Berechtigungen für die Stammdaten, zum Beispiel devices:read oder devices:write. Der Agent kann nur das tun, wozu der angemeldete Benutzer berechtigt ist.

Stammdaten abfragen

Die Werte in spitzen Klammern durch die eigenen Namen ersetzen.

Thema Beispiel

Thema	Beispiel
Geräte	`Welche Geräte sind <Anlage> zugeordnet?`
Gerätedetails	`Welche Messpunkte hat das Gerät <Gerät>?`
Gerätetypen	`Welche Gerätetypen gibt es und wie viele Geräte hat jeder davon?`
Messpunkte	`Welche Messpunkte haben die Einheit °C?`
Anlagen	`Zeige den Anlagenbaum.`

Geräte

Welche Geräte sind <Anlage> zugeordnet?

Gerätedetails

Welche Messpunkte hat das Gerät <Gerät>?

Gerätetypen

Welche Gerätetypen gibt es und wie viele Geräte hat jeder davon?

Messpunkte

Welche Messpunkte haben die Einheit °C?

Anlagen

Zeige den Anlagenbaum.

Stammdaten anlegen und ändern

Beschreiben, was benötigt wird. Der Agent legt die Objekte in der richtigen Reihenfolge an: zuerst Messpunkte, dann Gerätetypen, dann Geräte.

Lege einen Messpunkt <Name> mit der Einheit <Einheit> an.

Lege den Gerätetyp <Gerätetyp> mit den Messpunkten <Messpunkt 1>, <Messpunkt 2> und <Messpunkt 3> an.

Lege das Gerät <Gerät> mit der technischen ID <technische ID> vom Typ <Gerätetyp> in der Anlage <Anlage> an.

Füge dem Gerät <Gerät> den Messpunkt <Messpunkt> hinzu.

Fehlen Angaben oder sind sie nicht eindeutig, zum Beispiel der Typ einer neuen Anlage, fragt der Agent nach. Bevor der Agent vorhandene Stammdaten ändert oder löscht, zeigt er, was er tun wird, und bittet um Bestätigung:

Nach der Änderung zeigt der Agent das Ergebnis mit den IDs der Objekte:

Regeln des Agenten für Stammdaten

Messpunkte, die ein Gerät von seinem Gerätetyp erhält, werden am Gerätetyp entfernt. Am Gerät lassen sich nur direkt zugeordnete Messpunkte entfernen.
Ein Gerätetyp lässt sich nur löschen, wenn kein Gerät ihn verwendet.
Ein Messpunkt lässt sich nur löschen, wenn kein Gerätetyp und kein Gerät ihn verwendet.
Der Agent verwendet die IDs der Objekte exakt so, wie sie zurückgegeben werden. Er zeigt sie in seinen Antworten, damit sich weitere Anfragen darauf beziehen können.

Diese Seite bearbeiten Edit this page