InvokeAgentScope class

Package:

@microsoft/opentelemetry

Provides OpenTelemetry tracing scope for AI agent invocation operations.

Extends

OpenTelemetryScope

Methods

recordInputMessages(InputMessagesParam)	Records the input messages for telemetry tracking.
recordOutputMessages(OutputMessagesParam)	Records the output messages for telemetry tracking.
recordResponse(string)	Records response information for telemetry tracking.
start(Request, InvokeAgentScopeDetails, AgentDetails, CallerDetails, SpanDetails)	Creates and starts a new scope for agent invocation tracing.

Inherited Methods

dispose()	Legacy dispose method for compatibility.
getSpanContext()	Gets the span context for this scope.
recordAttributes(undefined | null | Iterable<[string, AttributeValue]> | Record<string, AttributeValue>)	Records multiple attribute key/value pairs.
recordCancellation(string)	Records a cancellation event on the span.
recordError(Error)	Records an error that occurred during the operation.
setEndTime(TimeInput)	Sets a custom end time for the scope. When set, dispose() will pass this value to span.end() instead of using wall-clock time.
withActiveSpanAsync<T>(() => Promise<T>)	Makes this span active for the duration of the async callback execution.

Method Details

recordInputMessages(InputMessagesParam)

Records the input messages for telemetry tracking.

function recordInputMessages(messages: InputMessagesParam)

Parameters

messages

InputMessagesParam

recordOutputMessages(OutputMessagesParam)

Records the output messages for telemetry tracking.

function recordOutputMessages(messages: OutputMessagesParam)

Parameters

messages

OutputMessagesParam

recordResponse(string)

Records response information for telemetry tracking.

function recordResponse(response: string)

Parameters

response

string

start(Request, InvokeAgentScopeDetails, AgentDetails, CallerDetails, SpanDetails)

Creates and starts a new scope for agent invocation tracing.

static function start(request: Request, invokeScopeDetails: InvokeAgentScopeDetails, agentDetails: AgentDetails, callerDetails?: CallerDetails, spanDetails?: SpanDetails): InvokeAgentScope

Parameters

request

A365Request

Request payload (channel, conversationId, content, sessionId).

invokeScopeDetails

InvokeAgentScopeDetails

Scope-level details (endpoint).

agentDetails

AgentDetails

The agent identity. tenantId is required.

callerDetails

CallerDetails

Optional caller information (human, agent, or both for A2A).

spanDetails

A365SpanDetails

Optional span configuration.

Returns

InvokeAgentScope

Inherited Method Details

dispose()

Legacy dispose method for compatibility.

function dispose()

Inherited From OpenTelemetryScope.dispose

getSpanContext()

Gets the span context for this scope.

function getSpanContext(): SpanContext

Returns

SpanContext

Inherited From OpenTelemetryScope.getSpanContext

recordAttributes(undefined | null | Iterable<[string, AttributeValue]> | Record<string, AttributeValue>)

Records multiple attribute key/value pairs.

function recordAttributes(attributes: undefined | null | Iterable<[string, AttributeValue]> | Record<string, AttributeValue>)

Parameters

attributes

undefined | null | Iterable<[string, AttributeValue]> | Record<string, AttributeValue>

Inherited From OpenTelemetryScope.recordAttributes

recordCancellation(string)

Records a cancellation event on the span.

function recordCancellation(reason?: string)

Parameters

reason

string

Inherited From OpenTelemetryScope.recordCancellation

recordError(Error)

Records an error that occurred during the operation.

function recordError(error: Error)

Parameters

error

Error

Inherited From OpenTelemetryScope.recordError

setEndTime(TimeInput)

Sets a custom end time for the scope. When set, dispose() will pass this value to span.end() instead of using wall-clock time.

function setEndTime(endTime: TimeInput)

Parameters

endTime

TimeInput

Inherited From OpenTelemetryScope.setEndTime

withActiveSpanAsync<T>(() => Promise<T>)

Makes this span active for the duration of the async callback execution.

function withActiveSpanAsync<T>(callback: () => Promise<T>): Promise<T>

Parameters

callback

() => Promise<T>

Returns

Promise<T>

Inherited From OpenTelemetryScope.withActiveSpanAsync