AI-translated from English; not yet reviewed by a fluent editor.

# أنشئ سير عمل من Claude لمراجعة المستندات بالتوازي

> يمكن لنسخة Managed Agents التجريبية من Anthropic تحويل مراجعة المستندات إلى سير عمل متعدد المراحل. يوضح هذا الدليل كيفية إعداد عملية تشغيل، وفحص أحداثها ومخرجاتها، ومراعاة التكلفة والقيود.

By BIG CHANGE Editorial

Published: 2026-10-09T20:34:58.333Z
Updated: 2026-10-09T20:34:58.333Z
Canonical: https://bigchange.ai/blog/claude-managed-agents-parallel-document-review-guide

![One reader sits at a laptop with text on screen; a page with faint text lines lies on the table beside it.](https://bigchange.ai/api/media/file/claude-managed-agents-document-review-hero-v1.png)
Conceptual illustration of a reader manually checking a proposed document-review report. It is not a Claude product screenshot or a BIG CHANGE hands-on test. AI-generated illustration by BIG CHANGE.

أصبح Claude Managed Agents قادرًا على كتابة برنامج لسير عمل يوزّع أجزاء المهمة الكبيرة على عدة وكلاء، ويجمع نتائجهم ويدمجها. ما تزال الميزة في الإصدار التجريبي. إليك إعدادًا موثقًا لمطوّر برمجيات يريد مراجعة مجلد من المستندات وإنشاء ملف بنتائج جرى التحقق منها.

يستخدم هذا واجهة Claude Platform API وأداة CLI من Anthropic. راجعت BIG CHANGE الوثائق الحالية؛ ولم نشغّل الإعداد أو نختبر سير عمل.

## ما الذي يفعله سير العمل

سير عمل [ديناميكي](https://platform.claude.com/docs/en/managed-agents/workflow-runs) هو برنامج واحد لتشغيل واحد. يمكنه تقسيم العمل إلى مراحل، وبدء سلاسل الوكلاء بالتوازي، وتمرير نتائجها بين المراحل، وإعادة محاولة فرع فاشل أو معالجته، ودمج النتائج. فمثلًا، قد تفحص المرحلة الأولى ملفات منفصلة، ثم توفّق مرحلة لاحقة بين النتائج. يبدأ الوكيل الأساسي التشغيل؛ وينفذه الخادم في الخلفية.

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

## قبل أن تبدأ

تحتاج إلى حساب Claude Console ومفتاح API وإمكانية الوصول إلى Claude Managed Agents، الذي تقول Anthropic إنه مفعّل افتراضيًا لحسابات API. تتطلب نقاط نهاية الوكيل وسير العمل ترويسة `managed-agents-2026-04-01` التجريبية. تضبط حزمة Anthropic SDK هذه الترويسة تلقائيًا؛ أما عند استدعاء API دون SDK فأضفها بنفسك.

ما تزال الوثائق الحالية تصنّف Managed Agents على أنه [تجريبي](https://platform.claude.com/docs/en/managed-agents/overview). وتؤرخ [ملاحظات إصدار](https://platform.claude.com/docs/en/release-notes/overview) Anthropic بدء النسخة التجريبية العامة في 9 أبريل 2026، وتنسيق الوكلاء المتعددين في 11 مايو، وسير العمل الديناميكي في 9 أكتوبر. كما أن سير العمل الديناميكي تجريبي. والتاريخ مهم: رقم «1,000 وكيل» هو حد حالي لكل تشغيل لسير العمل، وليس قدرة جديدة على إطلاق 1,000 وكيل في الوقت نفسه.

تخزّن المنصة سجل محادثات الجلسة وحالة بيئة العزل والمخرجات على الخادم. وتقول Anthropic إن Managed Agents غير مشمول حاليًا في [Zero Data Retention أو تغطية اتفاقية HIPAA Business Associate Agreement](https://platform.claude.com/docs/en/managed-agents/overview). لا تضع مواد خاضعة للوائح أو سرية في جلسة ما لم تؤكد مؤسستك قواعد البيانات والإعدادات المنطبقة.

## 1. ثبّت CLI وSDK

ثبّت `ant` CLI من Anthropic بالطريقة المناسبة لنظام التشغيل لديك، كما يوضح [دليل البدء السريع لـ Managed Agents](https://platform.claude.com/docs/en/managed-agents/quickstart). على سبيل المثال، الأمر الموثق لنظام macOS هو:

```sh
brew install anthropics/tap/ant
```

في Python، ثبّت SDK ومرّر مفتاح API عبر البيئة بدلًا من وضعه في ملف المصدر:

```sh
pip install anthropic
export ANTHROPIC_API_KEY="your-api-key"
```

المفتاح أعلاه عنصر نائب. احتفظ بالقيمة الحقيقية في مدير الأسرار المعتاد أو في إعداد بيئة محمي.

## 2. عرّف وكيلًا يمكنه استخدام مسارات العمل

أنشئ `document-reviewer.md`. تفعّل كتلة `multiagent` نوع سير العمل الذي أُضيف في أكتوبر. ويجعل تعطيل الوكلاء الفرعيين مسار التفويض صريحًا: يستخدم هذا الوكيل سير العمل الديناميكي بدلًا من تفويض لمرة واحدة إلى وكيل فرعي.

```yaml
---
name: document-reviewer
model: claude-sonnet-5-5
tools:
  - type: agent_toolset_20260401
multiagent:
  type: multiagent_20261001
  subagents:
    type: disabled
  workflows:
    type: enabled
---

You review documents for a user-defined checklist.

When a request contains more than 20 independent files, use a dynamic workflow.
Make one phase that checks the files independently and a later phase that
reconciles duplicate findings. Do not infer missing facts. Save the final
machine-readable results to report.json and a concise explanation to summary.md.
Include the source filename and a short evidence excerpt for every finding.
If a file cannot be read or a worker fails, record that file as unresolved;
do not silently omit it. The final response must report the number of files
reviewed, unresolved files, and whether every output file was written.
```

العتبة وتعليمات المراجعة خيارات ضمن سياستك، وليستا إعدادات افتراضية من Anthropic. عدّلهما وفقًا للعمل وتكلفة الأخطاء. `claude-sonnet-5-5` معرّف نموذج كمثال؛ اختر نموذجًا متاحًا حاليًا لحسابك وضمن ميزانيتك.

أنشئ الوكيل واحتفظ بالمعرّف الذي يعيده:

```sh
ant apply document-reviewer.md
```

تعرض CLI معرّف الوكيل وتسجله في `claude-lock.json`. يفصل Managed Agents تعريف الوكيل القابل لإعادة الاستخدام (النموذج والتعليمات والأدوات) عن البيئة التي تعمل فيها الجلسة.

## 3. أعدّ بيئة العزل

تحدد البيئة مكان تشغيل الجلسات: في بيئة عزل سحابية تديرها Anthropic أو بيئة عزل مستضافة ذاتيًا على بنيتك التحتية. يستخدم المثال السحابي في دليل البدء السريع شبكة مقيّدة ويسمح بمديري الحزم:

```yaml
# environment.yaml
name: document-review
config:
  type: cloud
  networking:
    type: limited
    allow_package_managers: true
```

طبّقها باستخدام `ant apply environment.yaml`؛ ويُحفظ معرّفها أيضًا في `claude-lock.json`. إذا احتاج الوكيل إلى اتصال بالشبكة، فأدرج المضيفين المطلوبين فقط في `allowed_hosts`. عند تقييد الشبكة، تقيد قائمة المضيفين هذه أيضًا أدوات البحث والجلب على الويب في Managed Agents. ولا يضيف الإعداد الذي يسمح بمديري الحزم مواقع ويب إلى قائمة السماح.

في أول تشغيل، استخدم مجلدًا صغيرًا غير حساس والأدوات التي يحتاج إليها فقط. تتضمن مجموعة أدوات الوكيل المدمجة عمليات shell والملفات؛ وقد تؤدي إضافة أدوات إلى توسيع ما يستطيع الوكيل فعله. راجع سياسة الأذونات الموثقة وضوابط بيئة العزل قبل منح الوصول إلى أنظمة خارجية أو بيانات اعتماد.

## 4. ابدأ جلسة وأرسل مهمة محددة النطاق

استخدم معرّفي الوكيل والبيئة لإنشاء جلسة باستخدام Python SDK:

```python
import anthropic

client = anthropic.Anthropic()
session = client.beta.sessions.create(
    agent="AGENT_ID_FROM_CLAUDE_LOCK",
    environment_id="ENVIRONMENT_ID_FROM_CLAUDE_LOCK",
    title="Small document review",
)
print(session.id)
```

استبدل عنصري ID النائبين بالقيم الموجودة في `claude-lock.json`. ثم أرسل مهمة واضحة عبر تدفق أحداث الجلسة. ابدأ التدفق قبل إرسال الحدث حتى تتمكن من رؤية التشغيل وتقدمه فور حدوثهما:

```python
with client.beta.sessions.events.stream(session.id) as stream:
    client.beta.sessions.events.send(
        session.id,
        events=[{
            "type": "user.message",
            "content": [{
                "type": "text",
                "text": (
                    "Review each Markdown file in /review-set for a missing "
                    "owner, deadline, or acceptance criterion. Quote evidence; "
                    "do not infer missing details. Reconcile duplicate findings "
                    "and write /mnt/session/outputs/report.json plus "
                    "/mnt/session/outputs/summary.md. In report.json, use "
                    "a files array with one record per input: path, status "
                    "(reviewed or unresolved), and findings; each finding has "
                    "a check, evidence excerpt, and source location. Include "
                    "input, reviewed, and unresolved counts."
                ),
            }],
        }],
    )
    open_runs = {}
    run_results = {}
    for event in stream:
        if event.type == "workflow_run.created":
            open_runs[event.workflow_run_id] = event.name
            print(f"Run started: {event.name}")
        elif event.type == "workflow_run.status_ended":
            run_results[event.workflow_run_id] = event.result.type
            open_runs.pop(event.workflow_run_id, None)
            print(f"Run ended: {event.result.type}")
        elif event.type == "workflow_run.error":
            print(f"Run error: {event.error}")
        elif event.type == "agent.message":
            for block in event.content:
                if block.type == "text":
                    print(block.text)
        elif event.type == "session.status_idle":
            if event.stop_reason.type == "end_turn" and not open_runs:
                break

    # Inspect the child threads associated with completed workflow runs.
    for thread in client.beta.sessions.threads.list(session.id):
        if thread.workflow_run_id in run_results:
            print(f"Thread {thread.id}: {thread.status}")
            for thread_event in client.beta.sessions.threads.events.list(
                thread.id, session_id=session.id
            ):
                if thread_event.type == "session.error":
                    print(f"Thread error: {thread_event}")
```

يفترض هذا المثال أن طريقة إدخال الجلسة التي أعددتها تتيح الملفات عند `/review-set`. ضع الملفات في بيئة عزل الجلسة باستخدام طريقة الإدخال الموثقة قبل مطالبة الوكيل بمراجعتها. اطلب من الوكيل كتابة المخرجات ضمن `/mnt/session/outputs/`؛ وتشرح [وثائق ملفات Managed Agents](https://platform.claude.com/docs/en/managed-agents/files) كيفية سرد الملفات الخاصة بالجلسة وتنزيلها. وفي Python SDK، يكون شكل القراءة الموثق كما يلي:

```python
files = client.beta.files.list(
    scope_id=session.id,
    betas=["managed-agents-2026-04-01"],
)
for report in files:
    if report.filename == "report.json":
        content = client.files.download(report.id)
        content.write_to_file("report.json")
        break
```

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

ينبغي أن يكون عقد المخرجات صارمًا بما يكفي للتدقيق. على سبيل المثال:

```json
{
  "files": [
    {
      "path": "requirements.md",
      "status": "reviewed",
      "findings": [
        {
          "check": "deadline",
          "evidence_excerpt": "...",
          "source_location": "requirements.md, section 2"
        }
      ]
    }
  ],
  "input_count": 1,
  "reviewed_count": 1,
  "unresolved_count": 0
}
```

هذا مخطط مقترح لسير العمل، وليس مخططًا من Anthropic. احتفظ بالملفات غير المحسومة أو التي يتعذر قراءتها كسجلات حتى لا يبدو غياب النتيجة كأنه مراجعة سليمة.

## 5. افحص التشغيل ومخرجاته

عند بدء سير العمل، يعلن تدفق الأحداث عن `workflow_run.created`، بما في ذلك معرّف التشغيل والمراحل التي يحددها سير العمل. يبقي المثال كل معرّف تشغيل مفتوحًا إلى أن يصل الحدث المطابق `workflow_run.status_ended`؛ فخمول الجلسة الأساسية وحده لا يثبت انتهاء سير العمل في الخلفية. يلخص التدفق الأساسي حالة السلاسل الفرعية، بينما تتضمن قائمة أحداث كل سلسلة رسائلها وأخطاءها. ويسرد المثال السلاسل حسب `workflow_run_id` ويعرض أحداث `session.error` . افحص تلك الأحداث بحثًا عن محاولات إعادة نفاد عددها (بما فيها `retry_status.type == "exhausted"`) أو أخطاء أخرى في السلاسل الفرعية، واجعل الملفات المتأثرة غير محسومة.

اعتبر ملف المخرجات هو التسليم المطلوب، لا كلمة «مكتمل». وتحذر Anthropic صراحةً من أن التشغيل قد ينتهي بالحالة `completed` حتى إذا فشل عمل سلسلة أو تعذر إنشاؤها. افتح `report.json` وتحقق من أن لكل ملف إدخال نتائج أو حالة غير محسومة صريحة، وأن مقتطفات الأدلة تشير إلى ملف المصدر الصحيح، وأن الأعداد تطابق الملفات التي قدمتها. قارن مجلد الاختبار الصغير بالنتائج التي تتوقعها قبل استخدام سير العمل على مجموعة أكبر.

إذا انقطع اتصال العميل، فلن يرسل تدفق الأحداث الجديد إلا الأحداث التي صدرت بعد فتحه. أعد بناء حالة التشغيل بسرد أحداث الجلسة السابقة باستخدام مرشحات أنواع الأحداث الموثقة ومتابعة ترقيم الصفحات. لا تستنتج انتهاء التشغيل من خمول الوكيل الأساسي بينما قد تظل السلاسل الفرعية تعمل. بعد انتهاء كل عمليات التشغيل التي رصدتها، اسرد ملفات الجلسة ونزّل `/mnt/session/outputs/report.json` و `summary.md` باستخدام Files API الموثقة. تحقق من وجود سجل مراجع أو غير محسوم لكل ملف قدمته ومن تطابق الأعداد. لا تنزّل حلقة الأحداث في المثال التقرير نفسه ولا تتحقق منه.

## قيود تؤثر في التصميم

توثق Anthropic في [حدود تشغيل سير العمل](https://platform.claude.com/docs/en/managed-agents/workflow-runs) إمكانية عمل ما يصل إلى 64 سلسلة سير عمل في الوقت نفسه ضمن تشغيل واحد حاليًا، لكن API لا تضمن هذا التوازي وقد تتغير القيمة. يحصي حد 1,000 وكيل جميع الوكلاء الذين بدأوا طوال عمر التشغيل؛ وليس عدد السلاسل المتزامنة. إذا طلب سير العمل بدء وكيل آخر بعد بلوغ هذا الإجمالي، ينتهي التشغيل بالحالة `thread_limit_error`؛ وقد تؤدي إعادة محاولة الوكلاء الفاشلين إلى إنشاء سلاسل إضافية.

تستمر عملية التشغيل 24 ساعة افتراضيًا، أو مدة أقصر إذا حدد وكيلها ذلك. ويُحتسب أيضًا وقت انتظار العميل، وقد تنتهي مهلة تشغيل متوقف مؤقتًا. وتضم الجلسة 10 عمليات تشغيل مفتوحة افتراضيًا، بما فيها الخاملة. تنطبق ميزانية استخدام الجلسة على جميع وكلاء سير العمل؛ وعند بلوغها، تتوقف عمليات التشغيل المفتوحة مؤقتًا إلى أن تُرفع الميزانية أو تزال. خطط لوحدات عمل أصغر، واحفظ نقاط التحقق في ملفات، واجعل مرحلة المطابقة تبلغ عن العناصر غير المكتملة بدل الادعاء بأنها روجعت.

عند حدوث إخفاق، افحص `workflow_run.error` والسلسلة المتأثرة. قد تعني `program_error` فشل رمز سير العمل أو إحدى السلاسل الفرعية؛ وتشير `thread_limit_error` إلى سقف 1,000 وكيل؛ وتشير `timeout_error` إلى حد مدة التشغيل. إذا بلغ التشغيل ميزانية الجلسة، فارفع الميزانية أو أزلها لاستئنافه. لإيقاف سير العمل، اطلب من الوكيل الأساسي إيقاف عمليات تشغيله؛ فمقاطعة دور الجلسة ليست بحد ذاتها أمرًا لإلغاء التشغيل.

## التكلفة

تفرض [وثائق أسعار](https://platform.claude.com/docs/en/about-claude/pricing) Anthropic رسوم Managed Agents حسب أسعار رموز النموذج المختار ومدة تشغيل الجلسة، بمعدل **0.08 دولار لكل ساعة جلسة قيد التشغيل**. تتراكم المدة عندما تكون حالة الجلسة `running`؛ ولا تُحتسب أوقات الخمول وإعادة الجدولة والإنهاء. لا توجد رسوم منفصلة لتشغيل سير العمل، لكن استخدام السلاسل للرموز يُحتسب ضمن الجلسة. وتُسعّر عمليات البحث على الويب التي تُجرى داخل الجلسة بـ10 دولارات لكل 1,000 عملية بحث. يعتمد الإجمالي الدقيق على النموذج ورموز الإدخال والإخراج والأدوات ومدة الجلسة؛ فتحقق من الاستخدام في Console بدل تقديره استنادًا إلى سقف 1,000 وكيل.

عمليًا، ابدأ بعدد قليل من الملفات، وتحقق من أن مخرجات سير العمل تتناول كل ملف، وافحص السلاسل التي أخفقت، ثم وسّع المدخلات فقط عندما تكون سياسة المراجعة والتكلفة مقبولتين. توفر مسارات العمل المُدارة طريقة لتنسيق العمل المتوازي غير المتزامن؛ لكنها لا تصادق على النتائج.

## التغيير الأبرز

منذ 9 أكتوبر، يستطيع وكيل Managed Agents كتابة برنامج سير عمل ينفذه الخادم عبر عدة سلاسل ومراحل للوكلاء. ويمكن للمطورين استخدام هذا المسار لتوزيع محدود وقابل للتدقيق بينما تتابع الجلسة الرئيسية التقدم. وما تزال الميزة في الإصدار التجريبي، ولا تضمن الحدود المنشورة بلوغ كل تشغيل أقصى توازٍ أو إنتاج نتائج صحيحة.

## المصادر ومواد إضافية

- [نظرة عامة على Claude Managed Agents](https://platform.claude.com/docs/en/managed-agents/overview) — حالة الإصدار التجريبي، وترويسة API، والوصول، والجلسات ذات الحالة، والأدوات، وقيود الاحتفاظ بالبيانات.
- [البدء باستخدام Claude Managed Agents](https://platform.claude.com/docs/en/managed-agents/quickstart) — CLI وSDK وإعداد الوكيل والبيئة وإنشاء الجلسة ومثال تدفق الأحداث.
- [تنسيق عمل عدة وكلاء](https://platform.claude.com/docs/en/managed-agents/multiagent-orchestration) — تفعيل مسارات العمل الديناميكية والاختيار بين مسارات العمل والوكلاء الفرعيين.
- [عمليات تشغيل سير العمل](https://platform.claude.com/docs/en/managed-agents/workflow-runs) — أحداث التشغيل وتفسير النتائج والاستعادة والميزانيات والقيود الموثقة.
- [سلاسل الجلسة](https://platform.claude.com/docs/en/managed-agents/session-threads) — سرد السلاسل الفرعية المرتبطة بالتشغيل وقراءة سجل أحداثها.
- [ملفات الجلسة](https://platform.claude.com/docs/en/managed-agents/files) — المدخلات المركّبة ومسارات المخرجات وسرد ملفات الجلسة وتنزيلها.
- [ملاحظات إصدار Claude Platform](https://platform.claude.com/docs/en/release-notes/overview) — تحديث مسارات العمل الديناميكية في 9 أكتوبر 2026 وإعداد الإصدار التجريبي.
- [أسعار Claude Platform](https://platform.claude.com/docs/en/about-claude/pricing) — فوترة الرموز وأسعار مدة الجلسة.

## Sources

- [نظرة عامة على Claude Managed Agents](https://platform.claude.com/docs/en/managed-agents/overview) — حالة الإصدار التجريبي الحالية وترويسة API والوصول والجلسات ذات الحالة وقيود الاحتفاظ بالبيانات.
- [البدء باستخدام Claude Managed Agents](https://platform.claude.com/docs/en/managed-agents/quickstart) — إعداد CLI وSDK والوكيل والبيئة، وأمثلة الجلسات وتدفق الأحداث.
- [تنسيق عمل عدة وكلاء](https://platform.claude.com/docs/en/managed-agents/multiagent-orchestration) — تفعيل مسارات العمل والفرق بينها وبين الوكلاء الفرعيين.
- [عمليات تشغيل سير العمل](https://platform.claude.com/docs/en/managed-agents/workflow-runs) — آليات مسارات العمل والتشغيل، والأحداث، وتفسير حالة المخرجات، والاستعادة، والميزانيات والقيود.
- [Claude Platform release notes](https://platform.claude.com/docs/en/release-notes/overview) — سجل مؤرخ للإصدار التجريبي العام وتحديث مسارات العمل الديناميكية بتاريخ 9 أكتوبر 2026؛ الرابط الأساسي المصحح.
- [Claude Platform pricing](https://platform.claude.com/docs/en/about-claude/pricing) — أسعار رموز Managed Agents ومدة تشغيل الجلسة.
- [Session threads](https://platform.claude.com/docs/en/managed-agents/session-threads) — سرد السلاسل الفرعية المرتبطة بالتشغيل وقراءة سجل أحداثها.
- [Session files](https://platform.claude.com/docs/en/managed-agents/files) — المدخلات المركّبة ومسارات المخرجات وسرد ملفات الجلسة وتنزيلها.