Objekt-IDs und KI-Agenten

Jedes Widget, jede Seite, jeder Bericht, jeder Knoten, jede Seite der Wissensdatenbank und jeder Skill in Ovidens - und jeder Indikator, jede Dimension, jede Gruppe, jede Konsistenzprüfung, jeder Berichtszeitraum, jede Erhebungsrunde und jede Frage einer Erhebung - hat eine eigene ID, zum Beispiel wdg_k3m9x2qd7f. Statt zu beschreiben, wo etwas liegt ("die Sales-App, vierte Seite, die Tabelle Offene Aufträge"), kopieren Sie seine ID und geben sie Ihrer KI. Die KI liest genau dieses Objekt, in einem Schritt, ohne danach zu suchen.

Das funktioniert mit jeder KI, die Sie mit Ihrem Workspace verbunden haben - Claude, ChatGPT oder eine andere KI, die MCP spricht (siehe Eigene KI verbinden) - und mit Vera in einer Analyse-App.

So sieht eine ID aus

Eine ID beginnt mit ein paar Buchstaben, die sagen, welche Art von Objekt sie bezeichnet, gefolgt von einem Unterstrich und zehn Buchstaben und Ziffern. Sie enthält keine Leerzeichen und keine Bindestriche, deshalb markiert ein Doppelklick die ganze ID.

Wo Sie eine ID kopieren

• Ein Widget: Fahren Sie mit der Maus über das Widget - in der App und im Editor -, dann erscheint direkt nach seinem Titel ein kleines ID-Symbol. Ein Klick darauf kopiert die ID. Auf einem Touchscreen ist das Symbol immer zu sehen.
• Eine Seite oder ein Bericht: Fahren Sie mit der Maus über die Zeile in der Seitenleiste der App. Das ID-Symbol erscheint neben den anderen Aktionen der Zeile.
• Die App: Fahren Sie in der App-Liste mit der Maus über die App und klicken Sie auf App bearbeiten (den Stift). Der Dialog zeigt unter der Technischen ID eine Zeile App-ID mit eigenem Kopieren-Knopf. Das gilt für jeden App-Typ. In einer Analyse-App steht das ID-Symbol außerdem neben dem Namen der App in der Kopfzeile.
• Eine Seite der Wissensdatenbank: Öffnen Sie das Menü der Zeile im Baum der Wissensdatenbank und wählen Sie ID kopieren. Eine geöffnete Seite und ein geöffneter Bericht zeigen das ID-Symbol außerdem neben ihrem Namen.
• Alles andere - ein Knoten, ein Skill, ein Indikator, eine Dimension, eine Gruppe, eine Konsistenzprüfung, ein Berichtszeitraum, eine Erhebungsrunde und eine Frage: Das Panel zeigt unter der Technischen ID eine ID-Zeile (bei einer Gruppe, die keine Technische ID hat, unter ihrem Namen). Die Zeile ist nach der Art benannt, etwa Knoten-ID oder Fragen-ID, und hat einen eigenen Kopieren-Knopf.

Ein Objekt erhält seine ID in dem Moment, in dem es gespeichert wird. Ein Berichtszeitraum, der nur in der Zeitachse existiert - niemand hat ihn umbenannt, zur Prüfung übergeben, freigegeben oder eine Runde darin gestartet -, erhält seine ID, sobald er aus einem dieser Gründe gespeichert wird.

Link kopieren im Menü der App-Kopfzeile und im Zeilenmenü der Wissensdatenbank kopiert stattdessen einen Link. Der Link öffnet das Objekt in Ovidens, und Ihre KI akzeptiert ihn genauso wie eine ID, denn jeder Link, den Ovidens kopiert, enthält die ID des Objekts.

Geben Sie Ihrer KI eine ID

Fügen Sie die ID mit dem Wort fetch davor in Ihre KI ein:

fetch wdg_k3m9x2qd7f

Oder verwenden Sie sie in einer Frage - "was zeigt wdg_k3m9x2qd7f für März?" - oder fügen Sie einen kopierten Link ein. Eine verbundene KI übergibt die ID an das Werkzeug fetch von Ovidens und erhält das Objekt zurück.

Zwei optionale Zusätze ändern, was sie liest:

