> 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-assistent/quick-start.md).

# Schnellstart

Auf dieser Seite werden Sie durch das Senden Ihrer ersten Abfrage, das Lesen der Antwort und das Verstehen dessen, was der Agent zur Erstellung getan hat, geführt.

## Voraussetzungen

* Gültiger Zugriff auf Copilot Assistant. Siehe [Zugriff und Testversion](/collection/german/copilot-assistent/access-and-trial.md).
* Assets [konfiguriert](/collection/german/verpflichtende-basis/assets.md) im Portfolio, idealerweise mit bereits eingehenden Daten

Bevor Sie beginnen, vergewissern Sie sich, dass Copilot Assistant für Ihren Mandanten in [Zugriff und Testversion](/collection/german/copilot-assistent/access-and-trial.md), und lesen Sie [Ergebnisse verbessern](/collection/german/copilot-assistent/improving-results.md).

## Ihre erste Abfrage

Die Copilot Assistant-Seite ist der zentrale Ort, um neue Gespräche zu starten, vorherige fortzusetzen und den Gesprächsverlauf zu verwalten.

<figure><img src="https://2215908449-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FOqGnkz52o2zVUsEGEZGk%2Fuploads%2FdFWEKRhOvrjtHdCGuGZx%2FAI%20Assist%20open.png?alt=media&amp;token=677c8438-2918-49cc-ad12-6143e8736120" alt="Copilot Assistant welcome page"><figcaption><p>Copilot Assistant-Begrüßungsseite mit dem Eingabefeld für Prompts und vorgeschlagenen Prompts.</p></figcaption></figure>

### Ein Gespräch beginnen

1. Klicken Sie in der oberen Menüleiste auf *KI-Assistent* **\[1]**.\
   ▷ Die Copilot Assistant-Begrüßungsseite wird geöffnet.
2. Geben Sie auf der Begrüßungsseite einen Prompt ein oder wählen Sie unten einen der Vorschläge aus, um ein neues Gespräch zu beginnen **\[2]** oder setzen Sie links aus dem Gesprächsverlauf ein vorheriges fort.
3. Wenn Ihr Prompt passt, klicken Sie auf die *Senden-Schaltfläche* **\[3]**.\
   ▷ Die Anfrage wird verarbeitet, und zwischenschrittliche Fortschrittsmeldungen werden sichtbar.

Eine gute erste Abfrage ist spezifisch und leicht zu überprüfen:

* *"Wie viele Assets sind in meinem Portfolio?"*
* *"Zeigen Sie mir alle Alarme mit hoher Priorität."*
* *"Wie sind die aktuellen Temperaturen in meinen Gebäuden?"*
* *"Zeigen Sie mir den durchschnittlichen wöchentlichen Energieverbrauch für alle Gebäude in den letzten sechs Monaten."*

### Verstehen Sie die Tool-Aufrufspur

Während der Assistent eine Anfrage verarbeitet, ruft er Tools auf, um die Anfrage der Asset-Struktur zuzuordnen, Daten abzurufen, Ergebnisse zu analysieren und Visualisierungen zu erstellen. \
Die Tool-Aufrufspur zeigt, wie Ihre Anfrage interpretiert wurde und welche Verarbeitungsschritte abgeschlossen wurden. Sie zu prüfen ist der schnellste Weg zu verstehen, warum eine Antwort so aussieht, wie sie aussieht, und wo Sie sie umformulieren sollten, wenn sie nicht Ihrer Absicht entspricht.

> **Beispiel:** Verarbeitung der Abfrage *"Zeigen Sie mir den durchschnittlichen wöchentlichen Energieverbrauch der letzten 6 Monate für alle Gebäude"*

<figure><img src="https://2215908449-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FOqGnkz52o2zVUsEGEZGk%2Fuploads%2FzTjbpiTXZc1N74tdMZ6L%2FAI%20Assist%20tool%20calling%20details.png?alt=media&amp;token=9c4e2711-dae2-4c00-98fa-870b46522833" alt="Copilot Assistant tool calling details"><figcaption><p>Beispiel für eine Tool-Aufrufspur bei einer Anfrage zum wöchentlichen Energieverbrauch.</p></figcaption></figure>

Für die Abfrage *"Zeigen Sie mir den durchschnittlichen wöchentlichen Energieverbrauch für alle Gebäude in den letzten sechs Monaten"*, rief der Assistent **4 Tools** auf und **2 Unteragenten**:

1. Den Standortbegriff auflösen *'Gebäude'* aus der Anfrage unter **\[E1]**.\
   ◈ Es fand ein passendes [Asset-Typ](/collection/german/erste-schritte/2.-setting-up-assets/asset-modeling.md) *Gebäude*\
   ◈ Es untersuchte mehrere Assets mit diesem Asset-Typ (z. B. mehrere SmartOffice-Gebäude)
