InvokeAgentScope class

Pacote:

@microsoft/agents-a365-observability

Fornece o âmbito de rastreamento OpenTelemetry para operações de invocação de agentes de IA.

Extends

OpenTelemetryScope

Métodos

recordInputMessages(InputMessagesParam)	Grava as mensagens de entrada para rastreio de telemetria. Aceita uma única cadeia, um array de cadeias (auto-encapsulado como OTEL ChatMessage com função user), ou um wrapper InputMessages versionado.
recordOutputMessages(OutputMessagesParam)	Grava as mensagens de saída para rastreamento de telemetria. Aceita uma única cadeia, um array de cadeias (auto-encapsulado como OTEL OutputMessage com role assistant), ou um wrapper OutputMessages versionado.
recordResponse(string)	Regista informações de resposta para rastreamento de telemetria.
start(Request, InvokeAgentScopeDetails, AgentDetails, CallerDetails, SpanDetails)	Cria e inicia um novo âmbito para o rastreio de invocação de agentes.

Métodos Herdados

dispose()	Método de descarte legado para compatibilidade
getSpanContext()	Obtém o contexto de extensão para este telescópio. Isto pode ser usado para criar um ParentSpanRef para ligações explícitas pai-filho através de fronteiras assíncronas.
recordAttributes(undefined | null | Iterable<[string, AttributeValue]> | Record<string, AttributeValue>)	Grava múltiplos pares chave/valor de atributos para rastreamento de telemetria.
recordCancellation(string)	Regista um evento de cancelamento durante a travessia. Define o estado do span para ERRO com a razão do cancelamento e marca o tipo de erro como 'TaskCanceledException'.
recordError(Error)	Regista um erro ocorrido durante a operação
setEndTime(TimeInput)	Define uma hora de fim personalizada para o telescópio. Quando definido, descarte transmite este valor para span.end() em vez de usar o tempo atual do relógio de parede. Isto é útil quando a hora real de fim da operação é conhecida antes do escopo.
withActiveSpanAsync<T>(() => Promise<T>)	Torna este intervalo ativo durante toda a execução do callback assíncrono

Detalhes de Método

recordInputMessages(InputMessagesParam)

Grava as mensagens de entrada para rastreio de telemetria. Aceita uma única cadeia, um array de cadeias (auto-encapsulado como OTEL ChatMessage com função user), ou um wrapper InputMessages versionado.

function recordInputMessages(messages: InputMessagesParam)

Parâmetros

messages

InputMessagesParam

Uma string, array de strings ou um wrapper InputMessages

recordOutputMessages(OutputMessagesParam)

Grava as mensagens de saída para rastreamento de telemetria. Aceita uma única cadeia, um array de cadeias (auto-encapsulado como OTEL OutputMessage com role assistant), ou um wrapper OutputMessages versionado.

function recordOutputMessages(messages: OutputMessagesParam)

Parâmetros

messages

OutputMessagesParam

Uma string, array de strings ou um wrapper OutputMessages

recordResponse(string)

Regista informações de resposta para rastreamento de telemetria.

function recordResponse(response: string)

Parâmetros

response

string

A resposta de invocação

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

Cria e inicia um novo âmbito para o rastreio de invocação de agentes.

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

Parâmetros

request

Request

Solicita carga útil (channel, conversationId, content, sessionId).

invokeScopeDetails

InvokeAgentScopeDetails

Detalhes ao nível do âmbito

agentDetails

AgentDetails

A identidade do agente. O ID do inquilino é derivado de agentDetails.tenantId (obrigatório).

callerDetails

CallerDetails

Informação opcional para o chamador. Suporta três cenários:

• Apenas para o chamado humano: { userDetails: { userId, userName, ... } }
• Apenas para agentes: { callerAgentDetails: { agentId, agentName, ... } }
• Ambos (A2A com humano em cadeia): { userDetails: { ... }, callerAgentDetails: { ... } }

spanDetails

SpanDetails

Configuração opcional de span (parentContext, startTime, endTime, spanKind, spanLinks).

Devoluções

InvokeAgentScope

Uma nova instância InvokeAgentScope.

Detalhes do Método Herdado

dispose()

Método de descarte legado para compatibilidade

function dispose()

Herdado doOpenTelemetryScope.dispose

getSpanContext()

Obtém o contexto de extensão para este telescópio. Isto pode ser usado para criar um ParentSpanRef para ligações explícitas pai-filho através de fronteiras assíncronas.

function getSpanContext(): SpanContext

Devoluções

SpanContext

O SpanContext contendo traceId e spanId

Herdado deOpenTelemetryScope.getSpanContext

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

Grava múltiplos pares chave/valor de atributos para rastreamento de telemetria.

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

Parâmetros

attributes

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

Coleção de pares chave/valor de atributos (array ou iterável de [chave, valor] ou mapa de objetos).

Herdado deOpenTelemetryScope.recordAttributes

recordCancellation(string)

Regista um evento de cancelamento durante a travessia. Define o estado do span para ERRO com a razão do cancelamento e marca o tipo de erro como 'TaskCanceledException'.

function recordCancellation(reason?: string)

Parâmetros

reason

string

Motivo opcional de cancelamento. Por defeito, 'Tarefa foi cancelada'.

Herdado doOpenTelemetryScope.recordCancelamento

recordError(Error)

Regista um erro ocorrido durante a operação

function recordError(error: Error)

Parâmetros

error

Error

O erro que ocorreu

Herdado doOpenTelemetryScope.recordError

setEndTime(TimeInput)

Define uma hora de fim personalizada para o telescópio. Quando definido, descarte transmite este valor para span.end() em vez de usar o tempo atual do relógio de parede. Isto é útil quando a hora real de fim da operação é conhecida antes do escopo.

function setEndTime(endTime: TimeInput)

Parâmetros

endTime

TimeInput

O tempo de fim em milissegundos desde a época, uma Data ou uma tupla HrTime.

Herdado deOpenTelemetryScope.setEndTime

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

Torna este intervalo ativo durante toda a execução do callback assíncrono

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

Parâmetros

callback

() => Promise<T>

Devoluções

Promise<T>

Herdado doOpenTelemetryScope.withActiveSpanAsync