Version und Seite lassen sich kombinieren: fetch wdg_k3m9x2qd7f@published:p2.

Was Ihre KI zurückbekommt

• Den Namen des Objekts und einen Link, der es in Ovidens öffnet. Der Link eines Widgets öffnet seine Seite, scrollt zum Widget und hebt es kurz hervor.
• Wie es eingerichtet ist - bei einem Widget der Typ, der Knoten, den es liest, seine Spalten und Filter; bei einem Knoten die Konfiguration und die Spalten; bei einem Skill die Anweisungen; bei einer Frage der Text und die Optionen.
• Was es zeigt, so wie die App es zeigt - die Zeilen eines Tabellen-Widgets mit seinen Filtern, sichtbaren Spalten, Gruppierungen und Summen; die Reihen eines Diagramms; die Zellen einer Pivot-Tabelle; den Wert eines Kennzahl-Widgets; die Auswahl, die ein Parameter-Widget anbietet; das Ergebnis eines SQL-Widgets; die Zeilen eines Knotens; den Text einer Seite der Wissensdatenbank; die erfassten Werte eines Indikators; die Mitglieder einer Dimension. Ein KI-Widget antwortet mit dem Skill, den es ausführt, und das Lesen führt den Skill nie aus.
• Die IDs verwandter Objekte - die App, die Seite, auf der ein Widget liegt, der Knoten, den es liest, die Seiten einer App -, sodass Ihre KI diese als Nächstes abrufen kann.
• Woher jeder Teil stammt - aus welcher Version die Einrichtung gelesen wurde und aus welcher Berechnung die Daten stammen.

Welche Version Ihre KI sieht

Ihre KI sieht, was die App Ihnen zeigen würde: die Einrichtung aus Ihrem offenen Entwurf, wenn es einen gibt, sonst aus der veröffentlichten Version, und die Daten aus der letzten erfolgreichen Berechnung der veröffentlichten Version. Ein Widget, das Sie gerade in einem Entwurf hinzugefügt haben, kommt also mit seiner Einrichtung und dem Hinweis zurück, dass es dafür noch keine veröffentlichten Daten gibt. Mit @published liest Ihre KI genau das, was alle anderen heute sehen.

Lange Antworten

Eine Antwort enthält bis zu 100 Zeilen. Gibt es mehr, sagt die Antwort das und nennt die ID der nächsten Seite - zum Beispiel wdg_k3m9x2qd7f:p2 -, die Ihre KI als Nächstes abrufen kann. Eine lange Seite der Wissensdatenbank wird auf dieselbe Weise in Seiten geteilt.

IDs bleiben beim Objekt

• Eine ID ändert sich nie, solange das Objekt existiert. Beim Umbenennen, beim Verschieben eines Widgets auf eine andere Seite, beim Veröffentlichen, beim Öffnen eines neuen Entwurfs und beim Wiederherstellen einer älteren Version bleibt sie erhalten.
• Eine Kopie einer App erhält neue IDs. Eine App importieren, eine aus dem Marketplace installieren, eine Erhebung duplizieren und die Beispiel-Apps - all das legt Objekte mit eigenen IDs an, sodass eine ID immer auf ein Objekt in einer App zeigt.
• Die ID eines gelöschten Objekts funktioniert nicht mehr. Ihre KI erfährt, dass das Objekt gelöscht wurde - oder, wenn Sie es in Ihrem offenen Entwurf entfernt haben, dass es noch veröffentlicht ist.
• IDs gehören zu Ihrem Workspace. Eine ID, die in einem anderen Workspace kopiert wurde, wird in Ihrem nicht gefunden.

Gut zu wissen

• Ihre KI liest per ID mit Ihren Berechtigungen und liest nur - sie ändert nichts. Ein Admin erlaubt es mit Objekt per ID abrufen in der Gruppe Lesen der KI-Berechtigungen des Mitglieds. Konnte Ihre KI bereits die Visualisierungskonfiguration einer App lesen, kann sie auch per ID abrufen.
• Archivierte Apps und die App Audit Analytics stehen KI-Agenten nicht zur Verfügung; ihre IDs werden nicht gefunden.
• Daten per ID zu lesen verbraucht die Compute-Credits Ihres Workspace wie jede andere Frage Ihrer KI an die Daten.