Skip to main content
Version: 24.05

Contracts and Policies

Behaviour Twin KIT banner

Behaviour Twin KIT

Applies to roles: skill provider, data provider, calculation service provider and delegator

OVERVIEW​

Data and calculation services must be bound to the knowledge graph by binding agents. To make the bindings accessible to the Knowledge Agents, they must be registered as a graph assets at the EDC connector. In addition, when providing a skill, this must be registered as a skill asset at the EDC connector. For both cases, policies and contract definitions are also needed.

GRAPH ASSETS​

GRAPH ASSET POLICY​

The graph asset policy can be used by more than one graph asset. The policy refers to a Use Case Framework Agreement. There may be more requirements for policies within a use case.

{
  "@context": [
    "http://www.w3.org/ns/odrl.jsonld", 
    {
      "edc": "https://w3id.org/edc/v0.0.1/ns/"
    },
    {
      "cx-policy": "https://w3id.org/catenax/policy/"
    }
  ],
  "@type": "PolicyDefinitionRequestDto",
  "@id": "GraphAsset?me=Policy&useCase=BehaviourTwin",
  "edc:policy": {
    "@type": "Set",
    "profile": "cx-policy:profile2405",
    "permission": [{
      "action": "use",
      "constraint": {
        "leftOperand": "cx-policy:FrameworkAgreement",
        "operator": "eq",
        "rightOperand": "behaviourtwin:1.0"
      }
    }]
  }
}

GRAPH ASSET CONTRACT​

The following contract refers to the previous defined graph policy and related graph assets:

{
  "@context": {
    "cx-common": "https://w3id.org/catenax/ontology/common#"
  },
  "@id": "Contract?me=Graph",
  "@type": "ContractDefinition",
  "accessPolicyId": "Policy?me=Graph",
  "contractPolicyId": "Policy?me=Graph",
  "assetsSelector": {
    "@type": "CriterionDto",
    "operandLeft": "https://w3id.org/catenax/ontology/common#publishedUnderContract",
    "operator": "=",
    "operandRight": "Contract?me=Graph"
  }
}

SKILL ASSETS​

SKILL ASSET POLICY​

The skill asset policy can be used by more than one skill asset. There may be more requirements for policies within a use case.

{
  "@context": {
    "@vocab": "https://w3id.org/edc/v0.0.1/ns/",
    "cx-common": "https://w3id.org/catenax/ontology/common#"
  },
  "@id": "Policy?me=Skill",
  "policy": {
    "@context": "http://www.w3.org/ns/odrl.jsonld",
    "@type": "Set",
    "uid": "https://w3id.org/catenax/ontology/common#Policy?me=Skill",
    "permission": [{
      "target": "https://w3id.org/catenax/ontology/common#SkillAsset?me=",
      "action": "USE",
      "constraint": {
        "@type": "LogicalConstraint",
        "or": [{
          "@type": "Constraint",
          "leftOperand": "BusinessPartnerNumber",
          "operator":"eq",
          "rightOperand": "BPNL00000PARTNER"
        },
        {
          "@type": "Constraint",
          "leftOperand": "BusinessPartnerNumber",
          "operator":"eq",
          "rightOperand": "BPNL000000001234"
        }]
      }
    }]
  }
}

SKILL ASSET CONTRACT​

The following contract refers to the previous defined skill policy and related skill assets:

{
  "@context": {
    "cx-common": "https://w3id.org/catenax/ontology/common#"
  },
  "@id": "Contract?me=Skill",
  "@type": "ContractDefinition",
  "accessPolicyId": "Policy?me=Skill",
  "contractPolicyId": "Policy?me=Skill",
  "assetsSelector": [{
    "@type": "CriterionDto",
    "operandLeft": "https://w3id.org/catenax/ontology/common#publishedUnderContract",
    "operator": "=",
    "operandRight": "Contract?me=Skill"
  }]
}

For more information, have a look at the Agents KIT's Operation View.