alawadi.cloudمستندات

اربط تطبيقك بالذكاء الاصطناعي

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

أي تطبيق تشغّله على alawadi.cloud يستطيع استدعاء نموذج الذكاء الاصطناعي دون إنشاء مفتاح أو لصقه يدوياً. نقرة واحدة في البوابة تحقن نقطة النهاية (endpoint) ومفتاحاً مخصّصاً في تطبيقك كمتغيّرات بيئة — وكودك يقرأها فقط.

ما الذي يُحقَن

ربط الذكاء الاصطناعي يضبط ثلاثة متغيّرات بيئة على تطبيقك: ALAWADI_AI_BASE_URL (نقطة النهاية المتوافقة مع OpenAI)، وALAWADI_AI_MODEL (معرّف النموذج الافتراضي)، وALAWADI_AI_API_KEY (مفتاح مخصّص لهذا التطبيق، يُسلَّم كسرّ (secret) — ولا يُطبَع أبداً).

الربط

افتح تطبيقك في البوابة، وابحث عن بطاقة ربط الذكاء الاصطناعي (Connect AI) في صفحة نظرته العامة.

اضغط ربط الذكاء الاصطناعي. ننشئ مفتاحاً مخصّصاً لهذا التطبيق، ونخزّنه كسرّ (secret)، ونحقن المتغيّرات الثلاثة ALAWADI_AI_*. يعيد تطبيقك التشغيل ليلتقطها.

اقرأ المتغيّرات في كودك. يمكنك فكّ الربط في أي وقت — فذلك يُبطل المفتاح ويزيل المتغيّرات.

استدعِ النموذج من تطبيقك

وجّه أي SDK من OpenAI إلى الـ Base URL والمفتاح المحقونَين. مثال بلغة Python:

import os
from openai import OpenAI

client = OpenAI(
    base_url=os.environ["ALAWADI_AI_BASE_URL"],
    api_key=os.environ["ALAWADI_AI_API_KEY"],
)

resp = client.chat.completions.create(
    model=os.environ["ALAWADI_AI_MODEL"],
    messages=[{"role": "user", "content": "مرحبا! عرّف عن نفسك بجملة واحدة."}],
)
print(resp.choices[0].message.content)

هي نفس الواجهة المتوافقة مع OpenAI التي تستخدمها بمفتاح شخصي — نفس النماذج، والبثّ (streaming)، واستدعاء الأدوات، والحدود، والفوترة لكل توكن. يُحتسب الاستهلاك على رصيدك وعلى أي حدّ إنفاق تضبطه.

وكلاء الذكاء الاصطناعي يديرون مفتاحهم الخاص

إذا كان التطبيق وكيل ذكاء اصطناعي، فلديه أصلاً مفتاح استدلال خاص به — أدِره من خلال الوكيل، لا من هذه البطاقة.

حدود الإنفاق

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

جرّبه أولاً في ساحة التجربة

لست متأكداً مما ستبني؟ في صفحة الذكاء الاصطناعي توجد ساحة التجربة (Playground) — لوحة محادثة تتحدّث إلى النموذج مباشرة في المتصفّح (اختر نموذجاً، اضبط تعليمة نظام (system prompt)، وابثّ الردّ). تُحتسب بنفس السعر لكل توكن، فتصلح أيضاً طريقةً سريعة لتقدير حجم تعليمة قبل أن تربطها بتطبيقك.

الخطوة التالية

في هذه الصفحة