Merge branch 'main' into dependabot/uv/requests-2.33.0

Author: biswapm

.github/workflows/ci.yml

@@ -85,6 +85,8 @@ jobs:
     defaults:
       run:
         working-directory: ./
+    env:
+      PYTHONPATH: ${{ github.workspace }}/versioning/helper
 
     strategy:
       matrix:

libraries/microsoft-agents-a365-notifications/pyproject.toml

@@ -1,7 +1,6 @@
 [build-system]
 requires = ["setuptools>=68", "wheel", "tzdata", "tomlkit", "packaging"]
 build-backend = "build_backend"
-backend-path = ["../../versioning/helper"]
 
 [project]
 name = "microsoft-agents-a365-notifications"

libraries/microsoft-agents-a365-observability-core/CHANGELOG.md

@@ -2,7 +2,45 @@
 
 All notable changes to this package will be documented in this file.
 
-## [Unreleased]
+## [0.3.0]
+
+### Breaking Changes
+
+- **New permission required: `Agent365.Observability.OtelWrite`** — The observability exporter now requires this scope as both a delegated and application permission on your agent blueprint. See [Upgrade Instructions](#upgrade-instructions-observability-permission-for-existing-agents) below.
+
+---
+
+### Upgrade Instructions: Observability Permission for Existing Agents
+
+Existing agent blueprints need `Agent365.Observability.OtelWrite` granted as both a **delegated permission** and an **application permission**. Choose either option below.
+
+#### Option A — Agent 365 CLI (requires both config files)
+
+Requires `a365.config.json` and `a365.generated.config.json` in your config directory, a Global Administrator account, and [Agent 365 CLI v1.1.139-preview](https://www.nuget.org/packages/Microsoft.Agents.A365.DevTools.Cli/1.1.139-preview) or later.
+
+```
+a365 setup admin --config-dir "<path-to-config-dir>"
+```
+
+This grants all missing permissions including the new Observability scopes.
+
+#### Option B — Entra Portal (no config files required)
+
+Requires Global Administrator access to the blueprint app registration.
+
+1. Go to **Entra portal** > **App registrations** > select your Blueprint app
+2. Go to **API permissions** > **Add a permission** > **APIs my organization uses** > search for `9b975845-388f-4429-889e-eab1ef63949c`
+3. Select **Delegated permissions** > check `Agent365.Observability.OtelWrite` > **Add permissions**
+4. Repeat step 2–3, this time select **Application permissions** > check `Agent365.Observability.OtelWrite` > **Add permissions**
+5. Click **Grant admin consent** and confirm
+
+Both `Agent365.Observability.OtelWrite` (Delegated) and `Agent365.Observability.OtelWrite` (Application) should show **Granted** status.
+
+> **Note:** If your agent is autonomous, you only need the **Application permission**. The delegated permission is required for agents that authenticate via a user session.
+
+---
+
+## [0.2.1.dev46]
 
 ### Breaking Changes
 

libraries/microsoft-agents-a365-observability-core/microsoft_agents_a365/observability/core/exporters/agent365_exporter.py

@@ -46,7 +46,8 @@ class _Agent365Exporter(SpanExporter):
     Agent 365 span exporter for Agent 365:
       * Partitions spans by (tenantId, agentId)
       * Builds OTLP-like JSON: resourceSpans -> scopeSpans -> spans
-      * POSTs per group to https://{endpoint}/maven/agent365/agents/{agentId}/traces?api-version=1
+      * POSTs per group to https://{endpoint}/observability/tenants/{tenantId}/otlp/agents/{agentId}/traces?api-version=1
+      *   or, when use_s2s_endpoint is True, https://{endpoint}/observabilityService/tenants/{tenantId}/otlp/agents/{agentId}/traces?api-version=1
       * Adds Bearer token via token_resolver(agentId, tenantId)
     """
 

libraries/microsoft-agents-a365-observability-core/microsoft_agents_a365/observability/core/exporters/utils.py

@@ -221,9 +221,9 @@ def build_export_url(
         The fully constructed export URL with path and query parameters.
     """
     endpoint_path = (
-        f"/observabilityService/tenants/{tenant_id}/agents/{agent_id}/traces"
+        f"/observabilityService/tenants/{tenant_id}/otlp/agents/{agent_id}/traces"
         if use_s2s_endpoint
-        else f"/observability/tenants/{tenant_id}/agents/{agent_id}/traces"
+        else f"/observability/tenants/{tenant_id}/otlp/agents/{agent_id}/traces"
     )
 
     parsed = urlparse(endpoint)

libraries/microsoft-agents-a365-observability-core/pyproject.toml

@@ -1,7 +1,6 @@
 [build-system]
 requires = ["setuptools>=68", "wheel", "tzdata", "tomlkit", "packaging"]
 build-backend = "build_backend"
-backend-path = ["../../versioning/helper"]
 
 [project]
 name = "microsoft-agents-a365-observability-core"

libraries/microsoft-agents-a365-observability-extensions-agentframework/pyproject.toml

@@ -1,7 +1,6 @@
 [build-system]
 requires = ["setuptools>=68", "wheel", "tzdata", "tomlkit", "packaging"]
 build-backend = "build_backend"
-backend-path = ["../../versioning/helper"]
 
 [project]
 name = "microsoft-agents-a365-observability-extensions-agent-framework"

libraries/microsoft-agents-a365-observability-extensions-langchain/pyproject.toml

@@ -1,7 +1,6 @@
 [build-system]
 requires = ["setuptools>=68", "wheel", "tzdata", "tomlkit", "packaging"]
 build-backend = "build_backend"
-backend-path = ["../../versioning/helper"]
 
 [project]
 name = "microsoft-agents-a365-observability-extensions-langchain"

libraries/microsoft-agents-a365-observability-extensions-openai/pyproject.toml

@@ -1,7 +1,6 @@
 [build-system]
 requires = ["setuptools>=68", "wheel", "tzdata", "tomlkit", "packaging"]
 build-backend = "build_backend"
-backend-path = ["../../versioning/helper"]
 
 [project]
 name = "microsoft-agents-a365-observability-extensions-openai"

libraries/microsoft-agents-a365-observability-extensions-semantickernel/pyproject.toml

@@ -1,7 +1,6 @@
 [build-system]
 requires = ["setuptools>=68", "wheel", "tzdata", "tomlkit", "packaging"]
 build-backend = "build_backend"
-backend-path = ["../../versioning/helper"]
 
 [project]
 name = "microsoft-agents-a365-observability-extensions-semantic-kernel"