المعاملات والمصادقة

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

المعاملات

في صفحة الأداة، يسرد Parameters ما يجب أن يقدّمه النموذج. اختر Add parameter واملأ:

الحقل	المعنى
Name	مثل `order_id`. ويجب أن يطابق أي `{order_id}` في العنوان أو قالب النص.
Type	`string` أو `number` أو `integer` أو `boolean`.
Description	"What this is, in words the model can act on"، مثل "The order number the caller read out".
Required	إذا حُدِّد، يُرفَض الاستدعاء حين يغفله النموذج.

وقبل كل طلب تتحقق Phynxa من وسائط النموذج: يجب أن تكون المطلوبة موجودة، ويجب أن تطابق القيم أنواعها (فكلمة "اثنا عشر" منطوقة وأُرسلت نصًا إلى integer تُرفَض برسالة يستطيع النموذج التعافي منها)، ويُسقَط كل ما يختلقه النموذج ولم يُعرَّف.

قالب النص (Body template)

في POST وPUT وPATCH يتيح لك Body template تشكيل JSON. اكتب JSON صالحًا واستخدم عناصر نائبة {name}:

json

{
  "orderId": "{order_id}",
  "channel": "voice-agent",
  "note": "{note}"
}

تُهرَّب العناصر النائبة، فلا يستطيع المتصل الخروج من سلسلة نصية بنطق علامة اقتباس. وإذا لم يكن القالب JSON صالحًا بعد الاستبدال، تُبلغ الأداة "Body template is not valid JSON".

المصادقة

تحت Authentication، اختر Type:

النوع	ما ترسله Phynxa
None	لا شيء إضافي.
API key	السرّ في ترويسة أو معامل استعلام تسمّيه. اضبط Sent as على Header أو Query parameter وName على مثل `X-Api-Key`.
Bearer token	`Authorization: Bearer <secret>`.
OAuth token	`Authorization: Bearer <secret>` (رمز تلصقه أنت؛ ولا تُجري Phynxa مسار OAuth للأدوات).

تقول الصفحة "The secret is stored on the server and never sent back to this page." ولاستبداله اكتب سرًّا جديدًا. وترك الحقل فارغًا يُبقي السرّ المخزَّن.

الحدود

Timeout: حتى 30 ثانية، والافتراضي 5. "The caller waits in silence, so keep this short."
Attempts: من 1 إلى 5. "Only timeouts and server errors are retried." والطلبات التي تغيّر شيئًا (POST وPATCH) لا تُعاد أبدًا، فلا يمكن إجراء حجز مرتين.

الاختبار

استخدم Test بقيمة حقيقية. راجع اختبر الأدوات وأصلح أعطالها.

أدلة ذات صلة

هل في هذه الصفحة ما لا يطابق ما تراه في لوحة التحكم؟ أخبرنا.