Docsتدفق العمل في مجال البناءتشكيلة Agents

دليل المفاوضة

Presets, model selection, tool set, max iterations, and system prompt overrides for readable, maintainable LLM sessions.

عميل يلف "دورة واحدة للحركة المحلية + الأدوات التي يمكن استخدامها + سياسة تشغيلها" في (برايدرون) لن تحتاج أبداً لكتابة نظام بسرعة - اختيار مُسبق، و، إذا لزم الأمر، تخطي بعض الحقول.

الإعداد المسبق: حدد خطًا أساسيًا بناءً على المشهد

المُسبق هو نموذج للعميل المُبني الذي يُجمع النموذج، مجموعة أدوات التقصير، نظام سريع، ويُديرُ السياسةَ سوية، مُسمّى بقضيّة الاستخدام. هناك 19 مفترساً مبنية اليوم:

preset	التصنيف	الأفضل
`universal`	العالمية	The all-around default: comes with the full tool set — sub-Agents, skills, knowledge memory, data transforms, and more. عندما يكون الشك، اختيار هذا.
`universal_reasoning`	العالمية	The reasoning version of universal; keeps visible reasoning steps at run time, good for complex analysis.
`lightweight`	العالمية	سياسة حدها الأدنى منفردة بأدوات القصف والملفات فقط، جيدة للمهام البسيطة والمنافذ المنخفضة.
`chat`	الحوار	محادثة متعددة الاتجاه مع الحفاظ على السياق، جيدة للمهام الحوارية.
`coder`	الرمز	:: تحليل الرموز، والتوليد، والتكييف، والاختبارات، بأدوات القذف/الرسم/الانفاذ الرمزي.
`devops`	الرمز	مهام النظام والعمليات: مخطوطات القصف، وغيت، وعمليات قاعدة البيانات، والتشغيل الآلي للنشر.
`researcher`	البحوث	البحث والتصفح والتوليف المتعدد المصادر؛ ويمكن لنتائج البحوث أن تستقر في الذاكرة المعرفية عبر عمليات تنفيذ.
`data_analyst`	البيانات	CSV processing, SQL queries, code execution, and format conversion, producing analysis conclusions.
`web_scraper`	البيانات	Structured data extraction combining browser functioning, HTTP scraping, and OCR.
`marketing`	التسويق	(ج) بحوث السوق، وتحليلات المعاينة، ورؤى الجمهور، والتوصيات المثلى.
`communication`	الاتصال	Sending and receiving email (SMTP / IMAP) and composing and sending IM messages across platforms.
`writer`	كتابة	وتنتج المقالات، وكتابة النسخ، وكتابة الأعمال التجارية، وثائق جيدة الأداء مباشرة.
`word_document`	Docs	أخصائي الكلمات: إعداد وتحرير التقارير، والكتيبات، وملفات المدوّنات المقترحة.
`excel_workbook`	Docs	اختصاصي الإكسل: نمذجة الكشوفات، ولوحات الدبابيس، والتقارير التي تحركها المعادلة.
`powerpoint_presentation`	Docs	BroPoint slips: training materials,play decks, and reporting presentations.
`office_document`	Docs	مكتب مختلط يوثق المهام عبر الورد، إكسل، وباوربوينت.
`pdf_processor`	Docs	PDF parsing, content extraction, format conversion, and OCR.
`multimedia_creator`	الوسائط المتعددة	AI image / audio generation and image processing.
`computer_operator`	التشغيل الآلي	:: التشغيل الآلي المتعدد الخطوات الذي يربط معا مراقبة المصفوفين، والقصف، والملفات، وقواعد البيانات.

حدود الخطة

فالخطة الحرة لا يمكن أن تستخدم إلا الأوسمة العالمية، والوزن الخفيف، والثرثرة المسبقة؛ والباقي يتطلب برو أو أعلى.

القائمة المسبقة تعكس حالتك

عند تشكيل وكيل في محرر سير العمل، اختيار "نموذج البداية" لمسح القائمة الكاملة حسب الفئة مع وصف لكل مجموعة مسبقة؛ ويمكن أيضاً للمرشحين أن يسجلوا المخطوطات العرفية التي تتجاوز تلك القائمة.

الحد الأدنى من الإعلان

yaml

agents:
  analyst:
    preset: universal

هذا كل ما يتطلبه الأمر، النموذج، الأدوات، النظام يتراجع كلّه إلى التخلف عن الدفع.

تجاوز: تجاوز الطلب

yaml

agents:
  analyst:
    preset: universal
    overrides:
      system_prompt: |
        你是公司的风控分析师。所有输出用中文。
      llm_config:
        models:
          - model: anthropic/claude-sonnet-4-20250514
            provider: openrouter
        temperature: 0.2
      tool_set:
        - file_system
        - web
        - data_transform

مجال التجاوزات شائع الاستخدام

