ما هو استدعاء الوظيفة؟

استدعاء الدالة، المعروف أيضا باسم استدعاء الأدوات، يسمح لنموذج لغوي بأن يطلب من تطبيقك تشغيل دالة. تصف كل دالة بمخطط JSON، ويرد النموذج باسم دالة ووسيطات، ويشغل كودك ذلك، ويستخدم النموذج النتيجة للاستمرار أو الإجابة.

المفاهيم

كيف تعمل استدعاء الدوال

نموذج اللغة بمفرده يولد نصا فقط. تمنحه استدعاء الدوال طريقة منظمة لطلب شيء لا يمكنه القيام به بمفرده، مثل قراءة قاعدة بيانات، أو التحقق من ترتيب أو استدعاء واجهة برمجة تطبيقات أخرى. دورة واحدة تبدو هكذا:

  1. ترسل المحادثة مع الأدوات. كل أداة لها الاسم, a الوصف و المعلمات مكتوبة ك JSON Schema.
  2. يقرر النموذج ما إذا كانت الأداة ستساعد. إذا كانت ستساعد، فإن الاستجابة تحمل tool_calls مع اسم الدالة ووسائط JSON، و finish_reason هي tool_calls.
  3. كودك يتحقق من الوسائط ويشغل الدالة.
  4. ترسل المحادثة مرة أخرى مع إضافة النتيجة كرسالة مع الأداة الدور.
  5. يجيب النموذج من النتيجة، أو يستدعي أداة أخرى.

على سبيل المثال، مع get_order_status دالة تأخذ order_id، الرسالة تحقق من حالة الطلب 1042 ينتج نداء إلى get_order_status مع {"order_id": "1042"}. الكود الخاص بك يبحث عن الطلب، يعيد حالته، ويحول النموذج تلك الحالة إلى رد.

النموذج لا يشغل الكود بنفسه أبدا. يقترح استدعاء، ويقرر تطبيقك ما إذا كان سيشغل النموذج وكيف يعمل، مما يبقي الأذونات والآثار الجانبية تحت سيطرتك.

التحكم في استخدام الأداة

  • tool_choice يحدد كيفية استخدام النموذج للأدوات: أوتو دعه يقرر، لا شيء يمنع المكالمات، مطلوب يجعله يستدعي أداة، ويفرض الكائن الذي يطلق اسم دالة واحدة على تلك الدالة. بعض النماذج تقبل فقط أوتو، أو أوتو و لا شيء; تسرد كل صفحة نموذج ما تقبله.
  • parallel_tool_calls، على النماذج التي تقدمها، يسمح للنموذج بطلب عدة مكالمات في دور واحد. قم بتشغيلها، ثم أعد نتيجة واحدة لكل مكالمة.
  • الأوصاف توجه الاختيار. يختار النموذج الأدوات من أسمائها ووصفها، لذا يوضح ما تفعله كل دالة ومتى تستخدمها، ويحافظ على مخططات المعلمات صارمة مع الحقول المطلوبة و حرب القيم.
  • التعريفات هي مدخلات. ترسل تعريفات الأدوات مع كل طلب وتحتسب كرموز إدخال. قم بتضمين الأدوات التي تحتاجها المهمة فقط، وحافظ على القائمة متطابقة بين الطلبات بحيث التخزين المؤقت السريع يمكن تطبيقه على النماذج التي تدعمه.

في بعض نماذج المنطق، يتم تشغيل طلب يجبر على استدعاء أداة بدون تفكير ما لم يتم تعيين أيضا enable_thinking.

استدعاء الدوال عبر نقاط النهاية

يقبل EmpirioLabs AI الأدوات على شكل كل واجهة برمجة تطبيقات تتوافق معها:

  • /v1/chat/completions الأخذات الأدوات و tool_choice كما هو موضح أعلاه والعوائد tool_calls.
  • /v1/responses ترجع المكالمات ك function_call العناصر المخرجة.
  • /v1/messages رحلات ذهاب وعودة tool_use و tool_result كتل المحتوى.
  • صوت في الوقت الحقيقي النماذج التي تدعم IT تستدعي وظائف أثناء المحادثة الحية: تعلن عن الأدوات في session.update وترجع كل نتيجة ك function_call_output العنصر.

ال مرجع إكمالات الدردشة يتضمن طلب استدعاء أداة كامل.

أدوات الوظائف والأدوات المدمجة

بعض النماذج توفر أيضا أدوات مدمجة، مثل البحث على الويب أو مفسر الكود، تعمل أثناء الطلب دون الحاجة إلى الذهاب والعودة إلى الكود. تقوم بتفعيلها باستخدام معلمة نموذج مثل tool_web_search، أو مع web_search أداة على /v1/responses و /v1/messages، على النماذج التي تقدمها. يمكن للأداة المدمجة إضافة رسوم خاصة بها لكل مكالمة أو لكل طلب، مدرجة في تسعير النموذج، بينما تعمل أداة الوظيفة في تطبيقك الخاص.

