الدرس 1 من 3 · ١٠ دقائق

استدعِ الأدوات

صِف دوالك، وشغّل الاستدعاءات التي يطلبها النموذج، وأعد النتائج إليه حتى يجيب.

صِف دوالك في tools، وسيجيب النموذج باستدعاء لإحداها، مثل بحث في قاعدة بيانات، بدلًا من التخمين. النموذج لا يشغّل أي شيء بنفسه: تطبيقك يشغّل الدالة ويعيد النتيجة، ثم يكتب النموذج الإجابة النهائية.

curl https://api.phaseo.app/v1/chat/completions \
  -H "Authorization: Bearer $PHASEO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "openai/gpt-6-astra",
    "messages": [
      { "role": "user", "content": "What is the weather in London?" }
    ],
    "tools": [
      {
        "type": "function",
        "function": {
          "name": "get_weather",
          "description": "Get current weather by city",
          "parameters": {
            "type": "object",
            "properties": {
              "city": { "type": "string" }
            },
            "required": ["city"]
          }
        }
      }
    ]
  }'

في Chat Completions يحمل الرد finish_reason: "tool_calls" وقائمة tool_calls في رسالة المساعد، لكل منها id وname للدالة وarguments كسلسلة JSON. شغّل كل استدعاء، ثم أرسل طلب متابعة يكرر المحادثة، ورسالة المساعد دون تغيير، ورسالة role: "tool" واحدة لكل استدعاء مطابقة عبر tool_call_id. أرسل tools مرة أخرى. سيجيب النموذج أو يستدعي أداة أخرى، فتكرر. على /v1/responses يكون الاستدعاء عنصر function_call ونتيجتك عنصر function_call_output بقيمة call_id نفسها، وعلى /v1/messages تكونان كتلتَي tool_use وtool_result.

يتحكم tool_choice في ما إذا كان يجوز للنموذج استدعاء الأدوات: none للنص فقط، وauto (أو اتركه) ليقرر النموذج، وrequired لفرض استدعاء، أو كائن يسمّي أداة واحدة. اضبط parallel_tool_calls على false عندما يجب أن تعمل أدواتك واحدة تلو الأخرى.

تعامل مع كل استدعاء كمدخلات غير موثوقة. قارن اسم الأداة بقائمة سماح، وارفض الأسماء غير المعروفة، وتحقّق من الوسائط بعد تحليلها قبل تشغيل أي شيء. إذا فشل التحقق، فلا تشغّل الأداة: أرسل خطأً قصيرًا كنتيجة الأداة ودع النموذج يعيد المحاولة. مع stream: true، اجمع كل أجزاء الوسائط قبل التحليل. الأدوات التي يبدأ نوعها بـ phaseo:، مثل phaseo:web_search أو phaseo:datetime، تعمل لدى Phaseo، فتحصل على الإجابة النهائية دون أن تكتب منفّذًا. أدوات الخادم هذه في مرحلة تجريبي.

تحقّق من فهمك

يعيد النموذج استدعاءً لـ delete_user مع {"id": "42"}. تطبيقك لا يعرّف إلا get_weather. ماذا يجب أن يفعل كودك؟

طبّق ما تعلّمته

يستدعي روبوت الدعم لديك get_order ثم يجيب. حلقة كتبها زميلك ترسل رسالة role: "tool" وحدها في طلب المتابعة، فيرفضها المزوّد. ما الناقص؟

اعرض الإجابة

يجب أن يكرر طلب المتابعة المحادثة، ثم رسالة المساعد مع tool_calls دون تغيير، ثم رسالة role: "tool" واحدة لكل استدعاء مع tool_call_id المطابق. وأرسل tools مرة أخرى أيضًا. نتيجة أداة لا يسبقها استدعاء لا تجد ما تطابقه.

الخلاصة

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

روابط ذات صلة

يُحفظ تقدّمك في هذا المتصفح.

آخر مراجعة: ١٧ نوفمبر ٢٠٢٦