# Chạy tác vụ tác vụ tác nhân lặp lại

Sử dụng lại quyền truy cập được chấp thuận, tìm kiếm một lần trong mỗi lần gặp, và phục hồi mà không vô tình gửi lại một công việc tương tự.

Tài liệu tham khảo chính điển: https://flashdata.dev/vi/docs/guides/recurring-tasks
Xem lại: 2026-11-05 by FlashData

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

## Chọn phương pháp thực hiện tác vụ

Tác nhân của anh hay là OS Lịch trình cung cấp thời gian. FlashData cung cấp dữ liệu. Chọn một đường dẫn thực hiện và kiểm tra nó trong môi trường mà sẽ chạy mà không có ai giám sát.

| Dùng | Vì | Trạng thái để bảo tồn |
| --- | --- | --- |
| CLI | Một tác nhân có quyền truy cập thiết bị cuối, Cron, hoặc một kịch bản đã được sắp xếp trước. | Hồ sơ CLI, thư mục tiểu dụng và điều hành gốc ID. |
| MCP | Name FlashData máy chủ. | Thông tin về máy chủ, hồ sơ sự kiện, công việc IDs và kết quả. |

- [Nhiệm vụ CLI](https://flashdata.dev/vi/docs/guides/recurring-tasks/reference.md#input)
- [Nhiệm vụ MCP](https://flashdata.dev/vi/docs/guides/recurring-tasks/reference.md#mcp)
- [Tạo một cuộc họp hàng ngày](https://flashdata.dev/vi/docs/guides/daily-research-briefing/reference.md)

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

## Kiểm tra truy cập vào môi trường theo lịch

Dùng lại một kết nối chủ sở hữu đã có với google_search Cho phép. Xác nhận quyền truy cập tạm thời trước khi sử dụng lặp lại. Kiểm tra từ một quá trình hoặc phiên chạy mới, không chỉ một trong những tương tác.

### CLI

Dùng Bash và jq (Git Bash trên Windows), dưới OS người dùng đã lưu chìa khóa. Đặt tên hồ sơ đã có và thư mục tình trạng tuyệt đối bên dưới. Chạy cả hai khối trong cùng một thiết lập; người chạy lại sử dụng các thiết lập này.

Kiểm tra truy cập phải in true. So sánh availableCredits có estimatedCredits Trước khi tìm kiếm đầu tiên. Những kiểm tra này không gửi một yêu cầu.

#### Đặt kết nối đã lưu

```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
```

#### Tự do truy cập, số dư và kiểm tra giá

```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

Điều hành nó trong một cuộc họp mới. Hãy để cho chủ nhà sử dụng lại và làm cho nó được chấp thuận OAuth Giấy ủy quyền. Nó phải có khả năng tới FlashData mà không cần đăng nhập tương tác tại mỗi lần chạy.

#### Kiểm tra máy rảnh

```text
Dùng lại các điều đã có FlashData MCP kết nối trong môi trường đã được sắp xếp trước này.
Gọi get_balance với {}.
Gọi get_pricing với {"source":"google_search","request_count":1}.
Báo cáo số dư và giá ước tính. Không tìm kiếm hoặc tạo truy cập mới.
```


- [Cài đặt CLI](https://flashdata.dev/vi/docs/guides/flashdata-cli/reference.md#install)
- [Kết nối MCP](https://flashdata.dev/vi/docs/integrations/mcp-clients/reference.md)
- [Xác nhận quyền truy cập thử](https://flashdata.dev/vi/docs/guides/agent-onboarding/reference.md#claim)

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

## CLI: Lưu một tác vụ mỗi lần gặp

Tạo thư mục tác vụ bên dưới, rồi lưu request.json và run-research.sh bên trong nó. Giữ thư mục này riêng biệt với thư mục tình trạng chứng nhận tồn tại. Một ngày tượng trưng cho một Google Truy vấn; num đặt số kết quả. Hãy cho một công việc khác chảy tự nó chạy...ID Trước khi bị hành hình lần đầu tiên.

### Tạo thư mục tác vụ

```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>

### Lưu run-research.sh

Tạo run-research.sh bên cạnh request.json trong thư mục tác vụ. Sao chép toàn bộ văn lệnh bên dưới vào nó và lưu nó trước khi chạy hay lập trình tác vụ.

Văn lệnh đóng băng kết nhập cho mỗi ngày và giữ một biên nhận, kết quả và tập tin lỗi cho mỗi lần thử. Chỉ có công bố thành công result.json và receipt.json ở tầng cao nhất của thư mục. --recurring kiểm tra truy cập người sở hữu; nó không tạo một lịch trình.

#### 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>

### Chạy một lần, sau đó thử lại một tiến trình xử lý mới

Chạy khỏi thư mục tác vụ. Lệnh đầu tiên gửi đi tìm kiếm. Thứ hai sử dụng cùng tài khoản, nhập, hồ sơ và tình trạng để đọc kết quả đã lưu sau khi kiểm tra truy cập đó vẫn còn hợp lệ.

#### Một lần lượt / 2 tiến trình bắt đầu

```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>

### Xác nhận kết quả đã được tái sử dụng

Hóa đơn thứ hai sẽ chỉ ra cached: true. Cách sử dụng của nó thuộc về việc tìm kiếm ban đầu. Một hệ thống hữu cơ rỗng vẫn có thể thành công.

#### Kiểm tra kết quả và biên lai đã lưu

```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
```

#### Phần mở rộng nội dung thư mục chính

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


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

### Giữ các tập tin nằm giữa các việc chạy

| Tập tin | Dùng |
| --- | --- |
| runs/DATE/request.json | Việc nhập chính xác cho trường hợp đó; thay đổi nó sẽ làm cho người chạy dừng lại. |
| runs/DATE/result.json + receipt.json | Nỗ lực thành công cuối cùng. Chỉ tiêu diệt chúng sau khi lệnh hiện thời thoát thành công. |
| runs/DATE/attempt.*/ | Kết quả, biên nhận và sai sót cho mỗi lần thử, bao gồm cả thất bại. |
| FLASHDATA_STATE_DIR | Giấy ủy nhiệm bảo vệ và CLI Chạy hồ sơ. Giữ cùng hồ sơ và OS người dùng. |

- [Phục hồi lại một chạy bị ngắt quãng](https://flashdata.dev/vi/docs/guides/agent-recovery/reference.md)

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

## MCP: bền bỉ lần gặp và công việc ID

Sử dụng cơ quan tác vụ này với một máy duy trì trạng thái nhiệm vụ bền vững và cho phép một thực hiện hoạt động mỗi lần xảy ra. Lưu công việc đã trở về ID Ngay lập tức; sau khi khởi động lại, hãy đọc công việc đã chấp nhận thay vì tìm kiếm một lần nữa.

### MCP tác vụ s· lưu lại dạng recurring-task.txt

```text
Dùng lần xuất hiện đầu của bộ lập lịch ID và thời gian biểu.
Dùng lại các điều đã có FlashData MCP kết nối và lưu hồ sơ sự kiện.
1. Nếu sự kiện này hoàn tất, hãy trả lại kết quả đã được lưu mà không cần tìm kiếm.
2. Nếu nó có việc làm ID, gọi get_job Với điều đó job_id để đọc những tác phẩm hiện có.
3. Nếu bắt đầu nộp mà không có kết quả hay việc làm IDDừng lại để xem xét.
4. Để biết thêm thông tin mới, kiểm tra get_balance và get_pricing cho một người google_search.
   Chỉ tiếp tục trong ngân sách được phê duyệt và sự số dư sẵn có.
5. Hằng ngày submission_started trước khi gọi google_search một lần với:
   {"query":"battery recycling pilot plant announcements","num":5,"gl":"us","hl":"en","tbs":"qdr:w","mode":"async"}
6. Lưu công việc đã trở về ID Ngay lập tức. Đọc đi. get_job cho đến giai đoạn cuối; dừng lại khi thất bại.
   Giữ lại ID Vượt qua thời gian nghỉ và ngừng chờ đợi tại thời hạn của nền tảng.
7. Lưu kết quả, nguồn URLs và sử dụng, sau đó đánh dấu sự xuất hiện này hoàn tất.
Vào 401, 403, 402, 429 hoặc một kết quả không rõ, dừng lại và báo cáo lưu dữ liệu.
Honor Retry-After. Không tạo truy cập thay thế hoặc truy vấn trả tiền khác.
Hãy giữ bản báo cáo cục bộ; hãy dùng điểm đến chỉ khi được cấu hình riêng.
```

- [Công cụ MCP](https://flashdata.dev/vi/docs/mcp/reference.md)
- [Đọc một công việc được chấp nhận](https://flashdata.dev/vi/docs/mcp/reference.md#jobs)

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

### Những gì người chủ phải tiếp tục

Chỉ một dấu nhắc thì không thể ngăn chặn sự sao chép. MCP Gọi điện thoại không được thừa kế CLI Chạy đi.ID Bảo vệ. Máy chủ của bạn phải tiếp tục xuất hiện, phục tùng và làm việc ID. Nếu không thể, hãy dùng CLI Chạy theo bước dữ liệu. Hồ sơ ví dụ này thuộc về máy của bạn; nó không phải là một yêu cầu MCP.

#### Hồ sơ máy · Trích dẫn

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


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

## Lên lịch công việc đã thử nghiệm

Ví dụ bên dưới sử dụng OpenClaw vào 09:00 Asia/Shanghai. Tạo tác vụ bị tắt, chạy mà lưu công việc bằng tay, thanh tra kết xuất của nó, rồi bật nó. Với một người khác, theo cùng một trình tự với bộ điều khiển thử nghiệm của nó.

| Thiết lập | Dùng |
| --- | --- |
| Sự khẩn cấp | Một cuộc hành quyết tích cực cho dòng chảy công việc này, với tình trạng bền vững. |
| Thời gian chạy | Dùng cùng một cách OS người dùng và đường dẫn tuyệt đối cho các CLIThư mục nhiệm vụ và trạng thái nhận dạng. Xuất khẩu thiết bị cuối không tự động được thừa kế bởi cổng đang chạy. |
| Các đệ quy | Giữ ngày tháng và thời gian biểu ban đầu, kể cả sau nửa đêm. Một bài kiểm tra thủ công sử dụng ngày tháng của nó trong Asia/Shanghai. |
| Các sự kiện bị bỏ lỡ | Chọn cách bỏ qua hay đuổi kịp. Một cuộc chạy tìm hôm nay trả lại dữ liệu hiện tại, ngay cả khi được dán nhãn với ngày hôm qua. |
| Giao hàng | Cứu người địa phương trước. Cấu hình chính sách đích và thông báo trước khi gửi báo cáo. |

- [Chuẩn bị máy phục vụ hay container](https://flashdata.dev/vi/docs/guides/production-deployment/reference.md)

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

### CLI nhiệm vụ cơ thể cho một máy tác nhân

Thay thế hồ sơ và đường dẫn giữ chỗ, rồi lưu recurring-task.txt trong thư mục tác vụ. Dùng thân này cho CLI Thực hiện, hoặc MCP Thân phía trên cho MCP Thực hiện. Trực tiếp. OS Lịch trình có thể chạy Bash kịch bản với những biến môi trường này mà không có một mô hình.

#### recurring-task.txt

```text
Chạy bản được chấp thuận FlashData Công việc nghiên cứu dưới OS người dùng đã lưu chìa khóa.
Runner: <b> đường dẫn tới run-research.sh>
Đặt những biến môi trường này cho tiến trình chạy:
FLASHDATA_BIN: <b> đường dẫn đến Flashdata>
FLASHDATA_PROFILE: < t_i>Tên hồ sơ hiện có>
FLASHDATA_STATE_DIR: < sđã tồn tại thư mục trạng thái tuyệt đối>
Giữ FLASHDATA_API_KEY Chưa xác định sử dụng lại thẻ đã lưu.
Sử dụng ngày tháng ban đầu trong Asia/Shanghai, như YYY-MM-DD.
Để chạy một cách thủ công, hãy lưu ngày tháng của nó trước khi thi hành án.
Chạy: đập "<absolute path to run-research.sh>" YYYY-MM-DD
Giữ ngày đó trên các khu vực, ngay cả sau nửa đêm. Cho phép một người được thực hiện.
Giữ cùng hồ sơ, request.json và thư mục tiểu dụng.
Chỉ đọc ngày tháng result.json sau khi lệnh thoát thành công.
Liên kết mã nguồn báo cáo, chạy ID và sử dụng. Giữ kết xuất cục bộ.
Gặp lỗi, dừng và báo cáo lỗi đã lưu. Không khởi chạy công việc thay thế hoặc tạo truy cập mới.
```


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

### 1. Tạo ra một bị tắt OpenClaw công việc

Sử dụng một cổng chạy và một tác nhân có sẵn đã vượt qua kiểm tra truy cập. Các lệnh bên dưới sử dụng OpenClaw 2026.10.10; cập nhật khách cũ nếu --wait không sẵn sàng. Trong thư mục chứa recurring-task.txt, đã đặt OPENCLAW_AGENT_ID đến của người đại diện đó ID.

Chỉ huy lưu openclaw-job.json mà không viết quá một tập tin tồn tại. Đọc và đặt OPENCLAW_JOB_ID công việc đã trở về ID. Nếu sự sáng tạo mất phản ứng, kiểm tra danh sách tự động --all --json trước khi tạo ra một công việc khác. --no-deliver tắt thông báo tự động; cơ quan tác vụ cũng giữ báo cáo địa phương.

#### Bash* tạo một công việc bị tắt

```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
)
```

- [Thiết lập OpenClaw](https://flashdata.dev/vi/docs/integrations/openclaw/reference.md)
- [OpenClaw Tham chiếu chương trình](https://docs.openclaw.ai/cli/cron)

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

### 2. Kiểm tra công việc đã lưu trước khi cho phép nó

Chạy công việc đã lưu một lần trong khi nó bị tắt. Ngân sách cho một chi phí tìm kiếm và mô hình thử nghiệm; một khớp hoàn tất CLI Sự kiện có thể tái sử dụng kết quả của nó. Lệnh này chờ tới 10 phút

Mong đợi completionStatus: thành công, rồi kiểm tra kết quả đã lưu, liên kết và cách sử dụng nguồn. Vì CLIĐọc runs/DATE/result.json và receipt.json; cho MCPXem kết quả sự cố và công việc của nền tảng. enqueued: true một mình nghĩa là chấp nhận, chứ không phải hoàn thành.

#### Chạy một lần · lưu biên nhận thử ra

```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
)
```

#### Đọc hóa đơn thử nghiệm

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


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

### Kiểm tra thời hạn đã quá giờ hoặc bị lỗi

Thời gian dừng lại chờ đợi, không phải nhiệm vụ ở cổng. Hãy đọc lịch sử gần đây nếu biên lai trống không. Đặt OPENCLAW_RUN_ID đến OpenClaw runId rồi thanh tra vụ hành quyết đó. Đừng lặp lại lệnh chạy để kiểm tra tiến trình.

Đây là thời gian biểu thực hiện IDKhông phải FlashData chạy lặp lại ID hay một MCP công việc dữ liệu ID. Nếu tác nhân không thể đăng nhập hay thực hiện tác vụ dữ liệu, hãy để cho lịch bị tắt và sửa chữa bước đó trước.

#### Kiểm tra cùng một thực hiện

```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
```

- [Phục hồi lại bước dữ liệu FlashData](https://flashdata.dev/vi/docs/guides/agent-recovery/reference.md)

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

### 3. Bật sau khi kiểm tra kết xuất

Xem lại các tác nhân đã lưu, lịch trình, múi giờ và hoàn thành kiểm tra. Chỉ bật sau khi kết xuất là đúng và chi phí tái sử dụng được chấp nhận. Sau này việc ngưng hoạt động trong tương lai sẽ dừng lại trong những lời cầu khẩn; nó không hủy bỏ một yêu cầu đã được gửi đi.

#### Xem lại lịch sử thi công việc đã lưu

```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
```

#### Bật lịch làm việc hàng ngày

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

#### Tạm dừng chạy khi cần thiết

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


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

## Đặt các quy tắc về chi phí và thất bại

| Tình trạng | Hành động |
| --- | --- |
| Chi phí lên kế hoạch | Giá một lần truy vấn là do dự định. Thêm mô hình và máy chi phí riêng; đếm kết quả không phải là số đếm truy vấn. |
| Tài khoản chia sẻ | Hãy đặt ngân sách của bạn vào máy lên lịch hoặc máy chủ. Những ví dụ này không áp đặt một cái nắp khóa riêng biệt. |
| 401 / 403 / 402 | Tạm dừng công văn. Khả năng sửa chữa, cho phép hoặc số dư; tiếp tục lại với lần xuất hiện đầu tiên và trạng thái đã lưu. |
| 429 | Tôn trọng Retry-After. Kiểm tra CLI Chạy hay MCP Có lần trước khi quyết định liệu việc phục tùng có an toàn hay không. |
| Không rõ kết quả phục tùng | Giữ tình trạng an toàn và dừng lại. Phục hồi một công việc đã biết ID; không tạo ra một cú chạy mới ID để vượt qua sự không chắc chắn. |

- [Giá trị hiện tại](https://flashdata.dev/vi/pricing)
- [Những quyết định hồi phục](https://flashdata.dev/vi/docs/guides/agent-recovery/reference.md)

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

## Dừng kế hoạch và thu hồi quyền truy cập riêng

1. Hãy dừng chương trình lịch trình để ngăn chặn những lời cầu khẩn trong tương lai.
2. Thu hồi kết nối mật vụ, OAuth ứng dụng hay API Chìa khóa trong bàn điều khiển. Cầu vấn ngăn chặn sử dụng xác thực mới; nó không xóa các tập tin xuất khẩu.
3. Lặp lại kiểm tra truy cập miễn phí từ một quá trình mới. Nó sẽ thất bại sau khi hồi quy. CLI đăng nhập thô chỉ gỡ bỏ thẻ ủy nhiệm cục bộ; nó không thu hồi truy cập từ xa.

- [Connected apps và các tác nhân](https://flashdata.dev/app/settings/connections)
- [Phím API](https://flashdata.dev/app/api-keys)
- [Truy cập xe đạp cứu hộ](https://flashdata.dev/vi/docs/guides/agent-access/reference.md)
