# Objekt-IDs und KI-Agenten (/docs/de/integrations/object-ids) 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](./mcp.mdx)) - und mit [Vera](../tips/interact-with-vera.mdx) in einer Analyse-App. ## So sieht eine ID aus [#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. | Beginnt mit | Objekt | Beginnt mit | Objekt | | ----------- | ----------------------------------------------- | ----------- | ------------------------- | | `app_` | eine App | `ind_` | ein Indikator | | `page_` | eine Seite einer Visualisierung | `dim_` | eine Dimension | | `wdg_` | ein Widget | `grp_` | eine Indikatorgruppe | | `rpt_` | ein Bericht | `chk_` | eine Konsistenzprüfung | | `node_` | ein Pipeline-Knoten | `per_` | ein Berichtszeitraum | | `kb_` | eine Seite oder ein Ordner der Wissensdatenbank | `rnd_` | eine Erhebungsrunde | | `skl_` | ein Skill | `qst_` | eine Frage einer Erhebung | ## Wo Sie eine ID kopieren [#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 [#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: | Zusatz | Was er bewirkt | Beispiel | | ----------------- | -------------------------------------------------------------------------------- | -------------------------------- | | `@published` | Liest die Einrichtung der veröffentlichten Version statt Ihres offenen Entwurfs. | `fetch wdg_k3m9x2qd7f@published` | | `@draft` | Liest den offenen Entwurf. Ist keiner offen, erfährt Ihre KI das. | `fetch page_x2kq7m1c0d@draft` | | `:p2`, `:p3`, ... | Liest die nächste Seite einer langen Antwort. | `fetch node_7m1c0dx2kq:p2` | Version und Seite lassen sich kombinieren: `fetch wdg_k3m9x2qd7f@published:p2`. ## Was Ihre KI zurückbekommt [#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 [#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 [#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 [#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](../marketplace.mdx) 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 [#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.