> 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/prompting-guide.md). # Prompting-Leitfaden Diese Seite erklärt, wie der Data Agent Anfragen interpretiert und wie man Prompts formuliert, die präzise, nützliche Ergebnisse liefern Die Art, wie Sie eine Frage formulieren, beeinflusst, wie präzise Copilot Assistant die Anfrage lösen kann. Geben Sie Umfang, Kennzahl und Zeitraum an, wenn sie relevant sind. Für die Daten hinter diesen Konzepten siehe [Datenanforderungen](/collection/german/copilot-assistant/improving-results/data-requirements.md). ## Wie Copilot Assistant eine Anfrage interpretiert Copilot Assistant sucht nach Konzepten wie: | Element | Beispiele | | --------------------------- | --------------------------------------------------------------------------------- | | **Standorte** | Gebäude, Etage, Raum, Zone, Ostflügel, Keller | | **Assets oder Asset-Typen** | Sensoren, Zähler, SmartSocket, EnergyMeter, Räume | | **Kennzahlen** | Temperatur, Energieverbrauch, Belegung, CO₂, Wasserverbrauch | | **Zeitspannen** | letzte Woche, letztes Quartal, zwischen dem 1. Januar und dem 31. Dezember, heute | Je mehr dieser Elemente Sie einbeziehen, desto präziser kann die Anfrage eingegrenzt werden. Fehlende Elemente können eine Rückfrage auslösen. ## Wirksame Prompts schreiben ### Präzisieren Sie, was genau Sie messen möchten Verwenden Sie Begriffe, die auf Attribute im Asset-Modell abgebildet werden. Der Agent ordnet zum Beispiel Messbegriffe konkreten Attributen in der Datenbank zu. \ Die richtige Wortwahl verringert das Risiko von Mehrdeutigkeiten und Auflösungsschritten. | ❌ Weniger wirksam | ✅ Wirksamer | | ----------------------------------------- | -------------------------------------------------------------------------------------------- | | Zeigen Sie mir die Daten für das Gebäude. | Zeigen Sie mir die aktuellen Temperaturwerte für alle Assets im dritten Stock von Gebäude A. | | Gibt es Probleme mit den Sensoren? | Welche Sensoren im zweiten Stock haben in den letzten 48 Stunden keine Daten gemeldet? | ### Bekannte Entitäten benennen Nennen Sie Asset-Namen, Asset-Typen oder genaue Standorte, wenn Sie sie kennen. Das reduziert Mehrdeutigkeiten und kann die Antwort beschleunigen. | ❌ Weniger wirksam | ✅ Wirksamer | | -------------------------- | ---------------------------------------------------------------------------------------------------- | | Welche Räume sind warm? | Welche `RoomController` Assets im zweiten Stock messen Temperaturen über 24 °C? | | Prüfen Sie die Steckdosen. | Rufen Sie den aktuellen Stromverbrauch aller Assets mit dem Asset-Typ ab `SmartSocket` in Gebäude A. | ### Für historische Abfragen einen Zeitraum angeben Zeiträume sind für Trendabfragen wichtig. Ohne einen solchen Zeitraum kann Copilot Assistant um Klarstellung bitten oder ein kurzes Standardfenster anwenden. | ❌ Weniger wirksam | ✅ Wirksamer | | ----------------------------------------------------- | --------------------------------------------------------------------------------- | | Zeigen Sie mir den Energieverbrauch für Building B2F. | Zeigen Sie mir den gesamten Energieverbrauch für Building B2F im letzten Quartal. | | Wann war die Belegung am höchsten? | Wie hoch war die tägliche Spitzenbelegung in Gebäude A im letzten Quartal? | {% hint style="info" %} Größere Zeiträume können Datenbankabfragen und die anschließende Analyse der Ergebnisse verlangsamen. {% endhint %} ### Stellen Sie immer nur eine klare Frage auf einmal Copilot Assistant behält den Kontext über ein Gespräch hinweg bei. Teilen Sie eine komplexe Anfrage in gezielte Folgefragen auf, statt nicht zusammenhängende Kennzahlen und Zeiträume in einem Prompt zu kombinieren. | ❌ Weniger wirksam | ✅ Wirksamer | | --------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------ | | Zeigen Sie mir Energie, Belegung, Temperatur und Alarme für alle Gebäude für das letzte Jahr. | Zeigen Sie mir den gesamten Energieverbrauch pro Gebäude für das letzte Quartal. Stellen Sie dann eine Folgefrage zur Belegung für denselben Zeitraum. | ## Geschäftsbegriffe definieren Geschäftsbegriffe sind nur dann nützlich, wenn sie eindeutig dem Asset-Modell zugeordnet werden können. Begriffe wie *Auslastungslücke*, *Potenzial*, oder *Energieintensität* benötigen eine definierte Kennzahl und einen definierten Umfang, bevor Copilot Assistant sie zuverlässig einordnen oder vergleichen kann. Statt zu fragen *„Welche Standorte zeigen das größte Verbesserungspotenzial?“*, fragen Sie *„Welche Gebäude haben im letzten Quartal den höchsten Energieverbrauch gehabt? Ordnen Sie sie ein.“* Statt zu fragen *„Gibt es Anomalien?“*, fragen Sie *„Gibt es Assets im Serverraum, die letzte Woche Temperaturen über 80 °C gemeldet haben?“* ## Nützliche Muster * Verwenden Sie genaue Namen von Asset-Typen, wenn Sie sie kennen. * Geben Sie Einheiten an wie `kWh` oder `°C` wenn mehrere Attribute passen könnten. * Folgen Sie den vorgeschlagenen Prompts, um ein Ergebnis weiter einzugrenzen. * Beginnen Sie bei der Erkundung eines unbekannten Portfolios breit und grenzen Sie dann den Umfang ein. * Erweitern Sie die Tool-Aufrufspur, wenn ein Ergebnis unerwartet erscheint. Sie zeigt, welche Assets und Messungen aufgelöst wurden. ## Häufige Fehler | Fehler | Was passieren kann | So verbessern Sie die Anfrage | | ------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------- | | Ein Geschäftsbegriff hat keine direkte Zuordnung | Copilot Assistant bittet um Klarstellung oder wählt das nächstgelegene verfügbare Attribut aus. | Verwenden Sie die im Asset-Modell definierten Attribut- oder Messbegriffe. | | Eine historische Anfrage hat keinen Zeitraum | Copilot Assistant bittet um Klarstellung oder wendet ein kurzes Standardfenster an. | Geben Sie einen Zeitraum an, zum Beispiel `letzte 7 Tage`, `letztes Quartal`, oder `vorherige 2 Monate`. | | Mehrere nicht zusammenhängende Fragen werden kombiniert | Ergebnisse können unvollständig sein oder eine Anfrage kann nachrangig behandelt werden. | Teilen Sie die Anfrage in Folge-Prompts auf. | | Ein Standortname ist mehrdeutig | Mehrere Entitäten können passen, und Copilot Assistant bittet Sie, eine Auswahl zu treffen. | Geben Sie einen Asset-Namen, -Typ oder einen anderen eindeutigen Bezeichner an. | | Aus Rohdaten wird ein geschäftliches Fazit erwartet | Copilot Assistant ruft Daten ab und stellt sie dar, aber die geschäftliche Interpretation kann undefiniert bleiben. | Geben Sie die Kennzahl, den Vergleich, den Basiswert oder die Entscheidungsregel an, die Sie anwenden möchten. | --- # 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/prompting-guide.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.