في بعض النماذج، لا تستخدم أداة مدمجة عندما يحتوي نفس الطلب أيضا على أدوات وظيفية، لذا تحقق من صفحة النموذج قبل دمجها. تصفح نماذج نصية لمعرفة أي دالة دعم تستدعي، أو لتجربة نموذج في Playground.

النماذج على EmpirioLabs AI

عدد النماذج: 82، مرتبة من الأرخص حين تشترك في وحدة الفوترة. تعرض صفحة كل نموذج جدول أسعاره الكامل ومعلماته وأمثلة الكود.

نقاط النهاية

POST /v1/chat/completions POST /v1/responses POST /v1/messages POST /v1/completions POST /v1/audio/speech POST /v1/audio/speech:stream WEBSOCKET /v1/realtime

لكل مليون رمز، حسب سعر الإدخال

النموذجالإدخالالإخراج
GLM 4.5 Flash Z.aiمجانيمجاني
GLM 4.6V Flash Z.aiمجانيمجاني
GLM 4.7 Flash Z.aiمجانيمجاني
Qwen3.7 Flash Alibaba Cloud<=32K $0.03 32K-256K $0.10 256K-1M $0.20<=32K $0.13 32K-256K $0.40 256K-1M $0.80
Qwen3.5 4B Alibaba Cloud$0.04$0.07
Nova Micro 1.0 Amazon$0.040$0.16
GLM 4.6V FlashX Z.ai$0.04$0.40
Gemma 4 26B-A4B Google$0.15$0.05$0.50$0.29
عرض جميع النماذج (70)
النموذجالإدخالالإخراج
Qwen3.5 35B-A3B Alibaba Cloud$0.25 <=128K $0.057 $0.25 128K-256K $0.229$2.00 <=128K $0.459 $2.00 128K-256K $1.835
Nova Lite 1.0 Amazon$0.069$0.28
GLM 4.7 FlashX Z.ai$0.07$0.40
Qwen3.6 35B A3B Alibaba Cloud$0.248$0.07$1.485$0.42
GLM 5.3 Flash Z.ai$0.075$0.25
Qwen3.5 27B Alibaba Cloud$0.30 <=128K $0.086 $0.30 128K-256K $0.258$2.40 <=128K $0.688 $2.40 128K-256K $2.064
Qwen3.5 9B Alibaba Cloud$0.10$0.09$0.15$0.13
Qwen3.5 Flash Alibaba Cloud$0.10$0.090$0.40$0.368
Step 3.5 Flash StepFun$0.10$0.30
Step 3.5 Flash 2603 StepFun$0.10$0.30
MiniMax M3.1 Flash MiniMax$0.15$0.1125$0.60$0.45
Qwen3.5 122B-A10B Alibaba Cloud$0.40 <=128K $0.115 $0.40 128K-256K $0.287$3.20 <=128K $0.917 $3.20 128K-256K $2.294
Seed 2.0 Mini ByteDance<=128K $0.12 128K-256K $0.24<=128K $0.50 128K-256K $1.00
MiMo V2.6 Flash Xiaomi$0.14$0.28
Mistral Small 4 Mistral AI$0.15$0.60
Qwen3.8 Flash Alibaba Cloud$0.16$0.47
Qwen3.8 27B Alibaba Cloud$0.45$0.17$3.20$0.50
Qwen3.5 397B-A17B Alibaba Cloud$0.60 <=128K $0.172 $0.60 128K-256K $0.43$3.60 <=128K $1.032 $3.60 128K-256K $2.58
DeepSeek V4.1 Flash 1017 DeepSeek$0.20$0.80
Muse Glimmer 30B Meta AI$0.35$0.20$1.50$0.80
Step 3.7 Flash StepFun$0.20$1.15
MiniMax M3 MiniMax$0.30 <=512K $0.225 $0.60 >512K $0.45$1.20 <=512K $0.90 $2.40 >512K $1.80
Qwen3.6 Flash Alibaba Cloud<=256K $0.25 256K-1M $1.00<=256K $1.50 256K-1M $4.00
Qwen3.8 Omni Flash Alibaba Cloud$0.30$0.94
Seed 2.0 Lite ByteDance<=128K $0.31 128K-256K $0.62<=128K $2.50 128K-256K $5.00
Qwen3.5 Plus Alibaba Cloud$0.40 <=256K $0.36 $0.50 256K-1M $0.45$2.40 <=256K $2.21 $3.00 256K-1M $2.76
Nova Lite 2 Amazon$0.38$3.16
Qwen3.7 Plus Alibaba Cloud<=256K $0.40 256K-1M $1.20<=256K $1.60 256K-1M $4.80
Seed 2.0 Code ByteDance<=128K $0.40 128K-256K $0.80<=128K $2.40 128K-256K $4.80
Qwen3.6 27B Alibaba Cloud$0.60$0.412564$3.60$2.475384
DeepSeek V4 Flash 0731 DeepSeek$0.424$1.272
MiMo V2.6 Pro Xiaomi$0.435$0.87
Qwen3.6 Plus Alibaba Cloud<=256K $0.50 256K-1M $2.00<=256K $3.00 256K-1M $6.00
Seed 2.1 Turbo ByteDance$0.63$3.13
Seed 2.0 Pro ByteDance<=128K $0.63 128K-256K $1.26<=128K $3.79 128K-256K $7.58
Qwen3.5 Omni Flash Alibaba Cloud$0.80$4.40
GLM 5.1 Z.ai$1.40 <=32K $0.825 $1.40 32K-200K $1.10$4.40 <=32K $3.301 $4.40 32K-200K $3.851
Kimi K2.6 Moonshot AI$0.95$0.8939$4.00$3.7131
Kimi K2.7 Code Moonshot AI$0.95$4.00
Step 5 Preview StepFun$1.00$2.70
Muse Spark 1.1 Meta AI$1.25$4.25
Muse Spark 1.2 Meta AI$1.25$4.25
Muse Spark 1.3 Meta AI$1.25$4.25
DeepSeek V4 Pro 0813 DeepSeek$1.32$3.96
GLM 5.2 Z.ai$1.40$4.40
GLM 5.3 Z.ai$1.40$4.40
StepAudio 3 Chat StepFun$1.50$3.50
Qwen4 Max Alibaba Cloud$1.50$4.50
DeepSeek V4 Pro DeepSeek$1.74$1.65$3.48$3.30
Kimi K2.7 Code Highspeed Moonshot AI$1.90$8.00
Fugu Max Sakana AI$2.00$6.00
Qwen3.8 Max Alibaba Cloud$2.00$6.00
Qwen3.8 Max 0902 Alibaba Cloud$2.00$6.00
Kimi K3.1 Pro Moonshot AI$2.00$10.00
Nova Pro 1.0 Amazon$2.40$9.60
Qwen3.7 Max Alibaba Cloud$2.50$7.50
Qwen3.5 Omni Plus Alibaba Cloud$2.80$16.60
Kimi K3 Moonshot AI$3.00$15.00
MiMo V2.6 Pro UltraSpeed Xiaomi$4.35$8.70
Fugu Ultra v1.1 Sakana AI<=272K $5.00 >272K $10.00<=272K $30.00 >272K $45.00
Fugu Ultra v2.0 Sakana AI<=272K $5.00 >272K $10.00<=272K $30.00 >272K $45.00
Fugu Ultra v1.0 Sakana AI<=272K $7.50 >272K $15.00<=272K $45.00 >272K $67.50

