Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.xpertai.cn/llms.txt

Use this file to discover all available pages before exploring further.

The ontology workspace is the semantic overview workspace of the UOSE system. It elevates ontology capabilities from individual resource details into a cross-resource view, helping users see which resources have completed semantic publishing, whether the current graph is healthy, and whether entities can be searched and located.

​
Workspace Goals

The ontology workspace answers three types of questions:
  • Resource status: which resources exist in the current organization, which have current snapshots, and which failed or are missing publishing.
  • Entity search: whether users can search entities across resources by name, external key, alias, or entity type.
  • Graph validation: after selecting a resource, whether the current ontology graph, node relationships, and attribute details can be viewed.
It is the acceptance entry point after resource access and the semantic check entry point before Agents use resources.

​
Snapshot Health

The ontology workspace displays snapshot health by resource:
  • ready: the current resource has a usable snapshot and projection.
  • pending: sync or publishing is in progress.
  • publish_failed: ontology publishing failed.
  • projection_failed: instance projection failed.
  • missing_snapshot: the resource has not produced a current snapshot.
When a resource is missing a snapshot, sync usually needs to run first. When publishing or projection fails, go to resource details to inspect sync jobs and abnormal events. The ontology workspace supports search by:
  • Entity name or display label.
  • External key.
  • Alias.
  • Entity type.
Search results return the resource where the entity is located, entity type, match method, ontology ID, and base attributes. Users can use search results for graph positioning in resource details, Agent target selection, or troubleshooting.

​
Single-resource Graph

After selecting a resource that has a snapshot, you can view the single-resource graph:
  • Nodes represent entity instances.
  • Edges represent relationship instances.
  • Colors and legends distinguish entity types.
  • The details panel displays entity attributes, relationships, and raw value summaries.
For large graphs, the system enables or allows manually enabling very-large-graph mode, reducing labels and layout calculation to keep the graph usable.

​
Ontology Assistant

The ontology workspace can mount the ontology assistant. Conversations carry the current resource, snapshot, graph version, selected entity, and search term so users can ask in semantic context:
  • What key entity types exist in this resource.
  • Why a metric cannot execute a query.
  • Which actions a SAP Entity Set can execute.
  • Which necessary relationships are missing from the current graph.
The ontology assistant depends on Tenant Ontology Runtime and Ontology Assistant initialization. If it is not initialized, the page prompts the user to contact an administrator.