# إدارة مهام العملاء المتكررة

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

مرجع كانوني: https://flashdata.dev/ar/docs/guides/recurring-tasks
Reviewed: 2026-11-05 by FlashData

<a id="choose"></a>

## اختر كيف تجري المهمة

عميلك المضيف أو OS الجدول الزمني يزود التوقيت. FlashData يزود البيانات. اختر مسار التنفيذ وجربه في البيئة التي ستنفذ بدون توقف

| الاستخدام | For | الدولة التي تحتفظ بها |
| --- | --- | --- |
| CLI | عميل لديه وصول نهائي، (كرون)، أو نص مُحدد. | ملف CLI الشخصي ودليل الحالة ومعرّف التشغيل الأصلي. |
| MCP | عميل مضيف له علاقة FlashData خادم. | وثائق تفويض المضيف، وسجل الأحداث، والعمل IDs ونتائج. |

- [CLI](https://flashdata.dev/ar/docs/guides/recurring-tasks/reference.md#input)
- [MCP](https://flashdata.dev/ar/docs/guides/recurring-tasks/reference.md#mcp)
- [بناء جلسة إحاطة يومية](https://flashdata.dev/ar/docs/guides/daily-research-briefing/reference.md)

<a id="prepare"></a>

## التحقق من إمكانية الوصول إلى البيئة المقررة

أعد استخدام اتصال مالك موجود بصلاحية google_search. اربط الوصول المؤقت بالحساب قبل الاستخدام المتكرر. اختبر من عملية أو جلسة مجدولة جديدة، وليس من جلسة تفاعلية فقط.

### CLI

Use Bash and jq (Git Bash on Windows), under the OS user that save the key. ضعي اسم ملفك الحالي ودليل الولاية المطلق أدناه اركضوا في نفس المحطة و الركض يعيد استخدام هذه البيئات

يجب أن يطبع فحص الوصول true. قارن availableCredits بـ estimatedCredits قبل أول بحث. لا ترسل هذه الفحوص استعلامًا.

#### احفظي اتصالك

```bash
# Use the profile and state directory that already hold your owner key.
export FLASHDATA_PROFILE='research'
export FLASHDATA_STATE_DIR='/absolute/path/to/existing/flashdata-state'
export FLASHDATA_BIN="$(command -v flashdata)"
unset FLASHDATA_API_KEY
```

#### حرية الوصول والتوازن والأسعار

```bash
set -euo pipefail
export FLASHDATA_BIN="${FLASHDATA_BIN:-$(command -v flashdata)}"
: "${FLASHDATA_STATE_DIR:?Set the existing absolute state directory}"
: "${FLASHDATA_BIN:?Set the absolute path to the FlashData executable}"
profile=${FLASHDATA_PROFILE:-research}
test -d "$FLASHDATA_STATE_DIR" || { echo 'Existing state directory not found.' >&2; exit 1; }
"$FLASHDATA_BIN" --version
jq --version
"$FLASHDATA_BIN" auth status --profile "$profile" \
  --state-dir "$FLASHDATA_STATE_DIR" --json --non-interactive |
  jq -e '.ok and .data.accessVerified
    and (.data.identity.identity.recurringAllowed == true)
    and (.data.identity.permittedSources | index("google_search") != null)'
"$FLASHDATA_BIN" account balance --profile "$profile" \
  --state-dir "$FLASHDATA_STATE_DIR" --json --non-interactive
"$FLASHDATA_BIN" account pricing --source google_search --request-count 1 \
  --profile "$profile" --state-dir "$FLASHDATA_STATE_DIR" --json --non-interactive
```


### MCP

شغّل هذا في جلسة مجدولة جديدة. دع المضيف يعيد استخدام بيانات اعتماد OAuth المعتمدة ويجددها. يجب أن يتمكن من الوصول إلى FlashData دون تسجيل دخول تفاعلي عند كل تشغيل.

#### تحقق من المضيف الحر

```text
أعد استخدام اتصال FlashData MCP الموجود في هذه البيئة المجدولة.
استدعِ get_balance باستخدام {}.
استدعِ get_pricing باستخدام {"source":"google_search","request_count":1}.
أبلغ عن الرصيد والسعر المقدّر. لا تبحث ولا تنشئ وصولًا جديدًا.
```


- [Install the CLI](https://flashdata.dev/ar/docs/guides/flashdata-cli/reference.md#install)
- [Connect MCP](https://flashdata.dev/ar/docs/integrations/mcp-clients/reference.md)
- [الوصول إلى التجربة في المطالبة](https://flashdata.dev/ar/docs/guides/agent-onboarding/reference.md#claim)

<a id="input"></a>

## CLI: Provide one task per occurrence

إنشاء ملف المهمة تحته، ثم توفير request.json و run-research.sh داخله. أبقي هذا الملف منفصلاً عن دليل الدولة الإبداعي الحالي ويمثل تاريخ واحد استفسارا واحدا من الأسئلة التي طرحتها شركة Google؛ ويحدد الرقم عدد النتائج. أعطى تدفقاً مختلفاً لعملها الخاصID قبل إعدامه الأول.

### إنشاء ملف المهمة

```bash
mkdir -p flashdata-research
cd flashdata-research
```

### request.json

```json
{
  "source": "google_search",
  "query": "battery recycling research",
  "params": {
    "num": 5
  }
}
```


<a id="runner"></a>

### Save run-research.sh

Create run-research.sh beside request.json in the task folder. نسخ النص الكامل أدناه في ذلك وإنقاذه قبل تشغيل المهمة أو تحديد مواعيدها.

ويجمّد السيناريو المدخلات لكل تاريخ ويحتفظ بملف استلام ونتيجة وخطأ لكل محاولة. فقط المحاولات الناجحة تنشر result.json و receipt.json على أعلى مستوى للملف --recurring يفحص وصول المالك، ولا يُنشئ جدولاً زمنياً.

#### run-research.sh

```bash
#!/usr/bin/env bash
set -euo pipefail
umask 077
slot=${1:?Pass the scheduled date as YYYY-MM-DD}
[[ "$slot" =~ ^[0-9]{4}-[0-9]{2}-[0-9]{2}$ ]] || exit 2
: "${FLASHDATA_STATE_DIR:?Set the existing absolute state directory}"
: "${FLASHDATA_BIN:?Set the absolute path to the FlashData executable}"
profile=${FLASHDATA_PROFILE:-research}
cd -- "$(dirname -- "$0")"
dir="runs/$slot"
mkdir -p "$dir"
if [[ -e "$dir/request.json" ]]; then
  cmp -s request.json "$dir/request.json" || {
    echo 'Input changed for this slot. Inspect its saved run.' >&2; exit 1;
  }
else
  (set -C; cat request.json > "$dir/request.json")
fi
attempt=$(mktemp -d "$dir/attempt.XXXXXX")
if ! "$FLASHDATA_BIN" query --input "$dir/request.json" --recurring \
  --run-id "scheduled-research:$slot:Asia-Shanghai" \
  --profile "$profile" --state-dir "$FLASHDATA_STATE_DIR" \
  --output "$attempt/result.json" --timeout 2m --json --non-interactive \
  > "$attempt/receipt.json" 2> "$attempt/error.json"; then
  cat "$attempt/error.json" >&2
  exit 1
fi
jq -e '.ok == true' "$attempt/receipt.json" >/dev/null
jq -e '.source == "google_search" and .status == "done"
  and (.results[0].organic | type == "array")' "$attempt/result.json" >/dev/null
# Publish a stable path only after the query and its receipt both succeed.
cp "$attempt/result.json" "$dir/result.next.json"
mv "$dir/result.next.json" "$dir/result.json"
cp "$attempt/receipt.json" "$dir/receipt.next.json"
mv "$dir/receipt.next.json" "$dir/receipt.json"
jq '{runId, cached, usage}' "$attempt/receipt.json"
printf 'Saved result: %s\n' "$dir/result.json"
```


<a id="slot"></a>

### اركضي مرة واحدة ثم اختبري عملية جراحية جديدة

اهرب من ملف المهمة القيادة الأولى تقدم بحثا ويستخدم الثاني نفس الحساب والمدخلات والملامح والولاية لقراءة النتيجة الموفرة بعد التحقق من أن الوصول لا يزال صالحا.

#### حدوث واحد؛ بدء عمليتين

```bash
# Use the date of the intended occurrence, including on retries.
bash run-research.sh 2026-11-04

# Same account, input, profile and state: reuse the completed run.
bash run-research.sh 2026-11-04
```


<a id="result"></a>

### تأكيد أن النتيجة قد أعيد استخدامها

يجب أن يظهر الإيصال الثاني cached: true. وإستعماله يعود إلى البحث الأصلي ولا يزال هناك نتيجة ناجحة للصفوف العضوية الفارغة.

#### فحص النتيجة الموفرة والاستلام

```bash
jq '{ok, runId, cached, usage}' runs/2026-11-04/receipt.json
jq '.results[0].organic | map({title, link})' runs/2026-11-04/result.json
```

#### الاستلام الثاني: مقتطف

```json
{
  "schemaVersion": 1,
  "ok": true,
  "runId": "scheduled-research:2026-11-04:Asia-Shanghai",
  "cached": true
}
```


<a id="files"></a>

### أبق الملفات بين الجرعات

| File | الاستخدام |
| --- | --- |
| runs/DATE/request.json | مساهمة حقيقية في هذا الحدث؛ تغييره يجعل الهارب يتوقف. |
| runs/DATE/result.json + receipt.json | آخر محاولة ناجحة فقط يستهلكهم بعد خروج القيادة الحالية بنجاح. |
| runs/DATE/attempt.*/ | النتيجة وإيصال المهمة والخطأ لكل محاولة، بما فيها المحاولات الفاشلة. |
| FLASHDATA_STATE_DIR | وثائق التفويض المحمية وسجلات التشغيل الخاصة بشركة CLI. حافظ على نفس الصورة OS مستعمل. |

- [إسترجعْ a مُقاطعَ مَرْك](https://flashdata.dev/ar/docs/guides/agent-recovery/reference.md)

<a id="mcp"></a>

## MCP: persist the occurrence and job ID

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

### MCP recurring task · save as recurring-task.txt

```text
إستعملْ الحدث الأصلي للجدولِ ID والوقت المحدد
Reuse the existing FlashData MCP connection and Save occurrence record.
1. وإذا اكتمل هذا الحدث، ارجع النتيجة التي تم إنقاذها بدون تفتيش.
2. إذا كان لديها وظيفة ID, call get_job with that job_id to read the existing work.
3. إذا بدأ تقديم الطلب ولكن لم يكن له أي نتيجة أو وظيفة IDتوقف عن الاستعراض
4. For a new occurrence, check get_balance and get_pricing for one google_search.
   ولا تستمر إلا في حدود الميزانية المعتمدة لكل مكتب والرصيد المتاح.
5. Persist submission_started before calling google_search once with:
   {"query":"battery recycling pilot plant announcements","num":5,"gl":"us","hl":"en","tbs":"qdr:w","mode":"async"}
6. انقذوا العمل المُعاد ID على الفور. اقرأها get_job حتى محطة طرفية؛ وقف على الفشل.
   حافظ على ID عبر الزمن وتوقف عن الانتظار في الموعد النهائي للمضيف
7. ووفر النتيجة، والمصدر URLs، والإستعمال، ثم علامة على أن هذا الحدث قد اكتمل.
On 401, 403, 402, 429 or an unknown outcome, stop and report the Save record.
الشرف Retry-After. لا تخلق إمكانية بديلة أو استفسار آخر مدفوع الأجر
إبقاء التقرير محلياً؛ ولا تستخدم وجهة التسليم إلا إذا تم تشكيله بصورة منفصلة.
```

- [MCP](https://flashdata.dev/ar/docs/mcp/reference.md)
- [إقرأْ شغلَ مقبولَ](https://flashdata.dev/ar/docs/mcp/reference.md#jobs)

<a id="mcp-retries"></a>

### ما يجب أن يستمر المضيف

العجلة وحدها لا يمكن أن تمنع الازدواج ولا ترث مكالمات MCP حماية CLI من طراز R-ID. مضيفكم يجب أن يستمر في الحدث الأصلي، حالة تقديم ووظيفة ID. وإذا لم يكن في وسعها، استخدمي مقياس CLI لخطوة البيانات. هذا السجل المثالي يعود لمضيفك، إنه ليس مضيفاً MCP طلب.

#### السجل المضيف؛

```json
{
  "occurrence": "research:2026-11-04:Asia-Shanghai",
  "state": "accepted",
  "job_id": "<returned job ID>",
  "output": null
}
```


<a id="schedule"></a>

## الجدول الزمني للمهمة التي تم اختبارها

المثال الوارد أدناه يستخدم OpenClaw في 09:00 Asia/Shanghai. إنشاء وظيفة معوقة، تشغيل التي أنقذت العمل يدويا، فحص ناتجها، ثم تمكينها. بالنسبة لمبرمج آخر، اتبع نفس التسلسل مع ضوابطها على الاختبارات.

| Setting | الاستخدام |
| --- | --- |
| التكافل | تنفيذ واحد فعال لتدفق العمل هذا، مع حالة دائمة. |
| الأجر | (ج) استخدام نفس مستعملي شركة OS والمسارات المطلقة للشركة CLI، وملف المهام، وحالة الإبداع. فالصادرات النهائية لا يرثها تلقائياً بوابة جارية. |
| Retries | احتفظ بالموعد الأصلي وتاريخه المجدول، حتى بعد منتصف الليل. يستخدم الاختبار اليدوي تاريخ استدعائه في Asia/Shanghai. |
| الحوادث المفقودة | اختر ما إذا كان يجب أن نتخطى أو نلحق عملية بحث اليوم تُعيد البيانات الحالية حتى لو كانت مُلصقة بموعد الأمس |
| التوصيل | أنقذ محلياً أولاً :: فرض الثقة على أي وجه وسياسة للإخطار قبل إرسال التقارير. |

- [إعداد خادم أو حاوية](https://flashdata.dev/ar/docs/guides/production-deployment/reference.md)

<a id="cli-task"></a>

### هيئة عمل من طراز CLI للوكيل المضيف

يستعاض عن الملامح وموصلات المسارات، ثم ينقذ recurring-task.txt في ملف المهمة. استخدم هذا الجسم في إعدام CLI، أو الجسم MCP فوق لتنفيذ حكم الإعدام في MCP. مباشرة OS يمكن للجدول أن يدير Bash نص مع هذه المتغيرات البيئية بدون نموذج

#### recurring-task.txt

```text
شغّل مهمة البحث المعتمدة في FlashData بحساب مستخدم نظام التشغيل الذي حفظ المفتاح.
المشغّل: <absolute path to run-research.sh>
اضبط متغيرات البيئة التالية لعملية المشغّل:
FLASHDATA_BIN: <absolute path to flashdata>
FLASHDATA_PROFILE: <existing profile name>
FLASHDATA_STATE_DIR: <existing absolute state directory>
اترك FLASHDATA_API_KEY غير معيّن لإعادة استخدام بيانات الاعتماد المحفوظة.
استخدم التاريخ المجدول الأصلي في Asia/Shanghai بصيغة YYYY-MM-DD.
للتنفيذ اليدوي، احفظ تاريخ الاستدعاء قبل التشغيل.
شغّل: bash "<absolute path to run-research.sh>" YYYY-MM-DD
احتفظ بهذا التاريخ عند إعادة المحاولة، حتى بعد منتصف الليل. اسمح بتنفيذ نشط واحد.
احتفظ بالملف الشخصي نفسه وrequest.json ودليل الحالة.
اقرأ result.json الخاص بذلك التاريخ فقط بعد انتهاء الأمر بنجاح.
أبلغ عن روابط المصادر ومعرّف التنفيذ والاستخدام. احتفظ بالمخرجات محليًا.
عند حدوث خطأ، توقف وأبلغ عن الخطأ المحفوظ. لا تبدأ عملًا بديلًا ولا تنشئ وصولًا جديدًا.
```


<a id="openclaw-schedule"></a>

### 1. إنشاء وظيفة معوقة من طراز OpenClaw

استخدموا بوابة ركض و عميلة موجودة تمرّر فحص الدخول الاوامر التي تحتها OpenClaw 2026.10.10:: تحديث عملاء كبار السن إذا ما تم ذلك --wait غير متاح. في الملف المحتوي على recurring-task.txtمجموعة OPENCLAW_AGENT_ID إلى تلك العميلة ID.

القيادة تنقذ openclaw-job.json بدون تخطي ملف قائم اقرأها وجهزها OPENCLAW_JOB_ID إلى الوظيفة العائدة ID. إذا خسر الخلق استجابته، يفتش قائمة التشغيل الآلي --all --json قبل إنشاء وظيفة أخرى. --no-deliver ويُبطل الإعلان التلقائي؛ وتحتفظ هيئة العمل أيضاً بالتقارير المحلية.

#### Bash · creates a disabled job

```bash
: "${OPENCLAW_AGENT_ID:?Set the existing OpenClaw agent ID}"
test -s recurring-task.txt || exit 1
# Keep the receipt. An existing file blocks accidental recreation.
(
  set -o noclobber
  openclaw automations add --name flashdata-daily-research \
    --agent "$OPENCLAW_AGENT_ID" \
    --cron "0 9 * * *" --tz Asia/Shanghai --exact \
    --session isolated --disabled --no-deliver \
    --message "$(cat recurring-task.txt)" --json > openclaw-job.json
)
```

- [OpenClaw setup](https://flashdata.dev/ar/docs/integrations/openclaw/reference.md)
- [OpenClaw Scheduling reference](https://docs.openclaw.ai/cli/cron)

<a id="test-schedule"></a>

### 2. اختبار العمل المنقذ قبل تمكينه

أديري العمل المنقذ مرة بينما يظل جدوله معوقاً (ب) ميزانية البحث عن اختبار واحد وتكاليف نموذجية؛ ويمكن أن يعاد استخدام نتائجه في عملية مطابقة مطابقة مكتملة لمادة CLI. هذه القيادة تنتظر حتى دقيقة 10.

Expect completionStatus: succeeded, then check the Save result, source links and usage. For CLIاقرأ runs/DATE/result.json و receipt.json; for MCPقرأت أن المضيف أنقذ الحدث و نتيجة العمل enqueued: true وحده يعني مقبولاً، غير مكتمل.

#### تشغيل مرة واحدة؛ حفظ إيصال الاختبار

```bash
: "${OPENCLAW_JOB_ID:?Set the saved OpenClaw job ID}"
# Run the saved job once; its schedule stays disabled.
(
  set -o noclobber
  openclaw automations run "$OPENCLAW_JOB_ID" \
    --wait --wait-timeout 10m --json > openclaw-test-run.json
)
```

#### اقرأ إيصال الاختبار

```bash
cat openclaw-test-run.json
```


<a id="inspect-test"></a>

### فحص اختبار موقوت أو فاشل

التوقف عن الانتظار، وليس مهمة البوابة. اقرأ التاريخ الحديث إذا كان الإيصال فارغاً المجموعة OPENCLAW_RUN_ID إلى OpenClaw runId من الاستلام أو التاريخ ثم تفحص ذلك الإعدام لا تكرروا الأمر الجاهز لتفقد التقدم

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

#### يفتشون نفس الإعدام

```bash
: "${OPENCLAW_JOB_ID:?Set the saved OpenClaw job ID}"
cat openclaw-test-run.json
openclaw automations runs "$OPENCLAW_JOB_ID" --limit 5 --json

# Set this from the receipt or history; this is OpenClaw's run ID.
: "${OPENCLAW_RUN_ID:?Set the OpenClaw test run ID}"
openclaw automations runs "$OPENCLAW_JOB_ID" \
  --run-id "$OPENCLAW_RUN_ID" --json
```

- [Recover the FlashData data step](https://flashdata.dev/ar/docs/guides/agent-recovery/reference.md)

<a id="manage-schedule"></a>

### 3. يمكن تحقيقه بعد التحقق من الناتج

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

#### استعراض العمل المنقذ وتاريخ الاختبار

```bash
: "${OPENCLAW_JOB_ID:?Set the saved OpenClaw job ID}"
openclaw automations show "$OPENCLAW_JOB_ID" --json
openclaw automations runs "$OPENCLAW_JOB_ID" --limit 5 --json
```

#### إتاحة الجدول اليومي

```bash
openclaw automations enable "$OPENCLAW_JOB_ID"
```

#### بدء تشغيل المستقبل عند الحاجة

```bash
openclaw automations disable "$OPENCLAW_JOB_ID"
```


<a id="budget"></a>

## وضع قواعد للتكلفة والفشل

| الحالة | الإجراء |
| --- | --- |
| تخطيط التكاليف | السعر لكل استفسار × الأحداث المخطط لها. يضاف النموذج وتكاليف المستضيفة بشكل منفصل؛ ولا يحسب عدد النتائج على الاستفسارات. |
| رصيد الحساب المشترك | إفرض ميزانيتك في الجدول أو المضيف ولا تفرض هذه الأمثلة حداً رئيسياً مستقلاً للإنفاق. |
| 401 / 403 / 402 | أوقف إرسالات المستقبل. ثبوت وثائق التفويض أو الإذن أو التوازن؛ واستئناف العملية الأصلية وإنقاذ الدولة. |
| 429 | التزم بـ Retry-After. افحص تنفيذ CLI أو موعد MCP قبل تقرير ما إذا كان إرسال جديد آمنًا. |
| نتائج العرض غير المعروفة | احتفظ بالحالة المحفوظة وتوقف. استعد معرّف مهمة معروفًا؛ ولا تنشئ معرّف تنفيذ جديدًا لتجاوز عدم اليقين. |

- [التسعير الحالي](https://flashdata.dev/ar/pricing)
- [قرارات الاسترداد](https://flashdata.dev/ar/docs/guides/agent-recovery/reference.md)

<a id="stop"></a>

## وقف الجدول الزمني وإلغاء الوصول بشكل منفصل

1. أوقفوا الجدول الزمني لإيقاف الاستفزازات المستقبلية
2. راجعي اتصال العميل OAuth التطبيق أو API المفتاح في الـ(كونول) ويحجب الإلغاء استخداماً موثقاً جديداً؛ ولا يمسح الملفات المصدَّرة.
3. أكرر فحص الدخول المجاني من عملية جديدة يجب أن تفشل بعد الإلغاء CLI ولا يزيل السحب في وقت التوثيق إلا وثائق التفويض المحلية، ولا يلغي إمكانية الوصول عن بعد.

- [Connected apps and agents](https://flashdata.dev/app/settings/connections)
- [مفاتيح API](https://flashdata.dev/app/api-keys)
- [دورة الحياة](https://flashdata.dev/ar/docs/guides/agent-access/reference.md)