system_prompt — يُستبدل نظام البلازما الجاهز (غير مُذيع).
llm_config — تشكيلة نموذجية: قائمة النماذج (كل مدخل نموذجي + مقدم) والتراجع ودرجة الحرارة. كل عميل في سير العمل يمكنه استخدام نموذج مختلف.
tool_set — A list of tool-set names that replaces the preset default wholesale (no merge).
max_iterations — كبسولة صلبة على جولات Agent الداخلية "فكري بأدوات الاتصال" المفترسات المدمجة وضعت هذا بسخاء.
strategy — just_work_parallel（التخلف عن الدفع بالنسبة لمعظم المفترسات）/ just_work_parallel_reasoning（يبقي خطوات التفكير الواضحة）/ single_run（الناتج المباشر غير المباشر؛ المستخدم بالوزن الخفيف）。
mcp_servers — أسجل سيرفر خارجي، دمج الأدوات التي يكشفها في مجموعة أدوات هذا Agent.
retry_max_attempts / retry_initial_delay / retry_max_delay — The backoff-and-retry policy for failed LLM calls.

التجاوزات كبيرة

تدمج الأجسام المحبة في الميدان، في حين تُستعاض عن الأسلاك والقوائم بالجملة. إذاً، الإفراط في الإطاحة فقط لن يسقط التمرين عارضات ما قبل الزواج، لكن بمجرد ظهور الأداة،.

قابلة لإعادة الاستخدام: الوكيل المرجعي في الخطوة

yaml

agents:
  analyst: { preset: universal }
  writer:  { preset: writer }

steps:
  - step: plan
    agent: analyst
    input: "拆解下面这个目标为 3~5 个可执行任务：..."

  - step: write
    agent: writer
    input: "把下面的计划改写成给客户的邮件：{{steps.plan.output}}"
    depends_on: [plan]

نفس Agent يمكن الرجوع إليه بخطوات متعددة وتفتح كل خطوة دورة جديدة - الذاكرة لا تحمل أبدا. To pass data between steps, use template variables to reference upstream output; to keep context across rounds, use state machine or group chat.

مجموعة الأدوات (tool_set)

أدوات البناء مجمّعة بالاسم المشتركة هي:

file_system — اقرأ واكتب الملفات في دليل العمل.
shell — أدير أوامر القصف.
web — HTTP requests, web scraping, and search.
browser — أتمتة الحشد: صفحات دينامية، أشكال، شاشات.
code_execution — اجري قنابل شفرة.
csv · database · data_transform — CSV tables, SQL databases, and JSON/YAML/XML format conversion.
email · im — Sending and receiving email, and IM Messaging (Slack, Telegram, DingTalk, WeCom, Feishu, and more).
word · excel · powerpoint · pdf · ocr — إعداد الوثائق وربطها.
image_processing · multimedia — تجهيز الصور وصورة AI.
git — عمليات التحكم بالخطأ.
knowledge_memory — الذاكرة المعرفية التي تستمر في عمليات تنفيذ.
sub_agent — -أجساد فرعية لكسر مهمة.
skill_tools — اسحب واحتج بالمهارات.

كلّ سفن تعريف مُسبقة مع أداة مُقَوَّلة، فوق ذلك، أيّ وكيل يُمْكِنُ أَنْ يَسْحبَ في الأدواتِ المُعرّضةِ مِن قِبَل خادمِ مِنْ خلال حَرْقَةِ مِنْقَصِ.

أقل هو أكثر

كلما كانت مجموعة الأدوات أكبر، زادت مساحة اتخاذ القرار لدى الوكيل، ولكن أصبح من الأسهل الانحياز للأدوات الثانوية. في ممارسة الإنتاج، إذا قمت بقص مجموعة الأدوات إلى تلك التي "تم استخدامها بالفعل في هذه الخطوة"، فسيزداد معدل النجاح والسرعة.

توصيات اختيار النموذج

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

All models are BYOK: 15+ providers are supported (OpenAI, Anthropic, Google, DeepSeek, Kimi, MiniMax, Zhipu, xAI, Mistral, Qwen, and more, plus local Ollama / LM Studio). و أوراق الاعتماد مخزنة مع AES-256-GCM. (كلود برو) و (تشات جي تي) يمكن أن يتواصل أيضاً عبر لوج، لذا ليس مطلوباً جداً.

FAQ

إذا أعادت عدة خطوات استخدام نفس الوكيل، فكيف يتم حساب الحصة؟

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

ماذا علي أن أفعل إذا كانت هناك حلقة لا نهائية في الوكيل؟

التثبيتات القصوى هي قبعة صلبة والهرب مجبر على التوقف عندما تصل عندما تضطرب، تبدأ مع كل جولة من مجموعات الأدوات في جدول التنفيذ؛ على برو وما فوق يمكنك أيضا استخدام حفار نقطة الانفصال للتوقف والتفتيش داخل خطوة.

أريد إضافة أداتي الخاصة؟

ونحن نوصي بتغليفها كخادم لجهاز إم بي سي وسحبها من خلال الثقوب الخزانية - لا حاجة لتغييرات منصة. انظر وحدة بناء مكتبة مع وثائق مساعد الذكاء الاصطناعي في الفصل MCP.