2. Den Messbegriff auflösen *'Energieverbrauch'* **\[E2]**.\
   ◈ Es verwendet den zuvor abgerufenen Asset-Typ Gebäude als Bedingung und untersucht nur Entitäten innerhalb dieser Gebäude\
   ◈ Da die Anfrage darauf abzielt, eingehende Daten zu analysieren, werden nur [Asset-Messungen](/collection/german/verpflichtende-basis/platform-core/asset-core/create-a-new-template.md) mit dem Untertyp input berücksichtigt\
   ◈ Die Anfrage gibt einen Zeitraum der letzten 6 Monate an, daher werden nur Assets abgerufen, die in diesem Zeitraum aktiv Daten aufgezeichnet haben\
   ◈ Es wurden mehrere Asset-Typen erkannt, die den Energieverbrauch messen und Asset-Instanzen haben, die in den letzten 6 Monaten aktiv waren\
   ◈ Ergebnisse werden als AssetType.Attribut angezeigt und zeigen auch den Attributtyp und gegebenenfalls die Einheit an
3. Sobald der Assistent den Asset-Umfang bestimmt hat, ruft er den spezialisierten SQL-Unteragenten auf, um die entsprechenden Daten aus der Datenbank abzurufen **\[E3]**.\
   ◈ Der SQL-Unteragent konnte 255 Datenzeilen abfragen und zurückgeben – von denen der Hauptassistent eine Vorschau von 10 Zeilen sieht
4. Der Assistent prüft und analysiert die Ergebnismenge deterministisch **\[E4]**.\
   ◈ Er wendete drei Operationen auf das gesamte Datenbankergebnis an, um die wichtigsten Ergebnisse zu berechnen: *durchschnittlicher Gesamtenergieverbrauch*, *niedrigster durchschnittlicher Energieverbrauch*, *höchster durchschnittlicher Energieverbrauch*
5. Er verwendet die berechneten Kennzahlen, um KPI-Karten zu erstellen, die sie dem Benutzer visualisieren **\[E5]**
6. Der Assistent entscheidet anhand der zurückgegebenen Daten und der Benutzeranfrage, dass Diagramme geeignet sind, und ruft den Visualisierungs-Unteragenten auf **\[E6]**.\
   ◈ Der Visualisierungs-Unteragent entscheidet, die vollen 250 Datenzeilen und nicht nur eine Vorschau von 10 Zeilen zu visualisieren

   ◈ Der Unteragent erstellt ein Liniendiagramm, das den durchschnittlichen wöchentlichen Energieverbrauch auf der y-Achse und die Woche auf der x-Achse anzeigt. Außerdem erstellt er für jedes Gebäude eine Datenreihe im Diagramm.

### Die Antwort lesen

Jede Antwort enthält eine textliche Erklärung und kann Ergebnis-Artefakte im aktiven Chatfenster enthalten **\[A]**.

<figure><img src="https://2215908449-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FOqGnkz52o2zVUsEGEZGk%2Fuploads%2FmytHQv4WdBcxp4agH2KM%2FAI%20Assist%20Page.png?alt=media&amp;token=5b96e8fa-bd9e-4b2e-8f5b-2331f786f5c1" alt="Copilot Assistant response with result artifacts"><figcaption><p>Copilot Assistant-Antwort mit dem Gesprächsverlauf, der Tool-Aufrufspur, dem Daten-Artefakt, KPI-Karten, Diagrammen und Chat-Steuerelementen.</p></figcaption></figure>

Während jede Antwort eine abschließende textliche Rückmeldung darüber enthält, was abgerufen und analysiert wurde, enthält sie auch mehrere Artefakte, die die zugrunde liegenden Asset-Daten zeigen und die Ergebnisse visualisieren.\
Sobald der Assistent Ihre Anfrage verarbeitet hat, macht er die Ergebnis-Artefakte sichtbar, sobald sie verfügbar sind.\
\
Jede Antwort kann Folgendes enthalten:

| Markierung | Komponente          | Beschreibung                                                                                                               |
| ---------- | ------------------- | -------------------------------------------------------------------------------------------------------------------------- |
| **\[E]**   | **Tool-Aufrufspur** | Ein Protokoll der vom Agenten durchgeführten Schritte (erweiterbar)                                                        |
| **\[H]**   | **Datentabelle**    | Rohe Abfrageergebnisse                                                                                                     |
| **\[I]**   | **KPI-Karten**      | 1-3 hervorgehobene Schlüsselzahlen aus den abgerufenen Daten                                                               |
| **\[K]**   | **Diagramme**       | Automatisch generiert, wenn die Daten sich für eine Visualisierung eignen (kann in einem Dialog erweitert werden **\[J]**) |

