README.md

Tractus-X Knowledge Agents AAS Bridges (KA-AAS)

Tractus-X Knowledge Agents AAS Bridges (KA-AAS) is a product of the Catena-X Knowledge Agents Kit (about to move to: Tractus-X Knowledge Agents Kit). It implements bridging components between the Catena-X Association's CX-0084 (Federated Queries in Dataspaces) and Industrial Digitial Twin Association's AAS Part 1 & 2 (Asset Administration Sheel) standards.

• See the Authors
• See the Changelog
• See the Code of Conduct
• See the Contribution Guidelines
• See the License
• See the Notice on 3rd Party Software
• See this Readme
• See the Security Notice

About the Project

This repository provides FOSS implementations for so-called bridging components between 'Knowledge Agents' and 'Asset Administration Shells'.

According to CX-0084, an "Agent" is a component that allows to represent and query a backend system ('source') using Semantic Web protocols (such as SPARQL).

According to AAS Part 1 & 2, an "Asset Administration Shell" (Server, Registry) is a component that allows to represent and query a source using a predefined REST Api.

Both Knowledge Agents as well as AAS components are expected to be compatible to the Tractus-X EDC connector.

Currently we provide the following bridge components:

• Knowledge Agents Sparql-To-AAS Bridge (KA-AAS-SPARQL) Implements an AAS server/AAS registry interface that is backed by a one or several agents. Using a templating approach, queries to the AAS API are translated into SPARQL queries. Changes in the (virtual) knowledge graph should be automatically reflected in changes to the resulting (virtual) AAS tree.

Included in this repository are ready-made Helm charts.

They can be installed from the Tractus-X Helm Repository (Stable Versions) or Tractus-X Helm Repository (Dev Versions).

Getting Started

Build

To compile, package and containerize the binary artifacts (includes running the unit tests)

./mvnw package -Pwith-docker-image

To publish the binary artifacts (environment variables GITHUB_ACTOR and GITHUB_TOKEN must be set)

./mvnw -s settings.xml publish

Deployment

Deployment can be done

• via JAR libraries copied into your Java runtime
• via Docker images
• via Helm Charts (Stable Versions) or Helm Charts (Dev Versions)

See the individual bridge documentations for more detailed deployment information

• Knowledge Agents Sparql-To-AAS Bridge (KA-AAS-SPARQL)

Notice for Docker Images

• Notice for Knowledge Agents Sparql-To-AAS Bridge (KA-AAS-SPARQL)