كيف يعمل

افهم ما الذي تنجزه المنصة تلقائيًا، لتعرف ما الذي لا تحتاج إلى ضبطه. أرسل task؛ وتتولى المنصة التوجيه واستدعاء الأدوات وتسليم النتيجة.

التوجيه التلقائي: نقطة نهاية واحدة، مساران

عندما ترسل task إلى POST /v1/workspaces/{workspace_id}/agent/runs، تقرر المنصة أي مسار تناسب — ولا تختار نقطة النهاية بنفسك أبدًا:

مسار Chat — ردود سريعة نصية فقط. للأسئلة التي يستطيع النموذج الإجابة عليها مباشرة في دورة واحدة ("اشرح SEPA Instant"، "ترجم هذا"). سريع ومنخفض التكلفة.
مسار Agent — ذاتي، متعدد الخطوات، يستدعي الأدوات. للمهام التي تحتاج إلى بحث أو إنشاء ملفات أو تنفيذ كود أو متصفح ("قارن رسوم Wise و Airwallex وأخرج جدولًا"، "اقرأ قاعدة معارفي ولخّص سياسة الاسترداد").

يُعطي الموجِّه الأولوية للاستدلال التجريبي (تكلفة تكاد تكون صفرية، دون استدعاء LLM)، ولا يصعد إلا عندما تحتاج المهمة بوضوح إلى أدوات أو خطوات متعددة. إذا تبيّن أثناء رد chat أنه يحتاج إلى أدوات، فإنه يصعد تلقائيًا إلى مسار agent — دون تسليم ظاهر ودون إعادة محاولة من جانبك.

ترسل إلى نقطة نهاية واحدة في الحالتين. إن كانت مهمتك تعمل كـ chat سريع أم حلقة agent كاملة فهذا قرار المنصة لا قرارك. إن كنت بحاجة إلى رد chat نقي مضمون (دون أدوات، بأقل زمن استجابة)، فاستخدم POST …/chat مباشرة — راجع Chat.

الأدوات المدمجة: لا شيء للضبط

يحوي agent طقم أدوات كامل مدمج. يقرر أي الأدوات يستدعيها بحسب المهمة — ولا تختار أو تضبط أو تربط أي أدوات بنفسك. كلها متاحة افتراضيًا في كل تشغيل:

الفئة	الأدوات	يُستدعى تلقائيًا عندما
بحث الويب	`web_search`، `url_reader`، `advanced_scrape`، `document_read`، `ocr_extract`	تحتاج المهمة إلى معلومات ويب حية، أو قراءة صفحات، أو استخراج PDF/صور
قاعدة معارفك	`rag_search`، `spreadsheet_analyze`، `sql_query`	تشير المهمة إلى ملفات أو بيانات مرفوعة في مساحة عملك
مجموعات بيانات مفتوحة	`arxiv_search`، `sec_edgar`، `world_bank`، `oecd`، `financial_data`، `currency_convert`، `weather`، `rss_read`	تطلب المهمة بيانات مالية أو أكاديمية أو عامة منظمة
تنفيذ الكود	`python_exec`	تحتاج المهمة إلى حساب أو معالجة بيانات أو تحليل
المتصفح	`browser_navigate`، `browser_act`، `browser_extract`	تحتاج المهمة إلى زيارة موقع أو تسجيل دخول أو التفاعل مع صفحة
إنشاء الملفات	`create_pdf`، `create_docx`، `create_slides`، `create_markdown`، `create_webapp`	تطلب المهمة مستندًا مُسلَّمًا أو جدول بيانات أو عرضًا تقديميًا
الذاكرة	`remember`، `forget`	يحتاج agent إلى حفظ أو استدعاء حقيقة للتشغيلات المستقبلية
مساعدات الحساب	`calculator`، `convert`، `current_time`، `base64`، `random_choice`	تحتاج المهمة إلى حساب أو تحويل وحدات أو طابع زمني

كل ما سبق بدون ضبط — فهي جزء من المنصة ومتاحة في كل تشغيل لـ agent. يختار النموذج الأداة المناسبة للمهمة؛ وترى كل استدعاء أداة في الأحداث المتدفقة (tool_call ← tool_result).

الاستثناء الوحيد: الموصلات. تتطلب حسابات الأطراف الثالثة (Gmail و Slack و GitHub و Notion و Supabase و Datadog …) اتصالًا لمرة واحدة عبر OAuth أو مفتاح API في Settings ← Connectors. بمجرد وصلها، يستخدمها agent تلقائيًا أيضًا. راجع Connectors.

الإخراج التلقائي: تخطيط ← تنفيذ ← تسليم

تشغيل agent هو حلقة ذاتية التوجيه. لا تقوم بكتابة الخطوات نصيًا — بل يخطط لها agent:

التخطيط — يفكك النموذج المهمة إلى خطوات ("ابحث عن X أولًا، ثم اقرأ أعلى نتيجة، ثم لخّص").
التنفيذ — يستدعي الأدوات التي خطط لها، واحدة تلو الأخرى (أو بالتوازي عندما يكون ذلك آمنًا)، مع قراءة كل نتيجة قبل الخطوة التالية.
التحقق — يطابق مخرجاته مع المهمة ويعيد المحاولة إذا فشلت أداة أو كان الناتج ناقصًا.
التسليم — يستقر الجواب النهائي في final_text لحدث run_end؛ وتعود الملفات المنتجة كـ artifacts.

تُبَث كل خطوة في الوقت الفعلي عبر GET …/agent/runs/{run_id}/attach — فترى الاستدلال واستدعاءات الأدوات والجواب وهو يحدث. ويمكنك أيضًا جلب التشغيل المكتمل (بمسار خطواته الكامل) لاحقًا عبر GET …/agent/runs/{run_id}.

تحسينات اختيارية (غير مطلوبة)

الخط الأساسي — task دون معاملات إضافية — يمتلك بالفعل قدرة أدوات كاملة وتوجيهًا ذكيًا. وما يلي مجرد تحسينات اختيارية بحتة:

Skills — كتيبات سير عمل قابلة لإعادة الاستخدام. أدمج واحدًا لتوجيه كيفية تعامل agent مع المهمة (مثل كتيب "تحليل تنافسي"). لا تُرفق أبدًا تلقائيًا؛ اخترها صراحة.
أدوار المتخصصين — هوية مجالية (محامٍ، محلل بيانات، حامي العلامة). تحدد من يكون agent في ذلك التشغيل. واحد كحد أقصى.
Projects — تعليمات دائمة + معرفة مرفوعة، مُجمَّعة كسياق قابل لإعادة الاستخدام. اربط التشغيل بمشروع ليجذب من مجالك.
Memory — الاسترجاع طويل الأمد لمساحة العمل. احفظ الحقائق مرة واحدة؛ يستدعيها agent تلقائيًا في التشغيلات المستقبلية ذات الصلة.
وضع **pro** — يفتح استدلالًا أعمق ومتعدد الخيوط (وكلاء فرعيون متوازون) للمهام المعقدة. علامة منطقية على متن التشغيل.

لا شيء من هذه ضروري للدمج. ابدأ بـ {"task": "…"} فقط، وأضف التحسينات فقط عندما تنشأ حاجة محددة. يعرض Cookbook كل تحسين قيد التنفيذ.