Sobald der Assistent den Durchgang abgeschlossen hat, haben Sie mehrere Möglichkeiten fortzufahren:

1. Ein neues Gespräch beginnen, indem Sie einen neuen Chat erstellen **\[C]**.\
   ▷ Die ursprüngliche Begrüßungsseite wird geöffnet.
2. Eine Folgeanfrage senden **\[L] + \[M]**.\
   ▷ Ein neuer Durchgang beginnt – der Assistent behält weiterhin den Kontext des vorherigen Durchgangs.

{% hint style="info" %}
Wenn der Gesprächs-Stream an irgendeinem Punkt unterbrochen wurde, kann die **Schaltfläche „Chat aktualisieren“ \[G]** verwendet werden, um die neuesten Aktualisierungen abzurufen, ohne die Seite neu laden zu müssen
{% endhint %}

Das erweiterte Daten- & Abfrage-Artefakt ist unten dargestellt. Es enthält die Rohdaten, den Abfrage-Editor und Export-Steuerelemente.

<figure><img src="https://2215908449-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FOqGnkz52o2zVUsEGEZGk%2Fuploads%2FUjDy3G6aXAUzvDR98bON%2FAI%20Assist%20Data%20and%20query.png?alt=media&amp;token=e06aa1a6-2fb8-468a-a603-54170a2940dd" alt="Expanded Copilot Assistant Data and Query artifact"><figcaption><p>Erweitertes Daten- &#x26; Abfrage-Artefakt mit Rohdaten, Abfrage-Editor und CSV-Export.</p></figcaption></figure>

In dieser Abbildung:

* **\[H1]** kennzeichnet das erweiterte Daten- & Abfrage-Artefakt und seine Tabs.
* **\[H2]** kennzeichnet das CSV-Export-Steuerelement.
* **\[H3]** kennzeichnet die Rohdaten-Tabelle.

Wenn ein Gespräch länger wird, wechseln Sie in den Tabs-Modus, um zwischen Anfragen zu navigieren.

Die Steuerung oberhalb des Chatfensters wechselt den Anzeigemodus **\[D]**. Der Tabs-Modus kann verwendet werden, um zwischen den Anfragen in einem längeren Gespräch zu navigieren **\[D1]**.

<figure><img src="https://2215908449-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FOqGnkz52o2zVUsEGEZGk%2Fuploads%2FtIDw0IhvYycmXPit0clB%2FAI%20Assist%20Tabs.png?alt=media&amp;token=2ce726c2-68e7-4448-8bf4-5178ba144006" alt="Copilot Assistant Tabs mode"><figcaption><p>Tabs-Modus zum Navigieren zwischen Gesprächsdurchgängen.</p></figcaption></figure>

## Das Gespräch fortsetzen

Nach einer Antwort können Sie:

1. Einen neuen Chat erstellen **\[C]**.
2. Eine gezielte Folgefrage senden **\[L]** mit dem Eingabefeld **\[M]**. Copilot Assistant behält den relevanten Kontext des vorherigen Durchgangs bei.
3. Öffnen Sie das Seitenpanel „Agent Debug“ **\[F]** um detaillierte Gesprächs- und Tool-Informationen zu prüfen.

Wenn der Gesprächs-Stream unterbrochen ist, verwenden Sie die **Chat aktualisieren** Schaltfläche **\[G]** um die neuesten Aktualisierungen abzurufen.

## Zusätzliche Konfiguration

* Die Copilot Assistant-Einstellungen ermöglichen es Ihnen, das Verhalten des Agenten anzupassen **\[B]**.
* Das Seitenpanel „Agent Debug“ bietet detaillierte Informationen über das Gespräch und die Ergebnisse der aufgerufenen Tools **\[F]**.

## Tipps

* Nennen Sie das Asset, den Standort oder den Asset-Typ, wenn Sie ihn kennen.
* Geben Sie einen Zeitraum für historische Daten an.
* Geben Sie eine Einheit an, wenn mehrere Messungen passen könnten.
* Beginnen Sie mit einer klaren Frage und verfeinern Sie sie mit Folgefragen.
* Verwenden Sie den [Prompting-Leitfaden](/collection/german/copilot-assistent/improving-results/prompting-guide.md) wenn das Ergebnis nicht Ihrer Absicht entspricht.


---

# 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 dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.buildings.ability.abb/collection/german/copilot-assistent/quick-start.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.