وكلاء الذكاء الاصطناعي

وكيل الذكاء الاصطناعي (AI Agent) تطبيق صغير تبنيه في البوابة: تكتب دالة handle(request)، فنشغّلها لك كتطبيق، ويحصل على نقطة نهاية (endpoint) عامة على POST /invoke. يستطيع كودك أن يستدعي نموذج الـ GPU لدينا (يُحتسب لكل توكن، مثل واجهة الاستدلال) أو أن يستخدم مفتاح مزوّدك الخاص. تعدّل الكود وتعيد نشره من محرّر الكود (Cloud Editor) داخل البوابة — دون الحاجة إلى إعداد خط بناء (build pipeline).

أنشئ وكيلاً

نقطة النهاية العامة لوكيلك هي https://<name>-<id>.alawadi.cloud/invoke. تجد الرابط الدقيق في صفحة الوكيل داخل البوابة.

استدعِ وكيلك بأمان

أرسل جسم طلب بصيغة JSON — يُمرَّر إلى دالة handle(request) لديك — مع رمز الاستدعاء في ترويسة Authorization. يغلّف الردّ القيمة التي تُعيدها دالتك داخل حقل output.

export AGENT_INVOKE_TOKEN="ak-live-..."

curl https://my-agent-a1b2c3.alawadi.cloud/invoke \
  -H "Authorization: Bearer $AGENT_INVOKE_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"message": "مرحبا"}'
# → {"output": {"reply": "..."}}

import os
import httpx

resp = httpx.post(
    "https://my-agent-a1b2c3.alawadi.cloud/invoke",
    headers={"Authorization": f"Bearer {os.environ['AGENT_INVOKE_TOKEN']}"},
    json={"message": "مرحبا"},
)
print(resp.json()["output"])

الردود التي ينبغي أن تتعامل معها:

الوكلاء العامّون

إذا كان وكيلك مُعَدّاً ليستدعيه أي أحد — كروبوت محادثة عام على موقعك مثلاً — فيمكنك جعله عامّاً عند إنشائه. يخدم الوكيل العام /invoke دون رمز. يبقى بإمكانك إضافة حدود لكل استدعاء داخل كود دالتك. أبقِ الوكيل خاصّاً كلما كان يستهلك رصيدك أو يحمل مفتاح مزوّد.

أعِد إصدار الرمز

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

• في البوابة: افتح الوكيل ← إعادة إصدار رمز الاستدعاء ← انسخ الرمز الجديد.
• عبر الـ API: POST /v1/projects/{projectId}/agents/{agentId}/invoke-token/rotate.

يظهر الرمز الجديد مرة واحدة؛ خزّنه قبل أن تغلق النافذة.

عدّل كودك وانشره

يوجد مصدر الوكيل في محرّر الكود داخل البوابة. عدّل handler.py، واضغط نشر، فنطرح نسخة جديدة. كل عملية نشر هي نسخة جديدة يمكنك عرضها والتراجع عن النشر إليها — فالتغيير السيّئ يبعد نقرة واحدة عن التعافي.

• اعرض النسخ: GET /v1/projects/{projectId}/agents/{agentId}/revisions
• التراجع عن النشر: POST /v1/projects/{projectId}/agents/{agentId}/rollback مع {"revision": <n>}

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

• مرجع API وكلاء الذكاء الاصطناعي — كل نقطة نهاية، مع مخطّطاتها.
• نظرة عامة على الذكاء الاصطناعي — النموذج الذي يستدعيه وكيلك.
• الفوترة والاستخدام — كيف يُقاس استهلاك توكنات الوكيل.