Freigeben über

InvokeAgentScope class

Paket:
@microsoft/agents-a365-observability

Stellt den OpenTelemetry-Ablaufverfolgungsbereich für KI-Agent-Aufrufvorgänge bereit.

Extends
OpenTelemetryScope

Methoden

recordInputMessages(InputMessagesParam)

Zeichnet die Eingabemeldungen für die Telemetrienachverfolgung auf. Akzeptiert eine einzelne Zeichenfolge, ein Array von Zeichenfolgen (automatisch als OTEL ChatMessage mit Rolle userumbrochen), oder ein versionsgesteuertes InputMessages-Wrapper.
recordOutputMessages(OutputMessagesParam)

Zeichnet die Ausgabemeldungen für die Telemetrienachverfolgung auf. Akzeptiert eine einzelne Zeichenfolge, ein Array von Zeichenfolgen (automatisch als OTEL OutputMessage mit Rolle assistanteingeschlossen) oder einen versionsgesteuerten OutputMessages-Wrapper.
recordResponse(string)

Zeichnet Antwortinformationen für die Telemetrienachverfolgung auf.
start(Request, InvokeAgentScopeDetails, AgentDetails, CallerDetails, SpanDetails)

Erstellt und startet einen neuen Bereich für die Agent-Aufrufablaufverfolgung.

Geerbte Methoden

dispose()

Legacy-Dispose-Methode zur Kompatibilität
getSpanContext()

Ruft den Span-Kontext für diesen Bereich ab. Dies kann verwendet werden, um eine ParentSpanRef für explizite verknüpfung zwischen übergeordneten und untergeordneten Elementen über asynchrone Grenzen hinweg zu erstellen.
recordAttributes(undefined | null | Iterable<[string, AttributeValue]> | Record<string, AttributeValue>)

Zeichnet mehrere Attributschlüssel-Wert-Paare für die Telemetrienachverfolgung auf.
recordCancellation(string)

Zeichnet ein Abbruchereignis auf der Spanne auf. Legt den Span-Status auf ERROR mit dem Abbruchgrund fest und markiert den Fehlertyp als "TaskCanceledException".
recordError(Error)

Zeichnet einen Fehler auf, der während des Vorgangs aufgetreten ist.
setEndTime(TimeInput)

Legt eine benutzerdefinierte Endzeit für den Bereich fest. Wenn dieser Wert festgelegt ist, übergibt Dispose diesen Wert span.end() anstelle der aktuellen Zeit für die Wanduhr. Dies ist nützlich, wenn die tatsächliche Endzeit des Vorgangs bekannt ist, bevor der Bereich verworfen wird.
withActiveSpanAsync<T>(() => Promise<T>)

Macht diese Spanne für die Dauer der asynchronen Rückrufausführung aktiv

Details zur Methode

recordInputMessages(InputMessagesParam)

Zeichnet die Eingabemeldungen für die Telemetrienachverfolgung auf. Akzeptiert eine einzelne Zeichenfolge, ein Array von Zeichenfolgen (automatisch als OTEL ChatMessage mit Rolle userumbrochen), oder ein versionsgesteuertes InputMessages-Wrapper.

function recordInputMessages(messages: InputMessagesParam)

Parameter

messages
InputMessagesParam

Eine Zeichenfolge, ein Array von Zeichenfolgen oder ein InputMessages-Wrapper

recordOutputMessages(OutputMessagesParam)

Zeichnet die Ausgabemeldungen für die Telemetrienachverfolgung auf. Akzeptiert eine einzelne Zeichenfolge, ein Array von Zeichenfolgen (automatisch als OTEL OutputMessage mit Rolle assistanteingeschlossen) oder einen versionsgesteuerten OutputMessages-Wrapper.

function recordOutputMessages(messages: OutputMessagesParam)

Parameter

messages
OutputMessagesParam

