feat(agent): add ontology binding to Data Fabric context config by sankalp-uipath · Pull Request #1728 · UiPath/uipath-python

sankalp-uipath · 2026-06-17T09:22:00Z

What

Adds Data Fabric ontology binding to the agent context model: a context can carry one or more ontologies that the runtime fetches to ground Text2SQL.

agent/models/agent.py — AgentContextResourceConfig.ontology_set (alias ontologySet), a list of DataFabricOntologyItem nested in the context alongside entitySet.
platform/entities/_entity_ontology_service.py — DataFabricOntologyItem ({name, folderId, description?}) + EntityOntologyService, which fetches one ontology file: GET datafabric_/api/ontologies/{name}/files/{type} on the authenticated, folder-scoped client.
platform/entities/_entities_service.py — get_ontology_file_async(ontology_name, file_type="owl", folder_key=None) is a thin public wrapper delegating to EntityOntologyService (all ontology logic lives in the ontology sub-service). One file per call; the langchain consumer fetches owl and r2rml as separate calls.

Why

An ontology is part of a Data Fabric context — domain knowledge over the same entities — so it is configured inline on the context (a sibling of entitySet), mirroring how entities are bound. Each ontology carries its own folderId so it can live in a different folder from the entities.

Notes

Additive + backward compatible: ontology_set defaults to None.
No referenceKey on ontology items: ontologies are not solution-aware at this point, so there is no solution key to reference. The field is dropped from DataFabricOntologyItem — it was never populated or read (ontologies resolve by name + folderId). Backward compatible: configs that still send referenceKey are tolerated via extra="allow".
Validation is server-side: file-type/name validation lives in the ontology API (QE), not the client — the SDK forwards the request and surfaces the API's rejection (e.g. an unsupported file type) as EnrichedException (status code + response body + extracted message) rather than swallowing it. Redundant client-side allowlists were removed per review.
Tests: nested ontologySet parse/dump, required folderId per item, backward-compat default, full-AgentDefinition normalization; get_ontology_file_async covered for spec, folder header, allowed file types, and the negative case (API rejection of an unsupported file type surfaces as EnrichedException).
Consumed by uipath-langchain PR feat: add integration service invocation support #911.
Release: uipath → 2.12.5, uipath-platform → 0.1.91, pin uipath-platform>=0.1.91; latest main merged in and lockfiles relocked. Do not merge a .dev pin.

Development Packages

uipath

[project]
dependencies = [
  # Exact version (copy-paste ready):
  "uipath==2.12.6.dev1017287114",

  # Any version from this PR (uncomment to use a range instead):
  # "uipath>=2.12.6.dev1017280000,<2.12.6.dev1017290000",
]

[[tool.uv.index]]
name = "testpypi"
url = "https://test.pypi.org/simple/"
publish-url = "https://test.pypi.org/legacy/"
explicit = true

[tool.uv.sources]
uipath = { index = "testpypi" }
uipath-platform = { index = "testpypi" }

[tool.uv]
override-dependencies = ["uipath-platform==0.1.91.dev1017287114"]

uipath-platform

[project]
dependencies = [
  # Exact version (copy-paste ready):
  "uipath-platform==0.1.91.dev1017287114",

  # Any version from this PR (uncomment to use a range instead):
  # "uipath-platform>=0.1.91.dev1017280000,<0.1.91.dev1017290000",
]

[[tool.uv.index]]
name = "testpypi"
url = "https://test.pypi.org/simple/"
publish-url = "https://test.pypi.org/legacy/"
explicit = true

[tool.uv.sources]
uipath-platform = { index = "testpypi" }

Dev builds (testpypi) are republished by CI on each push. Use the latest .dev pins from the most recent CI publish comment, at base versions uipath==2.12.5 / uipath-platform==0.1.91:

[[tool.uv.index]]
name = "testpypi"
url = "https://test.pypi.org/simple/"
publish-url = "https://test.pypi.org/legacy/"
explicit = true

[tool.uv.sources]
uipath = { index = "testpypi" }
uipath-platform = { index = "testpypi" }

…ic service

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

…-ontology-binding # Conflicts: # packages/uipath-platform/src/uipath/platform/entities/_entities_service.py

…older_key_headers

…verage

Copilot

Pull request overview

Copilot reviewed 4 out of 4 changed files in this pull request and generated 2 comments.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

github-actions · 2026-06-23T06:34:39Z

🚨 Heads up: `uipath-integrations` cross-tests are FAILING 🚨

Your changes may break one or more integrations in uipath-integrations-python:

uipath-openai-agents
uipath-google-adk
uipath-agent-framework
uipath-llamaindex
uipath-pydantic-ai

