الإعدادات المسبقة

​

البدء السريع

curl https://api.phaseo.app/v1/responses \
  -H "Authorization: Bearer $PHASEO_API_KEY" \
  -H "Content-Type: application/json" \
	  -d '{
	    "model": "@release-summary",
	    "input": "Generate a release summary for the last 24 hours."
	  }'

import Phaseo from "@phaseo/sdk";

const client = new Phaseo({ apiKey: process.env.PHASEO_API_KEY! });

const response = await client.generateResponse({
	  model: "@release-summary",
	  input: "Generate a release summary for the last 24 hours.",
});

from phaseo import Phaseo

client = Phaseo(api_key="YOUR_API_KEY")

response = client.generate_response({
	    "model": "@release-summary",
	    "input": "Generate a release summary for the last 24 hours.",
})

​

ما الذي يمكن أن يتضمنه الإعداد المسبق

• مطالبة نظام تُضاف قبل كل طلب.
• نماذج أو عائلات نماذج مسموح بها.
• قوائم مزوّدين للسماح أو التجاهل ضمن تفضيلات التوجيه.
• معلمات افتراضية مثل temperature وtop_p وmax_tokens والإعدادات المشابهة.
• قيم استدلال افتراضية اختيارية للنماذج المدعومة.

• تستخدم الإعدادات الخاصة وإعدادات مساحة العمل @{slug} وتُحل ضمن مساحة العمل الخاصة بمفتاح API.
• تستخدم الإعدادات العامة @{username}/{slug} ويمكن حلها من أي مساحة عمل. مثال: @octavia/release-summary.

​

الإصدارات وتفرعات السوق

• تسلسلي: v1 وv2 وv3.
• الإصدار الدلالي: تسميات SemVer صريحة مثل 1.2.0 أو 2.0.0-beta.1 أو 1.4.2+build.7.
• حسب التاريخ: YYYY.MM.DD مع لاحقة رقمية عند نشر عدة إصدارات في اليوم نفسه، مثل 2026.08.02.2.

​

كيفية دمج الإعدادات المسبقة

• تملأ المعلمات الافتراضية الحقول الغائبة عن جسم الطلب فقط، ولا تستبدل القيم التي أرسلتها الجهة المستدعية.
• إذا احتوى الطلب على رسالة نظام، تُضاف مطالبة الإعداد المسبق قبلها. وإذا استخدم حقل system بأسلوب Anthropic، تُضاف المطالبة في ذلك الحقل.
• تُطبّق قوائم السماح والتجاهل للمزوّدين قبل اختيار المزوّد، فتضيّق مجموعة البدائل بدل أن تكون مجرد تسمية شكلية.
• تُرفض مبكرًا الطلبات التي تستخدم نموذجًا خارج قائمة النماذج المسموح بها بدل توجيهها بصمت إلى نموذج آخر.

​

النطاق العام الحالي للإعدادات المسبقة

• حقن مطالبة النظام
• قوائم النماذج المسموح بها
• قيود التوجيه عبر قوائم السماح أو التجاهل للمزوّدين
• قيم فك الترميز والتوليد الافتراضية
• قيم الاستدلال الافتراضية

​

إدارة الإعدادات المسبقة

​

متى تستخدم الإعدادات المسبقة

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

​

أدلة ذات صلة

• جمع الملاحظات حول الإعدادات المسبقة
• التوجيه والبدائل الاحتياطية
• معلمات الاستدلال
• مصفوفة تكافؤ الميزات