add agent version

Author: nikhilc-microsoft

src/Observability/Runtime/Common/BaggageBuilder.cs

@@ -107,6 +107,15 @@ public BaggageBuilder AgentDescription(string? v)
             return this;
         }
 
+        /// <summary>
+        /// Sets the agent version baggage value.
+        /// </summary>
+        public BaggageBuilder AgentVersion(string? v)
+        {
+            Set(OpenTelemetryConstants.GenAiAgentVersionKey, v);
+            return this;
+        }
+
         /// <summary>
         /// Sets the agentic user ID baggage value.
         /// </summary>

src/Observability/Runtime/Tracing/Contracts/AgentDetails.cs

@@ -25,6 +25,7 @@ public class AgentDetails : IEquatable<AgentDetails>
         /// <param name="agentClientIP">Optional client IP address of the agent.</param>
         /// <param name="agentPlatformId">Optional platform ID for the agent.</param>
         /// <param name="providerName">Optional provider name (e.g., openai, anthropic).</param>
+        /// <param name="agentVersion">Optional version of the agent (e.g., "1.0.0", "2025-05-01").</param>
         /// <remarks>
         /// <para>
         /// <b>Certification Requirements:</b> The following parameters must be set for the agent to pass certification requirements, and these values override any of the same values specified in the <see cref="Microsoft.Agents.A365.Observability.Runtime.Common.BaggageBuilder"/> class:
@@ -55,7 +56,8 @@ public AgentDetails(
             AgentType? agentType = null,
             IPAddress? agentClientIP = null,
             string? agentPlatformId = null,
-            string? providerName = null)
+            string? providerName = null,
+            string? agentVersion = null)
         {
             AgentId = agentId;
             AgentName = agentName;
@@ -68,6 +70,7 @@ public AgentDetails(
             AgentClientIP = agentClientIP;
             AgentPlatformId = agentPlatformId;
             ProviderName = providerName;
+            AgentVersion = agentVersion;
         }
 
         /// <summary>
@@ -125,6 +128,11 @@ public AgentDetails(
         /// </summary>
         public string? ProviderName { get; }
 
+        /// <summary>
+        /// Optional version of the agent (e.g., "1.0.0", "2025-05-01").
+        /// </summary>
+        public string? AgentVersion { get; }
+
         /// <summary>
         /// Deconstructs the current instance into discrete values.
         /// </summary>
@@ -138,6 +146,7 @@ public AgentDetails(
         /// <param name="tenantId">Receives the tenant identifier.</param>
         /// <param name="agentClientIP">Receives the client IP address.</param>
         /// <param name="agentPlatformId">Receives the platform ID.</param>
+        /// <param name="agentVersion">Receives the agent version.</param>
         public void Deconstruct(
             out string? agentId,
             out string? agentName,
@@ -148,7 +157,8 @@ public void Deconstruct(
             out AgentType? agentType,
             out string? tenantId,
             out IPAddress? agentClientIP,
-            out string? agentPlatformId)
+            out string? agentPlatformId,
+            out string? agentVersion)
         {
             agentId = AgentId;
             agentName = AgentName;
@@ -160,6 +170,7 @@ public void Deconstruct(
             tenantId = TenantId;
             agentClientIP = AgentClientIP;
             agentPlatformId = AgentPlatformId;
+            agentVersion = AgentVersion;
         }
 
         /// <inheritdoc/>
@@ -179,7 +190,8 @@ public bool Equals(AgentDetails? other)
                    AgentType == other.AgentType &&
                    string.Equals(TenantId, other.TenantId, StringComparison.Ordinal) &&
                    Equals(AgentClientIP, other.AgentClientIP) &&
-                   string.Equals(AgentPlatformId, other.AgentPlatformId, StringComparison.Ordinal);
+                   string.Equals(AgentPlatformId, other.AgentPlatformId, StringComparison.Ordinal) &&
+                   string.Equals(AgentVersion, other.AgentVersion, StringComparison.Ordinal);
         }
 
         /// <inheritdoc/>
@@ -204,6 +216,7 @@ public override int GetHashCode()
                 hash = (hash * 31) + (TenantId != null ? StringComparer.Ordinal.GetHashCode(TenantId) : 0);
                 hash = (hash * 31) + (AgentClientIP?.GetHashCode() ?? 0);
                 hash = (hash * 31) + (AgentPlatformId != null ? StringComparer.Ordinal.GetHashCode(AgentPlatformId) : 0);
+                hash = (hash * 31) + (AgentVersion != null ? StringComparer.Ordinal.GetHashCode(AgentVersion) : 0);
                 return hash;
             }
         }

src/Observability/Runtime/Tracing/Processors/ActivityProcessor.cs

@@ -17,6 +17,7 @@ public sealed class ActivityProcessor : BaseProcessor<Activity>
             OpenTelemetryConstants.GenAiAgentIdKey,
             OpenTelemetryConstants.GenAiAgentNameKey,
             OpenTelemetryConstants.GenAiAgentDescriptionKey,
+            OpenTelemetryConstants.GenAiAgentVersionKey,
             OpenTelemetryConstants.AgentEmailKey,
             OpenTelemetryConstants.AgentBlueprintIdKey,
             OpenTelemetryConstants.AgentAUIDKey,

src/Observability/Runtime/Tracing/Scopes/InvokeAgentScope.cs

@@ -107,6 +107,7 @@ private InvokeAgentScope(
                     SetTagMaybe(OpenTelemetryConstants.CallerAgentAUIDKey, callerAgentDetails.AgenticUserId);
                     SetTagMaybe(OpenTelemetryConstants.CallerAgentEmailKey, callerAgentDetails.AgenticUserEmail);
                     SetTagMaybe(OpenTelemetryConstants.CallerAgentPlatformIdKey, callerAgentDetails.AgentPlatformId);
+                    SetTagMaybe(OpenTelemetryConstants.CallerAgentVersionKey, callerAgentDetails.AgentVersion);
                 }
             }
         }

