> For the complete documentation index, see [llms.txt](https://docs.buildings.ability.abb/collection/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.buildings.ability.abb/collection/german/copilot-assistant/improving-results/data-requirements.md). # Datenanforderungen Copilot Assistant arbeitet mit den in Ihrer Asset-Hierarchie verfügbaren Daten. Er erstellt keine fehlenden Messwerte und leitet keine verlässliche Bedeutung für ein Asset ab, das nicht klar beschrieben ist.\ Auch wenn er theoretisch mit einer grob definierten Hierarchie und einem lockeren Asset-Modell arbeiten kann, ist es möglicherweise nicht in der Lage, sein volles Potenzial auszuschöpfen.\ Die Vorbereitung der Datenbasis ist daher genauso wichtig wie das Schreiben eines guten Prompts. ## Mindestanforderungen Die folgenden Voraussetzungen sind für sinnvolle Datenabfragen erforderlich: * Sie verfügen über einen Asset-Katalog, der die relevanten Standorte, Assets und Messwerte enthält. * Die Asset-Hierarchie bildet die Beziehungen zwischen diesen Assets ab, z. B. Portfolio -> Standort -> Gebäude -> Etage -> Raum -> Asset.\ Dadurch versteht der Assistant die räumlichen Beziehungen Ihrer Daten. * Assets und Standorte haben stabile, wiedererkennbare Namen. Verwenden Sie in allen Gebäuden eine einheitliche Benennung für denselben Entitätstyp. * Asset-Typen, Tags und Attribute beschreiben, wofür ein Asset steht -> diese sollten konsistent über alle Assets hinweg verwendet werden. * Messwerte haben aussagekräftige Attributnamen, Attributtypen und, falls zutreffend, eine Einheit wie `°C`, `kWh`, oder `%`. * Aktuelle Daten sind für Fragen zum Live-Status verfügbar, und historische Daten sind für Trend- oder Vergleichsfragen verfügbar. * Benutzer haben Zugriff auf die Assets und Daten, nach denen sie fragen. Copilot Assistant kann keine Daten außerhalb des für den jeweiligen Benutzer zulässigen Kontexts abfragen. Wenn eine dieser Voraussetzungen fehlt, kann Copilot Assistant um Klarstellung bitten, keine übereinstimmenden Daten zurückgeben oder ein Ergebnis liefern, das enger gefasst ist als beabsichtigt. ## Daten, die den Geschäftswert steigern Daten können technisch verfügbar sein und dennoch schwer für Entscheidungen zu nutzen sein. Die folgenden Praktiken verbessern die Granularität, die Antwortqualität und den Nutzen der weiterführenden Analyse: ### Konsistente Semantik Verwenden Sie für gleichwertige Standorte, Asset-Typen, Kennzahlen und Einheiten denselben Wortschatz. Legen Sie beispielsweise fest, ob ein Portfolio `Belegung`, `people_count`, oder ein anderes vereinbartes Attribut für die Anzahl der Personen in einem Raum verwendet. Dokumentieren Sie die Zuordnung, wenn der Fachbegriff vom gespeicherten Attributnamen abweicht.\ \ Dasselbe Messsignal ohne klaren Grund unterschiedlich zu benennen (z. B. presence vs. people\_count) macht es für den Assistenten erheblich schwieriger, alle relevanten Messwerte zu erfassen, insbesondere wenn diese Attribute nicht denselben Attributtyp haben. ### Vollständige Hierarchien Verknüpfen Sie Assets mit ihren tatsächlichen Standorten und übergeordneten Assets. Eine flache Liste von Sensoren erschwert die Beantwortung von Fragen wie „welche Räume im dritten Stock“, da die Beziehung dem Agenten nicht zur Verfügung steht. ## Einschränkungen Copilot Assistant kann verfügbare Daten abrufen und analysieren, aber er kann kein inkonsistentes Asset-Modell reparieren, keine fehlenden Verlaufsdaten bereitstellen und auch keinen undefinierten geschäftlichen KPI festlegen. Fragen wie „Welche Gebäude haben das größte Potenzial?“ benötigen eine messbare Definition, z. B. Energieverbrauch, Kosten, Belegung oder eine Zielabweichung, bevor sie konsistent beantwortet werden können. Für Prompt-Muster, die den beabsichtigten Umfang explizit machen, siehe den [Prompting-Leitfaden](/collection/german/copilot-assistant/improving-results/prompting-guide.md). --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation by asking a question. Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters: ``` GET https://docs.buildings.ability.abb/collection/german/copilot-assistant/improving-results/data-requirements.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case. 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.