Skip to content

Commit cf84f27

Browse files
feat(uipath-ontology-modeler): build ontologies as local solutions [DS-9944]
The modeler builds an ontology as a local UiPath solution: one ontology resource plus the local Data Fabric entities, choice sets and federated entities it reads, authored with the `uip ont --local` and `uip df ... --local` commands, validated with the ontology service and packed. Nothing is created on the tenant before deploy. - uipath-ontology-modeler: CLI-driven flow, artifact, entity, relationship, mapping and summary guides, and an upgrade guide for a deployed solution (TypeIncompatible on a FILE field). - uipath-ontology-authoring: hands a confirmed model off to the modeler. - uipath-solution: deploys solutions that carry an ontology and resolves an ontology name conflict at deploy. - ontology-tests: contract harness, golden, smoke and e2e tasks; the ontology skills are registered in the genome and Studio Web lists. Jira: DS-9944 Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
1 parent bc27ee0 commit cf84f27

50 files changed

Lines changed: 3801 additions & 4 deletions

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

‎.github/workflows/test-helpers.yml‎

Lines changed: 20 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -250,6 +250,26 @@ jobs:
250250
- name: Run contract guard
251251
run: pytest tests/scripts/test_runtime_payload_key_casing.py -v
252252

253+
ontology-skill-contract:
254+
runs-on: uipath-ubuntu-latest
255+
name: ontology skill contract guards
256+
steps:
257+
- uses: actions/checkout@11d5960a326750d5838078e36cf38b85af677262 # v4.4.0
258+
259+
- uses: actions/setup-python@a26af69be951a213d495a4c3e4e4022e16d87065 # v5.6.0
260+
with:
261+
python-version: '3.13'
262+
263+
- name: Install pytest
264+
run: pip install pytest pyyaml
265+
266+
# Frontmatter, registry, CODEOWNERS and content contract of the two
267+
# ontology skills (uipath-ontology-modeler, uipath-ontology-authoring).
268+
# The golden flow skips unless UIP_CLI points at a build with `uip ont`;
269+
# listing it here keeps it collected and import-clean.
270+
- name: Run contract guards
271+
run: pytest tests/scripts/test_ontology_skill_contract.py tests/scripts/test_ontology_solution_golden.py -v -rs
272+
253273
# One job for every BPMN contract guard, listed explicitly: a glob that stops
254274
# matching is a silently green job, and `-k` over the directory couples this
255275
# job to unrelated files' collection. Add new guards to the run step.

‎CODEOWNERS‎

Lines changed: 10 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -63,6 +63,16 @@
6363
/tests/tasks/uipath-platform/data-fabric/ @UiPath/DatafabricCodingAgent
6464
/tests/tasks/uipath-platform/licensing/ @biftime @mihai-stef-uipath @dinud-uipath @bogdan-alexandru-uipath @raresgrm @cristiansinescu7-uipath
6565

66+
# Ontology skills (local solution: Ontology + local Entity resources)
67+
/skills/uipath-ontology-authoring/ @diwakar-jha3110
68+
/skills/uipath-ontology-modeler/ @diwakar-jha3110
69+
/skill-flavors/studioweb/uipath-ontology-authoring/ @diwakar-jha3110
70+
/skill-flavors/studioweb/uipath-ontology-modeler/ @diwakar-jha3110
71+
/tests/tasks/uipath-ontology-authoring/ @diwakar-jha3110
72+
/tests/tasks/uipath-ontology-modeler/ @diwakar-jha3110
73+
/tests/scripts/test_ontology_skill_contract.py @diwakar-jha3110
74+
/tests/scripts/test_ontology_solution_golden.py @diwakar-jha3110
75+
6676
# Agents skill (coded + low-code)
6777
/skills/uipath-agents/ @UiPath/team-coded-agents @AlexandruCGhimisi @andreibalas-uipath @al3xanndru @andreitava-uip @UiPath/team-agents-cli
6878
/tests/tasks/uipath-agents/ @UiPath/team-coded-agents @AlexandruCGhimisi @andreibalas-uipath @al3xanndru @andreitava-uip @UiPath/team-agents-cli

‎README.md‎

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -106,6 +106,8 @@ Every skill's maturity is tracked in [`assets/skill-status.json`](assets/skill-s
106106
| `uipath-maestro-case` | Preview |
107107
| `uipath-maestro-flow` | Stable |
108108
| `uipath-mcp-servers` | Preview |
109+
| `uipath-ontology-authoring` | In-development |
110+
| `uipath-ontology-modeler` | In-development |
109111
| `uipath-planner` | Stable |
110112
| `uipath-platform` | Stable |
111113
| `uipath-process-mining` | Preview |

‎assets/skill-status.json‎

