catenax-ng/product-agents

Reference Implementations of Knowledge Agents (Deprecated - please use https://github.com/catenax-ng/tx-knowledge-agents instead)

Tractus-X Knowledge Agents Reference Implementations (KA)

KA is a product of the Catena-X Knowledge Agents Kit implementing the binding modules of the CX-0084 standard (Federated Queries in Dataspaces).

• See the copyright notice
• See the authors file
• See the license file
• See the code of conduct
• See the contribution guidelines
• See the dependencies and their licenses

About the Project

This repository provides FOSS implementations for so-called Agents.

An "Agent" is a (re- as well as pro-active) component which understands, partially elaborates and possibly delegates declarative scripts or queries (the so-called "Skills") over individual data and service assets ("Knowledge Graphs") of the dataspace.

Agents speak Semantic Web Based dataspace protocols (such as SPARQL) which are negotiated and transferred by the Tractus-X Knowledge Agent Extensions for the Eclipse Dataspace Components (KA-EDC). Binding Agents translate these protocols to your backend data storage or API.

We provide several of agent implementations in this product.

• Matchmaking Agent (KA-MATCH upcoming) An agent implementation is needed by any Agent-Enabled dataspace participant to reason about the Dataspace/EDC (and hence: other Matchmaking Agents). It is also able to delegate work on sub-graphs/asset to tenant-internal agents (Binding Agents) providing actual data and functions. For Agent-Enabled dataspace consumers, deploying the Matchmaking Agent alongside an Agent-Enabled EDC is sufficient.
• Binding Agents are needed by any Agent-Enabled dataspace provider in order to link the Dataspace/Protocol layer to the actual Data and Functional Resources. Binding (sometimes: Bridging) is a technology which rather translates between protocols rather than translating data (Mapping).
  • Provisioning Agent (KA-PROV) An agent implementation which binds typical SQL-based backend data sources to SPARQL.
  • Remoting Agent (KA-RMT) An agent implementation which binds typical REST services to SPARQL.
• Conforming Agent (KA-CONF) An agent implementation which may play any role (Matchmaking Agent, Binding Agent, EDC Transfer) in order to test the conformity of all other parts of the architecture/standard.

Included in this repository are ready-made Helm charts. They can be installed from the Catena-X Knowledge Agents Kit Helm Repository.

Getting Started

Build

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

mvn package -Pwith-docker-image

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

mvn -s settings.xml publish

Deployment

• See the individual agent documentations
  • Provisioning Agent
  • Remoting Agent
  • Conforming Agent