CreateAgentOptionalParams interface

الحزمة:

@azure/ai-agents

المعلمات الاختيارية.

يمتد

OperationOptions

الخصائص

description	وصف العامل الجديد.
instructions	إرشادات النظام للعامل الجديد لاستخدامها.
metadata	مجموعة تصل إلى 16 زوج مفتاح/قيمة يمكن إرفاقها بكائن، وتستخدم لتخزين معلومات إضافية حول هذا الكائن بتنسيق منظم. قد يصل طول المفاتيح إلى 64 حرفا وقد يصل طول القيم إلى 512 حرفا.
name	اسم العامل الجديد.
responseFormat	تنسيق استجابة استدعاءات الأداة المستخدمة من قبل هذا العامل.
temperature	ما هي درجة حرارة أخذ العينات لاستخدامها، بين 0 و2. القيم الأعلى مثل 0.8 ستجعل الإخراج أكثر عشوائية، بينما القيم الأقل مثل 0.2 ستجعله أكثر تركيزا وحسما.
toolResources	مجموعة من الموارد التي تستخدمها أدوات العامل. الموارد خاصة بنوع الأداة. على سبيل المثال، تتطلب أداة code_interpreter قائمة بمعرفات الملفات، بينما تتطلب أداة file_search قائمة بمعرفات مخزن المتجهات.
tools	مجموعة الأدوات التي يجب تمكينها للعامل الجديد.
topP	بديل لأخذ العينات مع درجة الحرارة، يسمى أخذ عينات النواة، حيث يأخذ النموذج في الاعتبار نتائج الرموز المميزة مع كتلة احتمال top_p. لذا فإن 0.1 يعني أن الرموز المميزة التي تتألف من أعلى 10% كتلة احتمالية فقط هي التي تعتبر. نوصي عموما بتغيير هذه أو درجة الحرارة ولكن ليس كليهما.

الخصائص الموروثة

abortSignal	الإشارة التي يمكن استخدامها لإجهاض الطلبات.
onResponse	دالة سيتم استدعاؤها في كل مرة يتم فيها تلقي استجابة من الخادم أثناء تنفيذ العملية المطلوبة. قد يتم استدعاؤه عدة مرات.
requestOptions	الخيارات المستخدمة عند إنشاء طلبات HTTP وإرسالها لهذه العملية.
tracingOptions	الخيارات المستخدمة عند تمكين التتبع.

تفاصيل الخاصية

description

وصف العامل الجديد.

description?: null | string

قيمة الخاصية

null | string

instructions

إرشادات النظام للعامل الجديد لاستخدامها.

instructions?: null | string

قيمة الخاصية

null | string

metadata

مجموعة تصل إلى 16 زوج مفتاح/قيمة يمكن إرفاقها بكائن، وتستخدم لتخزين معلومات إضافية حول هذا الكائن بتنسيق منظم. قد يصل طول المفاتيح إلى 64 حرفا وقد يصل طول القيم إلى 512 حرفا.

metadata?: null | Record<string, string>

قيمة الخاصية

null | Record<string, string>

name

اسم العامل الجديد.

name?: null | string

قيمة الخاصية

null | string

responseFormat

تنسيق استجابة استدعاءات الأداة المستخدمة من قبل هذا العامل.

responseFormat?: null | AgentsResponseFormatOption

قيمة الخاصية

null | AgentsResponseFormatOption

temperature

ما هي درجة حرارة أخذ العينات لاستخدامها، بين 0 و2. القيم الأعلى مثل 0.8 ستجعل الإخراج أكثر عشوائية، بينما القيم الأقل مثل 0.2 ستجعله أكثر تركيزا وحسما.

temperature?: null | number

قيمة الخاصية

null | number

toolResources

مجموعة من الموارد التي تستخدمها أدوات العامل. الموارد خاصة بنوع الأداة. على سبيل المثال، تتطلب أداة code_interpreter قائمة بمعرفات الملفات، بينما تتطلب أداة file_search قائمة بمعرفات مخزن المتجهات.

toolResources?: null | ToolResources

قيمة الخاصية

null | ToolResources

tools

مجموعة الأدوات التي يجب تمكينها للعامل الجديد.

tools?: ToolDefinitionUnion[]

قيمة الخاصية

ToolDefinitionUnion[]

topP

بديل لأخذ العينات مع درجة الحرارة، يسمى أخذ عينات النواة، حيث يأخذ النموذج في الاعتبار نتائج الرموز المميزة مع كتلة احتمال top_p. لذا فإن 0.1 يعني أن الرموز المميزة التي تتألف من أعلى 10% كتلة احتمالية فقط هي التي تعتبر.

نوصي عموما بتغيير هذه أو درجة الحرارة ولكن ليس كليهما.

topP?: null | number

قيمة الخاصية

null | number

تفاصيل الخاصية الموروثة

abortSignal

الإشارة التي يمكن استخدامها لإجهاض الطلبات.

abortSignal?: AbortSignalLike

قيمة الخاصية

AbortSignalLike

موروث من OperationOptions.abortSignal

onResponse

دالة سيتم استدعاؤها في كل مرة يتم فيها تلقي استجابة من الخادم أثناء تنفيذ العملية المطلوبة. قد يتم استدعاؤه عدة مرات.

onResponse?: RawResponseCallback

قيمة الخاصية

RawResponseCallback

موروث من OperationOptions.onResponse

requestOptions

الخيارات المستخدمة عند إنشاء طلبات HTTP وإرسالها لهذه العملية.

requestOptions?: OperationRequestOptions

قيمة الخاصية

OperationRequestOptions

موروثة من OperationOptions.requestOptions

tracingOptions

الخيارات المستخدمة عند تمكين التتبع.

tracingOptions?: OperationTracingOptions

قيمة الخاصية

OperationTracingOptions

موروث من OperationOptions.tracingOptions