feat(tracing): derive LLM Ops URL source param from span Source field

Previously the source query parameter in the LLM Ops API URL was
hardcoded to "Robots". Now it reads the Source field from the span
data (set via uipath.source attribute) and maps it to the correct
SourceEnum string name, defaulting to "Robots" if missing.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

Author: saksharthakkar

packages/uipath-platform/src/uipath/platform/common/_span_utils.py

@@ -18,6 +18,17 @@
 # SourceEnum.Robots = 4 (default for Python SDK / coded agents)
 DEFAULT_SOURCE = 4
 
+SOURCE_NAMES: dict[int, str] = {
+    0: "Testing",
+    1: "Agents",
+    2: "ProcessOrchestration",
+    3: "ApiWorkflows",
+    4: "Robots",
+    5: "ConversationalAgentsService",
+    6: "IntegrationServiceTrigger",
+    7: "Playground",
+}
+
 
 class AttachmentProvider(IntEnum):
     ORCHESTRATOR = 0

packages/uipath/src/uipath/tracing/_otel_exporters.py

@@ -13,6 +13,7 @@
 
 from uipath._utils._ssl_context import get_httpx_client_kwargs
 from uipath.platform.common import _SpanUtils
+from uipath.platform.common._span_utils import DEFAULT_SOURCE, SOURCE_NAMES
 from uipath.platform.common.retry import NON_RETRYABLE_STATUS_CODES
 
 logger = logging.getLogger(__name__)
@@ -389,7 +390,11 @@ def _process_span_attributes(self, span_data: Dict[str, Any]) -> None:
     def _build_url(self, span_list: list[Dict[str, Any]]) -> str:
         """Construct the URL for the API request."""
         trace_id = str(span_list[0]["TraceId"])
-        return f"{self.base_url}/api/Traces/spans?traceId={trace_id}&source=Robots"
+        source_int = span_list[0].get("Source", DEFAULT_SOURCE)
+        source_name = SOURCE_NAMES.get(source_int, "Robots")
+        return (
+            f"{self.base_url}/api/Traces/spans?traceId={trace_id}&source={source_name}"
+        )
 
     def _send_with_retries(
         self, url: str, payload: list[Dict[str, Any]], max_retries: int = 4

packages/uipath/tests/tracing/test_otel_exporters.py

@@ -216,6 +216,51 @@ def test_get_base_url():
             assert exporter.base_url == "https://custom-trace.example.com/prefix"
 
 
+def test_build_url_uses_span_source():
+    """Test _build_url derives source query param from span's Source field."""
+    with (
+        patch("uipath.tracing._otel_exporters.httpx.Client"),
+        patch.dict(os.environ, {"UIPATH_ACCESS_TOKEN": "t"}, clear=True),
+    ):
+        exporter = LlmOpsHttpExporter()
+        exporter.base_url = "https://example.com/llmops"
+
+        # Source=1 (Agents)
+        url = exporter._build_url([{"TraceId": "abc", "Source": 1}])
+        assert (
+            url
+            == "https://example.com/llmops/api/Traces/spans?traceId=abc&source=Agents"
+        )
+
+        # Source=4 (Robots) - default
+        url = exporter._build_url([{"TraceId": "abc", "Source": 4}])
+        assert (
+            url
+            == "https://example.com/llmops/api/Traces/spans?traceId=abc&source=Robots"
+        )
+
+        # Missing Source defaults to Robots
+        url = exporter._build_url([{"TraceId": "abc"}])
+        assert (
+            url
+            == "https://example.com/llmops/api/Traces/spans?traceId=abc&source=Robots"
+        )
+
+        # Source=7 (Playground)
+        url = exporter._build_url([{"TraceId": "abc", "Source": 7}])
+        assert (
+            url
+            == "https://example.com/llmops/api/Traces/spans?traceId=abc&source=Playground"
+        )
+
+        # Unknown source int falls back to Robots
+        url = exporter._build_url([{"TraceId": "abc", "Source": 99}])
+        assert (
+            url
+            == "https://example.com/llmops/api/Traces/spans?traceId=abc&source=Robots"
+        )
+
+
 def test_internal_headers_set_when_trace_base_url_present():
     """Test that internal tenant/account headers are set when UIPATH_TRACE_BASE_URL is configured."""
     with patch.dict(