InvokeAgentScope class

Paket:

@microsoft/agents-a365-observability

Tillhandahåller OpenTelemetry-spårningsomfång för AI-agentanropsåtgärder.

Extends

OpenTelemetryScope

Metoder

recordInputMessages(InputMessagesParam)	Registrerar indatameddelanden för telemetrispårning. Accepterar en enskild sträng, en matris med strängar (automatiskt omsluten som OTEL ChatMessage med roll user) eller en version av InputMessages-omslutning.
recordOutputMessages(OutputMessagesParam)	Registrerar utdatameddelanden för telemetrispårning. Accepterar en enskild sträng, en matris med strängar (automatiskt omsluten som OTEL OutputMessage med roll assistant) eller en version av OutputMessages-omslutning.
recordResponse(string)	Registrerar svarsinformation för telemetrispårning.
start(Request, InvokeAgentScopeDetails, AgentDetails, CallerDetails, SpanDetails)	Skapar och startar ett nytt omfång för agentanropsspårning.

Ärvda metoder

dispose()	Äldre bortskaffningsmetod för kompatibilitet
getSpanContext()	Hämtar span-kontexten för det här omfånget. Detta kan användas för att skapa en ParentSpanRef för explicit överordnad-underordnad länkning över asynkrona gränser.
recordAttributes(undefined | null | Iterable<[string, AttributeValue]> | Record<string, AttributeValue>)	Registrerar flera attributnyckel/värdepar för telemetrispårning.
recordCancellation(string)	Registrerar en annulleringshändelse i intervallet. Anger span-statusen till FEL med avbokningsorsaken och markerar feltypen som "TaskCanceledException".
recordError(Error)	Registrerar ett fel som inträffade under åtgärden
setEndTime(TimeInput)	Anger en anpassad sluttid för omfånget. När värdet har angetts skickas det här värdet till span.end() i stället för den aktuella tidsåtgången för väggklockan. Detta är användbart när den faktiska sluttiden för åtgärden är känd innan omfånget tas bort.
withActiveSpanAsync<T>(() => Promise<T>)	Gör det här intervallet aktivt under hela körningen av asynkron återanrop

Metodinformation

recordInputMessages(InputMessagesParam)

Registrerar indatameddelanden för telemetrispårning. Accepterar en enskild sträng, en matris med strängar (automatiskt omsluten som OTEL ChatMessage med roll user) eller en version av InputMessages-omslutning.

function recordInputMessages(messages: InputMessagesParam)

Parametrar

messages

InputMessagesParam

En sträng, matris med strängar eller en InputMessages-omslutning

recordOutputMessages(OutputMessagesParam)

Registrerar utdatameddelanden för telemetrispårning. Accepterar en enskild sträng, en matris med strängar (automatiskt omsluten som OTEL OutputMessage med roll assistant) eller en version av OutputMessages-omslutning.

function recordOutputMessages(messages: OutputMessagesParam)

Parametrar

messages

OutputMessagesParam

En sträng, matris med strängar eller en OutputMessages-omslutning

recordResponse(string)

Registrerar svarsinformation för telemetrispårning.

function recordResponse(response: string)

Parametrar

response

string

Anropssvaret

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

Skapar och startar ett nytt omfång för agentanropsspårning.

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

Parametrar

request

Request

Begär nyttolast (kanal, conversationId, innehåll, sessionId).

invokeScopeDetails

InvokeAgentScopeDetails

Information på omfångsnivå

agentDetails

AgentDetails

Agentidentiteten. Klientorganisations-ID härleds från agentDetails.tenantId (krävs).

callerDetails

CallerDetails

Valfri uppringarinformation. Har stöd för tre scenarier:

• Endast mänsklig uppringare: { userDetails: { userId, userName, ... } }
• Endast agentuppringare: { callerAgentDetails: { agentId, agentName, ... } }
• Båda (A2A med människa i kedja): { userDetails: { ... }, callerAgentDetails: { ... } }

spanDetails

SpanDetails

Valfri span-konfiguration (parentContext, startTime, endTime, spanKind, spanLinks).

Returer

InvokeAgentScope

En ny InvokeAgentScope-instans.

Ärvd metodinformation

dispose()

Äldre bortskaffningsmetod för kompatibilitet

function dispose()

Ärvd frånOpenTelemetryScope.dispose

getSpanContext()

Hämtar span-kontexten för det här omfånget. Detta kan användas för att skapa en ParentSpanRef för explicit överordnad-underordnad länkning över asynkrona gränser.

function getSpanContext(): SpanContext

Returer

SpanContext

SpanContext som innehåller traceId och spanId

Ärvd frånOpenTelemetryScope.getSpanContext

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

Registrerar flera attributnyckel/värdepar för telemetrispårning.

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

Parametrar

attributes

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

Samling attributnyckel/värdepar (matris eller itererbar för [nyckel, värde] eller objektkarta).

Ärvd frånOpenTelemetryScope.recordAttributes

recordCancellation(string)

Registrerar en annulleringshändelse i intervallet. Anger span-statusen till FEL med avbokningsorsaken och markerar feltypen som "TaskCanceledException".

function recordCancellation(reason?: string)

Parametrar

reason

string

Valfri avbokningsorsak. Standardvärdet är "Aktiviteten avbröts".

Ärvd frånOpenTelemetryScope.recordCancellation

recordError(Error)

Registrerar ett fel som inträffade under åtgärden

function recordError(error: Error)

Parametrar

error

Error

Felet som uppstod

Ärvd frånOpenTelemetryScope.recordError

setEndTime(TimeInput)

Anger en anpassad sluttid för omfånget. När värdet har angetts skickas det här värdet till span.end() i stället för den aktuella tidsåtgången för väggklockan. Detta är användbart när den faktiska sluttiden för åtgärden är känd innan omfånget tas bort.

function setEndTime(endTime: TimeInput)

Parametrar

endTime

TimeInput

Sluttiden som millisekunder sedan epoken, ett datum eller en HrTime-tupplar.

Ärvd frånOpenTelemetryScope.setEndTime

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

Gör det här intervallet aktivt under hela körningen av asynkron återanrop

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

Parametrar

callback

() => Promise<T>

Returer

Promise<T>

Ärvd frånOpenTelemetryScope.withActiveSpanAsync