افتح Agents
سجّل الدخول إلى التطبيق وافتح قسم Agents من مبدّل المنتجات.
وثائق Agents
Amargi Agents
Amargi Agents هي بيئة تشغيل وكلاء الذكاء الاصطناعي: عرّف وكيلاً، وامنحه أدوات، واستدعِه من أي منتج في Amargi أو من أنظمتك الخاصة، وراقب كل تشغيل بتتبّع كامل للرموز والتكلفة واستدعاءات الأدوات.
نظرة عامة
Amargi Agents هي بيئة تشغيل وكلاء ذكاء اصطناعي متعددة المستأجرين. تُعرّف وكيلاً بدور Role وموجّه نظام System prompt وقائمة أدوات Tools، ثم تستدعيه من أي مكان: الردود الآلية في Reach، اقتراحات الذكاء الاصطناعي في Escalate، أو أنظمتك الخاصة عبر API. كل تشغيل Run يُلتقَط بكل تفاصيله: استدعاءات النموذج، رموز الإدخال والإخراج، التكلفة بالدولار، الزمن، استدعاءات الأدوات مع إدخالاتها وإخراجاتها، والقرار النهائي.
نُشغّل Anthropic Claude افتراضياً، وهي مُلزَمة تعاقدياً بعدم تدريب نماذجها على مطالبات العملاء أو ردودهم. تستطيع الفِرَق المؤسسية توصيل مفاتيح API الخاصة بها أو الاستضافة الذاتية.
بدء سريع
افتح التطبيق وأنشئ أول وكيل في خمس خطوات.
وكيل جديد
اضغط وكيل جديد. أدخل الاسم، والدور (مثلاً Support Classifier)، وموجّه النظام.
أرفق أدوات
اختر من مكتبة الأدوات الجاهزة (lookup_order، send_email، query_kb) أو سجّل أدوات مخصّصة عبر مانيفست القدرات.
اختبر في ساحة التجربة
أدخل رسالة وشاهد التشغيل يتدفّق في الوقت الفعلي مع كل استدعاء أداة وخطوة استدلال.
اقرنه بمحفّز
استمع لرسائل Reach الواردة، أو استدعِه من Escalate عند فتح تذكرة، أو استدعِه من API الخاص بك.
مفاهيم رئيسية
الوكيل Agent
تعريف ثابت يحدّد كيف يتصرّف الوكيل عند استدعائه. يحتوي على: الاسم، الدور Role، موجّه النظام System prompt، قائمة الأدوات المسموحة، نموذج LLM (claude-sonnet-4 وغيره)، حدود التكلفة، والحد الأقصى للدورات لمنع الحلقات.
الأداة Tool
دالّة يمكن للوكيل استدعاؤها، مُعرّفة بـ schema JSON (الاسم، الوصف، الإدخالات، الإخراجات). الأدوات إما داخلية يديرها Amargi مثل query_kb، أو مخصّصة تُسجّل فيها نقطة نهاية HTTPS يستدعيها وقت تشغيل Agents عند الحاجة.
التشغيل Run
استدعاء واحد للوكيل. يحتوي السجل على: المُدخَل، كل دورة turn من حلقة النموذج (الاستدلال، استدعاءات الأدوات، الردود)، الإخراج النهائي، رموز الإدخال والإخراج، التكلفة بالدولار، الزمن. كل run يكتب صفاً في escalate.agent_runs.
مانيفست القدرات
وثيقة JSON قابلة للتسجيل تصف أداة مخصّصة: الاسم، الوصف، schema الإدخالات، schema الإخراجات، وعنوان URL للاستدعاء (HTTPS، يجب أن يُوقَّع بـ HMAC). يتيح للفِرَق إضافة أدوات داخلية (lookup_account، charge_card وغيرها) إلى مكتبة أدوات مؤسستهم دون كتابة كود.
سلاسل الموافقة
بالنسبة للأدوات عالية المخاطر (تحويل أموال، حذف بيانات، إرسال إلى عميل خارجي)، عيّن سياسة تتطلّب موافقة بشرية. عندما يحاول الوكيل استدعاء تلك الأداة يتوقّف التشغيل، وتُنشأ مهمة لمراجِع بشري، ويكمل التشغيل بعد الموافقة أو يفشل إن رُفض. كل موافقة مُسجّلة.
مهام شائعة
إنشاء وكيل مُصنّف
- Agents، ثم وكيل جديد.
- الدور: Support Classifier.
- موجّه النظام: صنّف رسالة الدعم الواردة إلى billing | shipping | bug | general.
- الأدوات: لا شيء، فالإخراج الخالص يكفي.
- النموذج: claude-haiku-4، للسرعة والتكلفة.
- احفظ، ثم اختبر في ساحة التجربة.
تسجيل أداة مخصّصة
- اكتب مانيفست JSON يصف الأداة (الاسم، الإدخالات، الإخراجات، عنوان URL).
- Tools، ثم Register manifest، والصق الـ JSON.
- يولّد Agents سرّاً HMAC. خادم الأداة الخاص بك يجب أن يتحقّق من الرأس X-Agents-Signature.
- استخدم الأداة في تعريف أي وكيل.
استدعاء وكيل من API
- احصل على مفتاح API من Amargi Workspace (Settings، ثم API Keys).
- أرسل POST إلى /api/v1/agents/:id/runs بالحمولة JSON { "input": "...رسالة المستخدم..." }.
- الرد يحتوي على run_id للاستفسار اللاحق والإخراج النهائي.
مراقبة التكاليف
كل تشغيل يُسجّل التكلفة بالدولار في خانة cost_usd، وتُجمّع تلقائياً لكل يوم ولكل وكيل في بطاقة Agent activity على صفحة Reports. أنشئ تنبيهات على عتبة التكلفة الشهرية في Settings، ثم AI Cost Quota.
مرجع API
كل نقاط نهاية Agents تحت عنوان القاعدة أدناه.
https://agents.amargicreative.com/api/v1/| GET | /agents | سرد الوكلاء. |
| POST | /agents | إنشاء وكيل جديد. |
| GET | /agents/:id | استرجاع وكيل. |
| POST | /agents/:id/runs | استدعاء وكيل (synchronous). |
| POST | /agents/:id/runs/async | استدعاء وكيل (asynchronous، يعيد run_id فوراً). |
| GET | /runs/:id | استرجاع تشغيل بالتفاصيل الكاملة. |
| GET | /runs | سرد التشغيلات. تصفية حسب agent_id، from، to، agent_role. |
| GET | /runs/summary | ملخّص مجمّع (تشغيلات لكل يوم، التكلفة، الرموز). |
| POST | /tools | تسجيل أداة مخصّصة عبر مانيفست. |
| GET | /tools | سرد الأدوات (مدمجة ومخصّصة). |
| POST | /approvals/:id/approve | الموافقة على تشغيل مُعلَّق. |
التكامل مع المنتجات الأخرى
Reach
الردود الآلية للذكاء الاصطناعي تستدعي وكلاء عند وصول رسالة WhatsApp. يظهر التشغيل في سجل المحادثة ولوحة المُشغّل.
Escalate
يستدعي وكلاء على حدث ticket.opened لاقتراح حل، يظهر للمشغّل كرسالة AI suggestion قابلة للقبول أو الرفض.
أنظمتك
استدعِ من أي خادم خلفي عبر API. مفيد لتلخيص تذكرة، أو تصنيف بريد، أو أي مهمة تستفيد من LLM.
الحصول على المساعدة
دعم البريد الإلكتروني: contact@amargicreative.com. تواصل معنا في أي وقت وسنوجّهك إلى الدليل المناسب.
موقف الخصوصية (تدريب Anthropic، احتفاظ التشغيل): موقف الخصوصية
استكشف بقية المنصة
جاهز لتشغيل وكيل؟
أخبِرنا بما تريد أتمتته وسنريك كيف يناسبك Agents. أو اطلب الوصول ونجهّزك.