متاح أيضًا: Mistral Small 3.1, StepAudio 3 Realtime, StepAudio 2.5 Realtime, Qwen3.5 Omni Flash Realtime, Qwen3.5 Omni Plus Realtime, Qwen3.8 Omni Flash Realtime, Qwen Audio 3.1 Realtime Plus, Gemini 3.8 Live, Gemini 3.8 Live Extended Thinking, Qwen Audio 3.1 Realtime Flash, Qwen Audio 3.0 Realtime Plus, Qwen Audio 3.0 Realtime Flash

الأسئلة الشائعة

هل يقوم النموذج بتشغيل وظائفي؟

لا. يعيد النموذج اسم الدالة والوسيطات، ويقوم تطبيقك بتشغيل الدالة ويرسل النتيجة. لا يعمل شيء ما لم يشغلها الكود.

ما الفرق بين استدعاء الدوال والمخرج المنظم؟

الإخراج المنظم يعيد JSON كإجابة نهائية. استدعاء الدالة يعيد طلبا ليعمل كودك، ثم يستمر بمجرد إرسال النتيجة.

هل يمكن للنموذج استدعاء عدة وظائف في نفس الوقت؟

النماذج التي تقدم parallel_tool_calls يمكنها طلب عدة مكالمات في دور واحد. شغل كل واحدة وأعد نتيجة لكل مكالمة.

هل تعريفات الأدوات تكلف رموزا؟

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

هل أنت مستعد لاستخدام نقاط نهاية أفضل؟

تحقق من تسعيرنا أو تواصل إذا كنت ترغب في نشر نموذجك الخاص على مجموعتنا.