Lines changed: 16 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -177,6 +177,22 @@
177177
},
178178
"last_synced": null
179179
},
180+
"uipath-ontology-authoring": {
181+
"status": "in-development",
182+
"confluence": {
183+
"page_id": null,
184+
"url": null
185+
},
186+
"last_synced": null
187+
},
188+
"uipath-ontology-modeler": {
189+
"status": "in-development",
190+
"confluence": {
191+
"page_id": null,
192+
"url": null
193+
},
194+
"last_synced": null
195+
},
180196
"uipath-planner": {
181197
"status": "stable",
182198
"confluence": {

‎docs/REQUIRED-CHECKS.md‎

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -167,6 +167,7 @@ This table is machine-read. `scripts/parse-required-checks.py` is its only parse
167167
| `uipath-admin verify negative controls` | `test-helpers.yml` |
168168
| `runtime-payload key-casing contract guard` | `test-helpers.yml` |
169169
| `maestro-bpmn contract guards` | `test-helpers.yml` |
170+
| `ontology skill contract guards` | `test-helpers.yml` |
170171
| `catalog build integrity guards` | `test-helpers.yml` |
171172
| `CLI declaration refresh unit tests` | `test-helpers.yml` |
172173
| `skills.sh grouping checker unit tests` | `test-helpers.yml` |
Lines changed: 3 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,3 @@
1+
<!--skill-flavor:host-support-extra:start-->
2+
> **Not available in Studio Web.** The local solution build this skill delegates (the `--local` `uip ont` and `uip df entities` commands) needs a local solution folder, which Studio Web does not provide. Stop before Phase 3 and tell the user to author the ontology with the local `uip` CLI.
3+
<!--skill-flavor:host-support-extra:end-->
Lines changed: 7 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,7 @@
1+
<!--skill-flavor:host-support-extra:start-->
2+
> **Not available in Studio Web.** This skill builds a local solution folder with the `--local` `uip ont` and `uip df entities` commands, which Studio Web does not provide. Stop before writing any file and tell the user to build the ontology solution with the local `uip` CLI.
3+
<!--skill-flavor:host-support-extra:end-->
4+
5+
<!--skill-flavor:solution-create:start-->
6+
1. Studio Web cannot create a local solution; stop here (see the note at the top).
7+
<!--skill-flavor:solution-create:end-->

‎skills.sh.json‎

Lines changed: 3 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -18,7 +18,9 @@
1818
"uipath-human-in-the-loop",
1919
"uipath-ixp",
2020
"uipath-connector-builder",
21-
"uipath-functions"
21+
"uipath-functions",
22+
"uipath-ontology-authoring",
23+
"uipath-ontology-modeler"
2224
]
2325
},
2426
{

‎skills/uipath-genome/references/skill-mapping-guide.md‎

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -27,6 +27,7 @@ Every genome component and every workflow step maps to exactly one UiPath build
2727
| Document extraction model (IXP): taxonomy, training, model deployment | `uipath-ixp` | "train a model to extract fields from these documents" | IXP project reference, taxonomy files |
2828
| Process Mining app | `uipath-process-mining` | "analyse the event log", "process app" | dbt models, process-app data mapping |
2929
| MCP server / resource tools | `uipath-mcp-servers` | "expose these as MCP tools" | `uipath`-type MCP server registration |
30+
| Ontology: OWL schema, SHACL constraints and YARRRML mapping over local Data Fabric entities, packed in the solution | `uipath-ontology-modeler` | "an ontology for this domain", "a semantic model over our entities", "classes and relationships the agent can query" | `{name}.ofn`, `{name}-constraints.ttl`, `{name}-mapping.yarrrml.yml`, an Ontology resource in the `.uipx` solution |
3031

3132
**Human approval or validation checkpoints** inside a Flow, BPMN process, Case plan, or agent belong to the containing component's skill. Name `uipath-human-in-the-loop` in the Rationale column so the builder consults it for gate design.
3233

‎skills/uipath-genome/scripts/check-genome.py‎

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -54,12 +54,14 @@
5454
"uipath-agents", "uipath-functions", "uipath-api-workflow", "uipath-coded-apps",
5555
"uipath-connector-builder", "uipath-ixp", "uipath-process-mining", "uipath-mcp-servers",
5656
"uipath-solution", "uipath-human-in-the-loop", "uipath-rules",
57+
"uipath-ontology-modeler",
5758
}
5859
OPERATE_SKILLS = { # allowed in Platform Dependencies / Deployment, never in Build With or Components
5960
"uipath-platform", "uipath-tasks", "uipath-test", "uipath-admin", "uipath-insights",
6061
"uipath-troubleshoot", "uipath-governance", "uipath-review", "uipath-planner", "uipath-aops",
6162
"uipath-automationhub", "uipath-feedback",
6263
"uipath-activity-migrator", "uipath-knowledge-bundles", "uipath-vertical-solutions",
64+
"uipath-ontology-authoring",
6365
}
6466
RETIRED_SKILLS = {"uipath-rpa-workflows", "uipath-coded-workflows", "uipath-coded-agents"}
6567

0 commit comments

Comments
 (0)