إضافة الكشف
حدّد نطاق مراجعة نصوص الذكاء الاصطناعي أو حماية الأوامر عبر OpenDetector، بعقد كشف منفصل وسياسة تشغيل واضحة.
التخطيط للوصول إلى الكشفAgent API وGrid / المطورون
ابنِ وكيلك الأول.
ابدأ بمهمة واحدة محددة النطاق.
اطلب الوصول إلى Agent API، وأكد وكيلاً مفعّلاً، وشغّل مهمة اصطناعية بميزانية صريحة. تتوفر أمثلة واجهة API لنماذج Grid أدناه.
الوصول إلى Agent API وGrid متاح بدعوة. يحدد حسابك الخدمات المفعّلة والأسعار الفعلية.
Agent API / التشغيل الأول
فوّض، وافحص، ثم راجع.
استخدم مصدر API ومفتاح Bearer ومعرّف الوكيل المفعّل المؤكدة أثناء التهيئة. أكد أدواته وسياسة الاعتماد الخاصة به قبل إرسال طلب. يستخدم المثال مدخلات اصطناعية وميزانية توضيحية.
- اضبط
FORWARD_AGENT_BASEعلى المصدر المزوّد، دون شرطة مائلة في النهاية. واحتفظ بـFORWARD_AGENT_KEYفي خادمك أو بيئتك المحلية. - أنشئ
first-agent.jsonباستخدام معرّف الوكيل المفعّل لديك، مع هدف وميزانية كما هو موضح في الدليل. شغّله من مجلد خاص باستخدامumask 077. - يُرجع التفويض الناجح رمز الحالة HTTP 202. اقرأ
run_idوstatusمنrun.json. حافظ على خصوصية الرموز المُرجعة. - افحص
GET /v1/agent/runs/{run_id}باستخدام التفويض ذاته. راجع الاكتمال والمخرجات والاستخدام قبل توسيع النطاق.
تفويض تشغيل وكيل
curl --fail-with-body --silent --show-error \
-X POST "${FORWARD_AGENT_BASE}/v1/agent/delegate" \
-H "Authorization: Bearer ${FORWARD_AGENT_KEY}" \
-H "Content-Type: application/json" \
--data-binary @first-agent.json \
--output run.jsonقالب توضيحي فقط. يتحكم حسابك في التوافر والأسعار الفعلية. قد يستهلك إرسال الطلب رصيد الاستخدام؛ والميزانية ليست تقديراً لتكلفة النتيجة.
03 / الاستدعاء الأول
اختر عميلك البرمجي (Client).
احتفظ بنقطة النهاية ذاتها.
تقرأ الأمثلة المفتاح ومعرّف النموذج من بيئتك. وترسل رسالة محادثة واحدة وتطبع الرد.
قبل التشغيل
استخدم حساباً مدعواً، FORLEX_API_KEY وواجهة تدعم المحادثة GRID_MODEL_ID من قائمة النماذج المفعّلة لديك.
- عنوان API الأساسي
- https://api.genai.forlex.cloud/v1
- طلب
- POST /chat/completions
يؤكد الطلب الناجح صلاحية الوصول. ويحدد تقييمك ما إذا كان النموذج ملائماً لسير العمل.
التخطيط للتقييمثبّت حزمة SDK: python3 -m pip install openai. احفظ المثال باسم first-call.py، ثم شغّل python3 first-call.py.
first-call.py
import os
from openai import OpenAI
client = OpenAI(
base_url="https://api.genai.forlex.cloud/v1",
api_key=os.environ["FORLEX_API_KEY"],
)
response = client.chat.completions.create(
model=os.environ["GRID_MODEL_ID"],
messages=[{"role": "user", "content": "Hello!"}],
)
print(response.choices[0].message.content)الوصول والإعداد
إعداد حسابك ونموذجك.
تتوفر Grid بدعوة. احتفظ بمفتاحك في بيئتك المحلية أو تكوين الخادم، خارج كود المتصفح وأنظمة التحكم في المصدر. تستخدم الأمثلة قيماً نائبة (Placeholders).
01 / الوصول والمفتاح
بمجرد دعوتك، افتح Console، وانتقل إلى Keys، وأنشئ مفتاح API.
تعيين مفتاح API الخاص بك
تعيين مفتاح API الخاص بك
export FORLEX_API_KEY="replace-with-your-key"02 / النموذج المفعّل
اضبط FORLEX_API_KEY أولاً. اختر نموذجاً يدعم إكمالات المحادثة من قائمة حسابك واستخدم معرّفه الدقيق.
سرد واختيار نموذج مفعّل
استبدل كلتا القيمتين النائبتين قبل تشغيل الاستدعاء الأول.
سرد النماذج المفعّلة
curl https://api.genai.forlex.cloud/v1/models \
-H "Authorization: Bearer ${FORLEX_API_KEY:?Set FORLEX_API_KEY first}"اختيار نموذج مفعّل
export GRID_MODEL_ID="replace-with-an-enabled-chat-model-id"04 / التحضير للإنتاج
افهم الاستجابة. وراجع التكلفة.
أضف معالجة الأخطاء، وقِس النتائج المفيدة، وتحقق من الاستهلاك في Console. أكد متطلبات البيانات والنشر والتشغيل مع المسؤولين عن اعتماد الإنتاج.
استكشاف أخطاء الاستجابة وإصلاحها
- 401 / 403
- تحقق من المفتاح والدعوة وصلاحية وصول الحساب. قائمة النماذج المفعّلة خاصة بحسابك.
- الوصول والمفاتيح
- 402 / 429
- راجع الفوترة أو حدود الطلبات. استخدم التراجع التدريجي (Backoff) لحدود المعدل؛ وعالج الفوترة قبل إعادة المحاولة.
- الفوترة والحدود
- 503
- قد يكون مسار Serverless الخامل قيد التهيئة. اتبع ترويسة Retry-After عند وجودها واستخدم عمليات إعادة محاولة محدودة.
- الأخطاء والبدء البارد (Cold start)
اتخذ الخطوة التالية مع فريقك.
ربط أداة البرمجة لديك
أعدّ تكويناً خاصاً بالأداة، ثم قيّم نموذجاً مثبّتاً على مهام برمجية محددة النطاق مع فريقك.
إعداد تكوين Connectتكييف نموذج
حدّد المهمة وجاهزية البيانات والتقييم قبل اختيار نقطة حفظ أو طريقة تدريب.
استكشاف التدريبتسليم سير عمل
أحضر العملية والتكاملات. نحدد نطاق التقييم والتنفيذ مع فريقك.
استكشاف المشاريع