src/Observability/Runtime/Tracing/Scopes/OpenTelemetryConstants.cs

@@ -60,6 +60,7 @@ public enum OperationNames
         public const string GenAiAgentIdKey = "gen_ai.agent.id";
         public const string GenAiAgentNameKey = "gen_ai.agent.name";
         public const string GenAiAgentDescriptionKey = "gen_ai.agent.description";
+        public const string GenAiAgentVersionKey = "gen_ai.agent.version";
         public const string AgentAUIDKey = "microsoft.agent.user.id";
         public const string AgentEmailKey = "microsoft.agent.user.email";
         public const string AgentBlueprintIdKey = "microsoft.a365.agent.blueprint.id";
@@ -78,6 +79,7 @@ public enum OperationNames
         public const string CallerAgentAUIDKey = "microsoft.a365.caller.agent.user.id";
         public const string CallerAgentEmailKey = "microsoft.a365.caller.agent.user.email";
         public const string CallerAgentPlatformIdKey = "microsoft.a365.caller.agent.platform.id";
+        public const string CallerAgentVersionKey = "microsoft.a365.caller.agent.version";
 
         // Service attributes
         public const string ServiceNameKey = "service.name";

src/Observability/Runtime/Tracing/Scopes/OpenTelemetryScope.cs

@@ -77,6 +77,7 @@ protected OpenTelemetryScope(string operationName, string activityName, AgentDet
                 SetTagMaybe(GenAiAgentIdKey, agentDetails.AgentId);
                 SetTagMaybe(GenAiAgentNameKey, agentDetails.AgentName);
                 SetTagMaybe(GenAiAgentDescriptionKey, agentDetails.AgentDescription);
+                SetTagMaybe(GenAiAgentVersionKey, agentDetails.AgentVersion);
                 SetTagMaybe(AgentAUIDKey, agentDetails.AgenticUserId);
                 SetTagMaybe(AgentEmailKey, agentDetails.AgenticUserEmail);
                 SetTagMaybe(AgentBlueprintIdKey, agentDetails.AgentBlueprintId);