⚠️ These checks are NOT enforced by branch protection rules. Please review the failures before merging.

🔍 Inspect the failed run →

…-ontology-binding # Conflicts: # packages/uipath-platform/pyproject.toml # packages/uipath-platform/uv.lock # packages/uipath/pyproject.toml # packages/uipath/uv.lock

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

Copilot

Pull request overview

Copilot reviewed 6 out of 8 changed files in this pull request and generated no new comments.

… platform 0.1.78)

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

…0.1.83 / uipath 2.11.17

…logy file type

UIPath-Harshit · 2026-07-02T08:55:32Z

+        super().__init__(config=config, execution_context=execution_context)
+        self._folders_service = folders_service
+
+    async def get_file_async(


Should be called get_onotology_bundle_async

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

…-ontology-binding # Conflicts: # packages/uipath-platform/pyproject.toml # packages/uipath-platform/uv.lock # packages/uipath/pyproject.toml # packages/uipath/uv.lock

github-actions · 2026-07-02T21:57:13Z

🚨 Heads up: `uipath-langchain` cross-tests are FAILING 🚨

Your changes may break the uipath-langchain-python integration.

⚠️ These checks are NOT enforced by branch protection rules. Please review the failures before merging.

🔍 Inspect the failed run →

…dle_async" This reverts commit 3a15ed4.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

sonarqubecloud · 2026-07-03T07:25:02Z

Quality Gate passed

Issues
0 New issues
0 Accepted issues

Measures
0 Security Hotspots
100.0% Coverage on New Code
0.0% Duplication on New Code

See analysis details on SonarQube Cloud

feat(agent): add ontology binding to Data Fabric context config

8badd70

Copilot AI review requested due to automatic review settings June 17, 2026 09:22

github-actions Bot added test:uipath-langchain Triggers tests in the uipath-langchain-python repository test:uipath-integrations labels Jun 17, 2026

Copilot started reviewing on behalf of sankalp-uipath June 17, 2026 09:22 View session

This comment was marked as outdated.

Sign in to view

milind-jain-uipath reviewed Jun 17, 2026

View reviewed changes

Comment thread packages/uipath/src/uipath/agent/models/agent.py Outdated

milind-jain-uipath requested changes Jun 17, 2026

View reviewed changes

sankalp-uipath and others added 4 commits June 17, 2026 15:22

feat(entities): add ontology binding + get_ontology_file to Data Fabr…

906d618

…ic service

feat(agent): allow multiple ontologies per context (ontologySet)

cd4ff88

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

Merge remote-tracking branch 'origin/main' into feat/agent-datafabric…

8175316

…-ontology-binding # Conflicts: # packages/uipath-platform/src/uipath/platform/entities/_entities_service.py

fix(entities): scope ontology fetch via header_folder, not missing _f…

2048c56

…older_key_headers

sankalp-uipath requested a review from Copilot June 22, 2026 08:13

Copilot started reviewing on behalf of sankalp-uipath June 22, 2026 08:13 View session

This comment was marked as outdated.

Sign in to view

sankalp-uipath added 2 commits June 22, 2026 18:05

feat(entities): validate ontology file_type; require folderId; add co…

28d3c0c

…verage

Merge branch 'main' into feat/agent-datafabric-ontology-binding

33f76f0

sankalp-uipath added the build:dev Create a dev build from the pr label Jun 22, 2026

sankalp-uipath requested a review from Copilot June 22, 2026 20:15

Copilot started reviewing on behalf of sankalp-uipath June 22, 2026 20:16 View session

Copilot AI reviewed Jun 22, 2026

View reviewed changes

Comment thread packages/uipath-platform/src/uipath/platform/entities/_entities_service.py

Comment thread packages/uipath-platform/src/uipath/platform/entities/_entities_service.py

sankalp-uipath and others added 4 commits June 23, 2026 02:45

chore: bump uipath to 2.11.8 and uipath-platform to 0.1.72

d4ccd79

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

docs(entities): mark get_ontology_file_async as Preview Feature

f22074c

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

Merge branch 'main' into feat/agent-datafabric-ontology-binding

74d47bb

chore: bump uipath to 2.11.9 (main advanced to 2.11.8)

bcbf2dd

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

sankalp-uipath requested a review from milind-jain-uipath June 23, 2026 07:39

sankalp-uipath and others added 3 commits June 23, 2026 18:18

feat(agent): ontology as standalone resource (ontologyRefs)

75aaab5

Merge remote-tracking branch 'origin/main' into feat/agent-datafabric…

336bfb3

…-ontology-binding # Conflicts: # packages/uipath-platform/pyproject.toml # packages/uipath-platform/uv.lock # packages/uipath/pyproject.toml # packages/uipath/uv.lock

test: annotate parsed for mypy (var-annotated)

c231702

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

Copilot started reviewing on behalf of sankalp-uipath June 23, 2026 14:07 View session

Copilot AI reviewed Jun 23, 2026

View reviewed changes

sankalp-uipath added 4 commits June 24, 2026 12:21

Merge branch 'main' into feat/agent-datafabric-ontology-binding

2fe9114

chore: bump uipath to 2.11.11 (above main)

6877f6a

refactor(agent): nest ontology as ontologySet on context

69d42df

chore: merge main; bump uipath 2.11.13 / platform 0.1.77

1ce9049

sankalp-uipath force-pushed the feat/agent-datafabric-ontology-binding branch from 9ee4757 to 1ce9049 Compare June 25, 2026 08:30

sankalp-uipath added 3 commits June 25, 2026 14:46

Merge branch 'main' into feat/agent-datafabric-ontology-binding

9e22841

refactor(agent): model ontology as a datafabricontology context (bump…

b6f0c9a

… platform 0.1.78)

chore: merge main; bump uipath 2.11.14 / platform 0.1.79 (above main)

56ac4a4

UIPath-Harshit reviewed Jun 26, 2026

View reviewed changes

Merge branch 'main' into feat/agent-datafabric-ontology-binding

ee66ada

sankalp-uipath force-pushed the feat/agent-datafabric-ontology-binding branch 3 times, most recently from 9b6f320 to e98f5a1 Compare June 27, 2026 21:22

refactor(entities): extract ontology fetch into EntityOntologyService

54e45ef

sankalp-uipath force-pushed the feat/agent-datafabric-ontology-binding branch from e98f5a1 to 54e45ef Compare June 28, 2026 19:53

sankalp-uipath and others added 2 commits June 30, 2026 15:57

Merge branch 'main' into feat/agent-datafabric-ontology-binding

372b2ca

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

refactor(entities): drop unused ontology referenceKey; bump platform …

43e40b2

…0.1.83 / uipath 2.11.17

andreitava-uip reviewed Jun 30, 2026

View reviewed changes

Comment thread packages/uipath-platform/tests/services/test_entities_service.py

sankalp-uipath added 2 commits June 30, 2026 16:23

style: ruff-format ontologySet test fixture

2d28efb

test(entities): assert SDK surfaces API rejection of unsupported onto…

5b134ed

…logy file type

UIPath-Harshit reviewed Jul 2, 2026

View reviewed changes

sankalp-uipath and others added 2 commits July 3, 2026 03:09

refactor(platform): rename ontology fetch to get_ontology_bundle_async

3a15ed4

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

Merge remote-tracking branch 'origin/main' into feat/agent-datafabric…

8b58314

…-ontology-binding # Conflicts: # packages/uipath-platform/pyproject.toml # packages/uipath-platform/uv.lock # packages/uipath/pyproject.toml # packages/uipath/uv.lock

sankalp-uipath and others added 3 commits July 3, 2026 11:36

Revert "refactor(platform): rename ontology fetch to get_ontology_bun…

78757ee

…dle_async" This reverts commit 3a15ed4.

chore(uipath): bump version 2.12.5 -> 2.12.6 (2.12.5 already on PyPI)

1bce87e

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

Merge branch 'main' into feat/agent-datafabric-ontology-binding

12856fb

Uh oh!

Conversation

sankalp-uipath commented Jun 17, 2026 • edited by github-actions Bot Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

What

Why

Notes

Development Packages

uipath

uipath-platform

Uh oh!

This comment was marked as outdated.

Uh oh!

Uh oh!

This comment was marked as outdated.

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull request overview

Uh oh!

Uh oh!

Uh oh!

github-actions Bot commented Jun 23, 2026

🚨 Heads up: uipath-integrations cross-tests are FAILING 🚨

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull request overview

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

UIPath-Harshit Jul 2, 2026

Choose a reason for hiding this comment

Uh oh!

github-actions Bot commented Jul 2, 2026

🚨 Heads up: uipath-langchain cross-tests are FAILING 🚨

Uh oh!

sonarqubecloud Bot commented Jul 3, 2026

Quality Gate passed

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

5 participants

sankalp-uipath commented Jun 17, 2026 •

edited by github-actions Bot

Loading

🚨 Heads up: `uipath-integrations` cross-tests are FAILING 🚨

🚨 Heads up: `uipath-langchain` cross-tests are FAILING 🚨