المخرجات المنظمة واستدعاء الأدوات

​

اختر المسار

​

وضع JSON

{
  "model": "gpt-5.4",
  "messages": [
    {
      "role": "user",
      "content": "Return a JSON object with city and weather."
    }
  ],
  "response_format": { "type": "json_object" }
}

​

حلقة استدعاء الأدوات

1. أرسل الرسائل بالإضافة إلى تعريفات الأدوات.
2. اقرأ استجابة النموذج لـ tool_calls و function_call و tool_use من Anthropic أو أجزاء استدعاء الوظائف Gemini.
3. نفذ الأداة في الخلفية الخاصة بك.
4. أضف نتيجة الأداة بالشكل المطلوب من نفس المسار.
5. استمر في المحادثة حتى يعود النموذج بإجابة نهائية.

​

مثال على استكمالات الدردشة

curl https://api.tokenlab.sh/v1/chat/completions \
  -H "Authorization: Bearer sk-your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-5.4",
    "messages": [
      {
        "role": "user",
        "content": "Extract name and email as JSON. If needed, look up the customer."
      }
    ],
    "response_format": { "type": "json_object" },
    "tools": [
      {
        "type": "function",
        "function": {
          "name": "lookup_customer",
          "description": "Look up a customer by email",
          "parameters": {
            "type": "object",
            "properties": {
              "email": { "type": "string" }
            },
            "required": ["email"]
          }
        }
      }
    ]
  }'

​

تصميم المخطط

• احتفظ بالمخططات صغيرة وصريحة. تضيف المخططات الكبيرة المتداخلة رموزًا وتقلل من الاعتمادية.
• فضل الحقول المطلوبة للقيم التي لا يمكن لمنتجك الاستمرار بدونها.
• استخدم enums لمجموعات مغلقة تعتمد عليها واجهة المستخدم أو الخلفية الخاصة بك.
• قم بتضمين أمثلة في الطلب عندما يواجه النموذج صعوبة في شكل معين.
• اعتبر أخطاء الحقول غير المدعومة كتعليقات على العقد. قم بإزالة الحقل أو استخدم المسار الأصلي الذي يوثقه.

​

قائمة التحقق للإنتاج

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

​

مرجع API