> 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/suites/space-and-assets-analytics/copilot-assistant.md).

# Copilot Assistant

Copilot Assistant is a natural-language interface for exploring asset and operational data in the Space & Assets Analytics Suite and the GenAI Assistant solution of BuildingPro Suites. \
It allows business users to interact with their assets & data in plain language and receive actionable, explainable insights grounded in their live data and asset model.

## What It Enables

As portfolios grow and integrate larger numbers of assets, navigating and analyzing all of this data manually becomes increasingly complex.\
Building a dashboard first or using the [Script Engine](/collection/platform/platform-core/script-engine.md) to bring data into the desired format takes time and requires technical knowledge that most business users do not have.\
This module removes that barrier. Instead of retrieving raw data manually, users can explore buildings and portfolios conversationally - asking questions in plain language the same way they would ask a data analyst.

With Copilot Assistant, users can:

* Ask ad-hoc questions about assets and their data
* Analyse building and portfolio performance conversationally
* Accelerate decision-making through simplified access to complex operational data
* Receive answers in the form of tables, charts, and reports

## How it Works

Requests are processed by a specialized agent. The agent resolves the concepts in your query against your project's asset model, executes the necessary data queries, analyses the results, and returns them in a structured format and visualisations. Users do not need to write queries or understand the underlying data structure.

▷ See [Data Agent](/collection/suites/space-and-assets-analytics/copilot-assistant/agent-modes/data-agent.md) for a detailed description of how requests are processed

## Typical Use Cases

Copilot Assistant accelerates self-service analytics while keeping governance in place. It makes advanced portfolio analysis accessible to business users, not only technical analysts.

| Scenario               | Example                                                                           |
| ---------------------- | --------------------------------------------------------------------------------- |
| Ad-hoc portfolio check | "What is the average energy consumption per building this month?"                 |
| Operational drill-down | "Which rooms on the 3rd floor of Building A are above 24°C?"                      |
| Data quality review    | "Which sensors haven't reported data in the last 7 days?"                         |
| Comparative analysis   | "Compare CO₂ levels in meeting rooms during morning and afternoon hours."         |
| Asset exploration      | "How many assets are configured in Location X, grouped by asset type?"            |
| Alarm review           | "Show me all high-priority alarms triggered in the east wing since last Tuesday." |

## What it is Not

The Copilot Assistant is a focused analytical tool that can integrate with different platform features and their data. It is not a general-purpose AI chatbot. It answers questions grounded in the assets and data of your project. It does not replace analytical judgment but rather accelerates retrieval and exploration so users can reach insight faster. 


---

# 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/suites/space-and-assets-analytics/copilot-assistant.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.