InvokeAgentScope class

Fornisce l'ambito di traccia OpenTelemetry per le operazioni di chiamata dell'agente di intelligenza artificiale.

Metodi

recordInputMessages(InputMessagesParam)	Registra i messaggi di input per il rilevamento dei dati di telemetria. Accetta una singola stringa, una matrice di stringhe (con wrapping automatico come ChatMessage MULTIDIMENSIONAL con ruolo `user`) o un wrapper InputMessages con versione.
recordOutputMessages(OutputMessagesParam)	Registra i messaggi di output per il rilevamento dei dati di telemetria. Accetta una singola stringa, una matrice di stringhe (con wrapping automatico come OutputMessage MULTIDIMENSIONAL con ruolo `assistant`) o un wrapper OutputMessages con versione.
recordResponse(string)	Registra le informazioni di risposta per il rilevamento dei dati di telemetria.
start(Request, InvokeAgentScopeDetails, AgentDetails, CallerDetails, SpanDetails)	Crea e avvia un nuovo ambito per la traccia delle chiamate dell'agente.

Metodi ereditati

dispose()	Metodo dispose legacy per la compatibilità
getSpanContext()	Ottiene il contesto dell'intervallo per questo ambito. Può essere usato per creare un elemento ParentSpanRef per il collegamento esplicito padre-figlio attraverso i limiti asincroni.
recordAttributes(undefined \| null \| Iterable<[string, AttributeValue]> \| Record<string, AttributeValue>)	Registra più coppie chiave/valore di attributo per il rilevamento dei dati di telemetria.
recordCancellation(string)	Registra un evento di annullamento nell'intervallo. Imposta lo stato dell'intervallo su ERROR con il motivo dell'annullamento e contrassegna il tipo di errore come 'TaskCanceledException'.
recordError(Error)	Registra un errore che si è verificato durante l'operazione
setEndTime(TimeInput)	Imposta un'ora di fine personalizzata per l'ambito. Se impostato, dispose passerà questo valore a `span.end()` invece di usare l'ora corrente. Ciò è utile quando l'ora di fine effettiva dell'operazione è nota prima dell'eliminazione dell'ambito.
withActiveSpanAsync<T>(() => Promise<T>)	Rende attivo questo intervallo per la durata dell'esecuzione del callback asincrono

recordInputMessages(InputMessagesParam)

Registra i messaggi di input per il rilevamento dei dati di telemetria. Accetta una singola stringa, una matrice di stringhe (con wrapping automatico come ChatMessage MULTIDIMENSIONAL con ruolo user) o un wrapper InputMessages con versione.

function recordInputMessages(messages: InputMessagesParam)

Parametri

messages: InputMessagesParam

Stringa, matrice di stringhe o wrapper InputMessages

recordOutputMessages(OutputMessagesParam)

Registra i messaggi di output per il rilevamento dei dati di telemetria. Accetta una singola stringa, una matrice di stringhe (con wrapping automatico come OutputMessage MULTIDIMENSIONAL con ruolo assistant) o un wrapper OutputMessages con versione.

function recordOutputMessages(messages: OutputMessagesParam)

Parametri

messages: OutputMessagesParam

Stringa, matrice di stringhe o wrapper OutputMessages

recordResponse(string)

Registra le informazioni di risposta per il rilevamento dei dati di telemetria.

function recordResponse(response: string)

Parametri

response: string

Risposta di chiamata

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

Crea e avvia un nuovo ambito per la traccia delle chiamate dell'agente.

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

Parametri

request: Request

Payload della richiesta (channel, conversationId, content, sessionId).

invokeScopeDetails: InvokeAgentScopeDetails

Dettagli a livello di ambito

agentDetails: AgentDetails

Identità dell'agente. L'ID tenant è derivato da agentDetails.tenantId (obbligatorio).

callerDetails: CallerDetails

Informazioni facoltative sul chiamante. Supporta tre scenari:

Solo chiamante umano: { userDetails: { userId, userName, ... } }
Solo chiamante agente: { callerAgentDetails: { agentId, agentName, ... } }
Entrambi (A2A con uomo in catena): { userDetails: { ... }, callerAgentDetails: { ... } }

spanDetails: SpanDetails

Configurazione dell'intervallo facoltativo (parentContext, startTime, endTime, spanKind, spanLinks).

Valori restituiti

InvokeAgentScope

Nuova istanza di InvokeAgentScope.

dispose()

Metodo dispose legacy per la compatibilità

function dispose()

Ereditato daOpenTelemetryScope.dispose

getSpanContext()

Ottiene il contesto dell'intervallo per questo ambito. Può essere usato per creare un elemento ParentSpanRef per il collegamento esplicito padre-figlio attraverso i limiti asincroni.

function getSpanContext(): SpanContext

Valori restituiti

SpanContext

SpanContext contenente traceId e spanId

Ereditato daOpenTelemetryScope.getSpanContext

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

Registra più coppie chiave/valore di attributo per il rilevamento dei dati di telemetria.

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

Parametri

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

Raccolta di coppie chiave/valore dell'attributo (matrice o iterabile di [chiave, valore] o mappa oggetti).

Ereditato daOpenTelemetryScope.recordAttributes

recordCancellation(string)

Registra un evento di annullamento nell'intervallo. Imposta lo stato dell'intervallo su ERROR con il motivo dell'annullamento e contrassegna il tipo di errore come 'TaskCanceledException'.

function recordCancellation(reason?: string)

Parametri

reason: string

Motivo di annullamento facoltativo. L'impostazione predefinita è 'Task was cancelled'.

Ereditato daOpenTelemetryScope.recordCancellation

recordError(Error)

Registra un errore che si è verificato durante l'operazione

function recordError(error: Error)

Parametri

error: Error

L'errore che si è verificato

Ereditato daOpenTelemetryScope.recordError

setEndTime(TimeInput)

Imposta un'ora di fine personalizzata per l'ambito. Se impostato, dispose passerà questo valore a span.end() invece di usare l'ora corrente. Ciò è utile quando l'ora di fine effettiva dell'operazione è nota prima dell'eliminazione dell'ambito.

function setEndTime(endTime: TimeInput)

Parametri

endTime: TimeInput

Ora di fine come millisecondi dall'epoca, da una tupla Date o HrTime.

Ereditato daOpenTelemetryScope.setEndTime

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

Rende attivo questo intervallo per la durata dell'esecuzione del callback asincrono

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

Parametri

callback: () => Promise<T>

Valori restituiti

Promise<T>

Ereditato daOpenTelemetryScope.withActiveSpanAsync

Condividi tramite

InvokeAgentScope class

Metodi

Metodi ereditati

Dettagli metodo

recordInputMessages(InputMessagesParam)

Parametri

recordOutputMessages(OutputMessagesParam)

Parametri

recordResponse(string)

Parametri

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

Parametri

Valori restituiti

Dettagli dei metodi ereditati

dispose()

getSpanContext()

Valori restituiti

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

Parametri

recordCancellation(string)

Parametri

recordError(Error)

Parametri

setEndTime(TimeInput)

Parametri

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

Parametri

Valori restituiti