Eine Zeichenfolge, ein Array von Zeichenfolgen oder ein OutputMessages-Wrapper

recordResponse(string)

Zeichnet Antwortinformationen für die Telemetrienachverfolgung auf.

function recordResponse(response: string)

Parameter

response

string

Die Aufrufantwort

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

Erstellt und startet einen neuen Bereich für die Agent-Aufrufablaufverfolgung.

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

Parameter

request
Request

Anforderungsnutzlast (Kanal, conversationId, Inhalt, sessionId).

invokeScopeDetails
InvokeAgentScopeDetails

Details auf Bereichsebene

agentDetails
AgentDetails

Die Agentidentität. Die Mandanten-ID wird von agentDetails.tenantId (erforderlich) abgeleitet.

callerDetails
CallerDetails

Optionale Anruferinformationen. Unterstützt drei Szenarien:

  • Nur Anrufer: { userDetails: { userId, userName, ... } }
  • Nur Agentanrufer: { callerAgentDetails: { agentId, agentName, ... } }
  • Beide (A2A mit Mensch in Kette): { userDetails: { ... }, callerAgentDetails: { ... } }
spanDetails
SpanDetails

Optionale Span-Konfiguration (parentContext, startTime, endTime, spanKind, spanLinks).

Gibt zurück

InvokeAgentScope

Eine neue InvokeAgentScope-Instanz.

Details zur geerbten Methode

dispose()

Legacy-Dispose-Methode zur Kompatibilität

function dispose()

Geerbt vonOpenTelemetryScope.dispose

getSpanContext()

Ruft den Span-Kontext für diesen Bereich ab. Dies kann verwendet werden, um eine ParentSpanRef für explizite verknüpfung zwischen übergeordneten und untergeordneten Elementen über asynchrone Grenzen hinweg zu erstellen.

function getSpanContext(): SpanContext

Gibt zurück

SpanContext

Der SpanContext mit traceId und spanId

Geerbt vonOpenTelemetryScope.getSpanContext

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

Zeichnet mehrere Attributschlüssel-Wert-Paare für die Telemetrienachverfolgung auf.

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

Parameter

attributes

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

Auflistung von Attributschlüssel-Wert-Paaren (Array oder iterierbar von [Schlüssel, Wert] oder Objektzuordnung).

Geerbt vonOpenTelemetryScope.recordAttributes

recordCancellation(string)

Zeichnet ein Abbruchereignis auf der Spanne auf. Legt den Span-Status auf ERROR mit dem Abbruchgrund fest und markiert den Fehlertyp als "TaskCanceledException".

function recordCancellation(reason?: string)

Parameter

reason

string

Optionaler Abbruchgrund. Der Standardwert ist "Vorgang wurde abgebrochen".

Geerbt vonOpenTelemetryScope.recordCancellation

recordError(Error)

Zeichnet einen Fehler auf, der während des Vorgangs aufgetreten ist.

function recordError(error: Error)

Parameter

error

Error

Der Fehler, der aufgetreten ist

Geerbt vonOpenTelemetryScope.recordError

setEndTime(TimeInput)

Legt eine benutzerdefinierte Endzeit für den Bereich fest. Wenn dieser Wert festgelegt ist, übergibt Dispose diesen Wert span.end() anstelle der aktuellen Zeit für die Wanduhr. Dies ist nützlich, wenn die tatsächliche Endzeit des Vorgangs bekannt ist, bevor der Bereich verworfen wird.

function setEndTime(endTime: TimeInput)

Parameter

endTime

TimeInput

Die Endzeit als Millisekunden seit Epoche, Datum oder HrTime-Tupel.

Geerbt vonOpenTelemetryScope.setEndTime

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

Macht diese Spanne für die Dauer der asynchronen Rückrufausführung aktiv

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

Parameter

callback

() => Promise<T>

Gibt zurück

Promise<T>

Geerbt vonOpenTelemetryScope.withActiveSpanAsync