ExecuteToolScope class

الحزمة:

@microsoft/agents-a365-observability

يوفر نطاق تتبع OpenTelemetry لعمليات تنفيذ أداة الذكاء الاصطناعي.

يمتد

OpenTelemetryScope

الأساليب

recordResponse(string | Record<string, unknown>)	تسجيل معلومات الاستجابة لتعقب بيانات تتبع الاستخدام.
start(Request, ToolCallDetails, AgentDetails, UserDetails, SpanDetails)	إنشاء نطاق جديد لتعقب تنفيذ الأداة وبدء تشغيله.

الأساليب المتوارثة

dispose()	أسلوب التخلص القديم للتوافق
getSpanContext()	الحصول على سياق النطاق لهذا النطاق. يمكن استخدام هذا لإنشاء ParentSpanRef لربط أصل-تابع صريح عبر الحدود غير المتزامنة.
recordAttributes(undefined | null | Iterable<[string, AttributeValue]> | Record<string, AttributeValue>)	تسجيل أزواج متعددة من مفاتيح/قيم السمات لتعقب بيانات تتبع الاستخدام.
recordCancellation(string)	تسجيل حدث إلغاء على النطاق. تعيين حالة النطاق إلى ERROR مع سبب الإلغاء ووضع علامة على نوع الخطأ على أنه "TaskCanceledException".
recordError(Error)	تسجيل خطأ حدث أثناء العملية
setEndTime(TimeInput)	تعيين وقت انتهاء مخصص للنطاق. عند التعيين، سيمرر التخلص هذه القيمة إلى span.end() بدلا من استخدام وقت ساعة الحائط الحالي. وهذا مفيد عندما يكون وقت الانتهاء الفعلي للعملية معروفا قبل التخلص من النطاق.
withActiveSpanAsync<T>(() => Promise<T>)	جعل هذا النطاق نشطا طوال مدة تنفيذ رد الاتصال غير المتزامن

تفاصيل الأسلوب

recordResponse(string | Record<string, unknown>)

تسجيل معلومات الاستجابة لتعقب بيانات تتبع الاستخدام.

function recordResponse(response: string | Record<string, unknown>)

المعلمات

response

string | Record<string, unknown>

استجابة تنفيذ الأداة. يتم تسلسل الكائنات إلى JSON تلقائيا.

start(Request, ToolCallDetails, AgentDetails, UserDetails, SpanDetails)

إنشاء نطاق جديد لتعقب تنفيذ الأداة وبدء تشغيله.

static function start(request: Request, details: ToolCallDetails, agentDetails: AgentDetails, userDetails?: UserDetails, spanDetails?: SpanDetails): ExecuteToolScope

المعلمات

request

Request

حمولة الطلب (القناة ومعرف المحادثة والمحتوى ومعرف الجلسة).

details

ToolCallDetails

تفاصيل استدعاء الأداة (الاسم والنوع و args ومعرف المكالمة وما إلى ذلك).

agentDetails

AgentDetails

العامل الذي ينفذ الأداة. معرف المستأجر مشتق من agentDetails.tenantId.

userDetails

UserDetails

هوية المتصل البشري الاختيارية.

spanDetails

SpanDetails

تكوين النطاق الاختياري (parentContext، startTime، endTime، spanLinks، spanKind). الإعدادات الافتراضية ل SpanKind.INTERNAL.

المرتجعات

ExecuteToolScope

مثيل ExecuteToolScope جديد.

تفاصيل الأساليب المتوارثة

dispose()

أسلوب التخلص القديم للتوافق

function dispose()

موروث منOpenTelemetryScope.dispose

getSpanContext()

الحصول على سياق النطاق لهذا النطاق. يمكن استخدام هذا لإنشاء ParentSpanRef لربط أصل-تابع صريح عبر الحدود غير المتزامنة.

function getSpanContext(): SpanContext

المرتجعات

SpanContext

SpanContext الذي يحتوي على traceId و spanId

موروث منOpenTelemetryScope.getSpanContext

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

تسجيل أزواج متعددة من مفاتيح/قيم السمات لتعقب بيانات تتبع الاستخدام.

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

المعلمات

attributes

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

مجموعة أزواج مفتاح/قيمة السمة (صفيف أو قابل للكرر من [مفتاح أو قيمة] أو مخطط كائن).

موروث منOpenTelemetryScope.recordAttributes

recordCancellation(string)

تسجيل حدث إلغاء على النطاق. تعيين حالة النطاق إلى ERROR مع سبب الإلغاء ووضع علامة على نوع الخطأ على أنه "TaskCanceledException".

function recordCancellation(reason?: string)

المعلمات

reason

string

سبب الإلغاء الاختياري. الإعدادات الافتراضية ل "تم إلغاء المهمة".

موروث منOpenTelemetryScope.recordCancellation

recordError(Error)

تسجيل خطأ حدث أثناء العملية

function recordError(error: Error)

المعلمات

error

Error

الخطأ الذي حدث

موروث منOpenTelemetryScope.recordError

setEndTime(TimeInput)

تعيين وقت انتهاء مخصص للنطاق. عند التعيين، سيمرر التخلص هذه القيمة إلى span.end() بدلا من استخدام وقت ساعة الحائط الحالي. وهذا مفيد عندما يكون وقت الانتهاء الفعلي للعملية معروفا قبل التخلص من النطاق.

function setEndTime(endTime: TimeInput)

المعلمات

endTime

TimeInput

وقت الانتهاء بالمللي ثانية منذ فترة أو تاريخ أو مجموعة HrTime.

موروث منOpenTelemetryScope.setEndTime

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

جعل هذا النطاق نشطا طوال مدة تنفيذ رد الاتصال غير المتزامن

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

المعلمات

callback

() => Promise<T>

المرتجعات

Promise<T>

موروث منOpenTelemetryScope.withActiveSpanAsync