For the complete documentation index, see llms.txt. This page is also available as Markdown.

Data Requirements

Copilot Assistant works with the data available in your asset hierarchy. It does not create missing measurements or infer a reliable meaning for an asset that is not described clearly. While it can work in theory with a loosely defined hierarchy and lax asset model it might not be able to realize its full potential. Preparing the data foundation is therefore as important as writing a good prompt.

Minimum Requirements

The following conditions are required for useful data requests:

  • You have an asset catalog contains the relevant locations, assets, and measurements.

  • The asset hierarchy represents the relationships between those assets, such as portfolio -> site -> building -> floor -> room -> asset. This makes the Assistant understand the locational relationships of your data.

  • Assets and locations have stable, recognizable names. Use consistent naming for the same type of entity across buildings.

  • Asset types, tags, and attributes describe what an asset represents -> these should be used consistently across all assets.

  • Measurements have meaningful attribute names, attribute types and, where applicable, a unit such as °C, kWh, or %.

  • Current data is available for live-status questions, and historical data is available for trend or comparison questions.

  • Users have access to the assets and data they are asking about. Copilot Assistant cannot query data outside the permitted context of the specific user.

If one of these conditions is missing, Copilot Assistant may ask for clarification, return no matching data, or produce a result that is narrower than intended.

Data That Improves Business Value

Data can be technically available and still be difficult to use for decisions. The following practices improve resolution, response quality, and the usefulness of follow-up analysis:

Consistent Semantics

Use the same vocabulary for equivalent locations, asset types, metrics, and units. For example, decide whether a portfolio uses occupancy, people_count, or another agreed attribute for the number of people in a room. Document the mapping when the business term differs from the stored attribute name. Naming the same measurement differently without a clear reason (e.g. presence vs. people_count) makes it much harder for the assistant to catch all relevant measurements, especially if these attributes do not have the same attribute type.

Complete Hierarchies

Link assets to their real locations and parent assets. A flat list of sensors makes questions such as "which rooms on the third floor" difficult to resolve because the relationship is not available to the agent.

Limitations

Copilot Assistant can retrieve and analyze available data, but it cannot repair an inconsistent asset model, supply missing history, or decide an undefined business KPI. Questions such as "Which buildings have the biggest opportunity?" need a measurable definition, such as energy consumption, cost, occupancy, or a target deviation, before they can be answered consistently.

For prompt patterns that make the intended scope explicit, see the Prompting Guide.

Last updated