Agent interface

الحزمة:

@azure/ai-agents

يمثل وكيلا يمكنه استدعاء النموذج واستخدام الأدوات.

الخصائص

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

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

createdAt

الطابع الزمني Unix، بالثوان، يمثل وقت إنشاء هذا الكائن.

createdAt: Date

قيمة الخاصية

Date

description

وصف العامل.

description: null | string

قيمة الخاصية

null | string

id

المعرف، الذي يمكن الرجوع إليه في نقاط نهاية واجهة برمجة التطبيقات.

id: string

قيمة الخاصية

string

instructions

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

instructions: null | string

قيمة الخاصية

null | string

metadata

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

metadata: null | Record<string, string>

قيمة الخاصية

null | Record<string, string>

model

معرف النموذج المراد استخدامه.

model: string

قيمة الخاصية

string

name

اسم العامل.

name: null | string

قيمة الخاصية

null | string

object

نوع الكائن، وهو مساعد دائما.

object: "assistant"

قيمة الخاصية

"assistant"

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