# Phục hồi một sự tích hợp tác nhân

Phục hồi một bị ngắt quãng CLI hay MCP tác vụ sử dụng nó tiết kiệm được chạy, công việc hoặc kết quả ID.

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

<a id="start"></a>

## Bắt đầu với ID Anh đã cứu mạng tôi

Tạm dừng nhiệm vụ hoặc thời gian biểu bị lỗi. Tìm biên lai của nó trong thư mục hay lịch sử tác vụ của bạn, rồi đi theo đường dẫn trùng khớp. Những IDs không thể thay đổi được.

| Anh có. | Dùng |
| --- | --- |
| CLI runId | Hạt CLI bước bên dưới, với hồ sơ gốc và thư mục tình trạng. |
| ID tác vụ MCP · job_… | get_job trên các điều đã có MCP kết nối. |
| MCP kết quả ID Kết quả là. | get_result phải finish đọc được một phản ứng lớn. |
| OpenClaw chạy ID | OpenClaw Chạy lịch sử, sau đó FlashData ID Được ghi lại bởi đó chạy. |

- [Phục hồi CLI](https://flashdata.dev/vi/docs/guides/agent-recovery/reference.md#inspect)
- [Phục hồi MCP](https://flashdata.dev/vi/docs/guides/agent-recovery/reference.md#mcp)
- [OpenClaw chạy lịch sử](https://flashdata.dev/vi/docs/guides/recurring-tasks/reference.md#inspect-test)

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

## 1. Kiểm tra CLI chạy

Mở Bash (Git Bash trên Windows) là bản gốc OS người dùng, trong thư mục xuất của tác vụ. Thay thế cả ba giá trị bên dưới với những giá trị từ tác vụ gốc. Giữ thiết bị cuối này mở ra từng bước 2 và 3. Bỏ sắp xếp FLASHDATA_API_KEY Cho phép CLI sử dụng chìa khóa được lưu trong hồ sơ này.

### Chọn tác vụ đã có. thiết bị cuối này

```bash
# Replace these with the values used by the original task.
export FLASHDATA_PROFILE='research'
export FLASHDATA_STATE_DIR='/absolute/path/to/existing/flashdata-state'
export RUN_ID='scheduled-research:2026-11-04:Asia-Shanghai'
unset FLASHDATA_API_KEY
```

### Kiểm tra nội bộ là· no API cuộc gọi

```bash
: "${FLASHDATA_STATE_DIR:?Set the existing absolute state directory}"
: "${RUN_ID:?Set the run ID from the original receipt}"
flashdata doctor --offline --profile "${FLASHDATA_PROFILE:-research}" \
  --state-dir "$FLASHDATA_STATE_DIR" --json --non-interactive
flashdata runs show "$RUN_ID" --profile "${FLASHDATA_PROFILE:-research}" \
  --state-dir "$FLASHDATA_STATE_DIR" --json --non-interactive
```


<a id="run-status"></a>

### Chọn hành động phục hồi

Đọc data.status, data.remoteId và data.errorCode trong kỷ lục chạy.

| Trạng thái đã thu | Cách xử lý |
| --- | --- |
| succeeded | Kiểm tra truy cập, sau đó xuất kết quả đã lưu trong bước 3. |
| accepted | Kiểm tra truy cập, sau đó phục hồi công việc được chấp nhận trong bước 3. |
| uncertain / intent | Giữ nhiệm vụ tạm dừng. Kiểm tra remoteId, candidateRemoteIds và History trước khi quyết định có nên nộp lại bất cứ thứ gì không. |
| failed | Sửa errorCode trước. Một hồ sơ thất bại được giữ lại; thay thế là một nhiệm vụ mới và có thể sử dụng tín dụng. |
| partial | Giữ kết xuất sẵn sàng. Phục hồi các công việc đã biết; để làm công việc to lớn, hãy kiểm tra từng hàng trước khi thay thế những thứ bị hỏng. |
| run_not_found | Kiểm tra hồ sơ, OS người dùng và thư mục tình trạng. Tìm những biên lai lưu hoặc History nếu như tạp chí bị mất. |

- [Mở lịch sử yêu cầu](https://flashdata.dev/app/jobs)
- [Thu hồi kết quả lớn](https://flashdata.dev/vi/docs/guides/bulk/reference.md)

<a id="decide"></a>

## 2. Kiểm tra CLI truy cập tài khoản

Những kiểm tra miễn phí này cần thiết truy cập vào tài khoản gốc và API Nguồn gốc. Giải quyết bất kỳ lỗi xác thực trước khi phục hồi kết quả.

### Kiểm tra truy cập và đọc số dư

```bash
: "${FLASHDATA_STATE_DIR:?Set the existing absolute state directory}"
flashdata auth status --profile "${FLASHDATA_PROFILE:-research}" \
  --state-dir "$FLASHDATA_STATE_DIR" --json --non-interactive
flashdata account balance --profile "${FLASHDATA_PROFILE:-research}" \
  --state-dir "$FLASHDATA_STATE_DIR" --json --non-interactive
```


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

### Kiểm tra các trường này

Một sự số dư không là một vấn đề tài trợ cho công việc mới. Nó không có nghĩa là chìa khóa không hợp lệ.

| Trường auth status | Mong đợi |
| --- | --- |
| data.accessVerified | true; nếu không hãy sửa chữa truy cập trước khi đọc kết quả. |
| data.identity.identity.accountId | Tài khoản đã gửi nhiệm vụ. |
| data.identity.permittedSources | Bao gồm cả nguồn được sử dụng bởi nhiệm vụ được lưu giữ. |
| data.identity.identity.recurringAllowed | true trước khi lặp lại một công việc lặp lại. |


<a id="account-change"></a>

### Tài khoản đã thay đổi, hoặc tôi chỉ cần tuyên bố một phiên tòa

run_account_mismatch Nghĩa là chạy được lưu thuộc về một tài khoản khác hoặc API Nguồn gốc. Việc sử dụng lại tên hồ sơ không truyền đi điều chạy đó.

| Tình trạng | Hành động |
| --- | --- |
| Tài khoản sai | Kiểm tra ghi đè bằng khoá môi trường, đã chọn hồ sơ và management/data Nguồn gốc. Hãy khôi phục lại tài khoản đã định trước trước khi hồi phục. |
| Phím xoay | Dùng chìa khóa thay thế cho tài khoản tương tự với quyền truy cập mã nguồn cần thiết. Giữ hồ sơ gốc, thư mục tiểu dụng và chạy ID. |
| Được xác nhận là đã thử nghiệm | Tài khoản của chủ khác với tài khoản tạm thời. Đọc kết xuất thử nghiệm bạn đã xuất. Dùng một lần chạy mới ID Chỉ cho một nhiệm vụ mới chủ sở hữu, nó sử dụng sự số dư của chủ sở hữu. |

- [Thay thế một khóa chủ](https://flashdata.dev/vi/docs/guides/api-keys-and-permissions/reference.md#rotate)
- [Dùng thử và liên kết tài khoản](https://flashdata.dev/vi/docs/guides/agent-onboarding/reference.md#owner-result)

<a id="handoff"></a>

### Tiếp tục một yêu cầu bị ngắt quãng

Để được chấp thuận, chạy đi. auth finish trong hồ sơ ban đầu của nó trong 24- giờ tắt cửa sổ. Nó tiết kiệm và xác nhận lại chìa khóa của người sở hữu, sau đó thừa nhận cài đặt. Lệnh thứ hai kiểm tra quyền truy cập được lưu trong một tiến trình mới.

#### Kết thúc việc đã có

```bash
: "${FLASHDATA_STATE_DIR:?Set the existing absolute state directory}"
# Resume an already approved claim in its original profile.
flashdata auth finish --profile "${FLASHDATA_PROFILE:-research}" \
  --state-dir "$FLASHDATA_STATE_DIR" --json --non-interactive

# A second process checks the saved owner access.
flashdata auth status --profile "${FLASHDATA_PROFILE:-research}" \
  --state-dir "$FLASHDATA_STATE_DIR" --json --non-interactive
```

- [Yêu cầu bị hạn chế hoặc bị mất giấy đăng ký](https://flashdata.dev/vi/docs/guides/agent-onboarding/reference.md#help)
- [Giao thức xác thực](https://flashdata.dev/auth.md)

<a id="recover"></a>

## 3. Phục hồi lại CLI kết quả

Chọn trạng thái đã lưu từ bước 1. Dùng tên tập tin xuất không tồn tại. Cả hai lệnh đều xác minh quyền truy cập và giữ cho chạy gốc; cũng không đệ trình một yêu cầu thay thế.

### Giữ được thành công

#### Xuất kết quả đã lưu

```bash
: "${FLASHDATA_STATE_DIR:?Set the existing absolute state directory}"
: "${RUN_ID:?Set the run ID from the original receipt}"
flashdata runs show "$RUN_ID" --result --output recovered.json \
  --profile "${FLASHDATA_PROFILE:-research}" --state-dir "$FLASHDATA_STATE_DIR" --json --non-interactive
```


### Đã chấp nhận một công việc đặc biệt

Việc bỏ phiếu chấm dứt việc đợi ở địa phương. Hãy chạy lại lệnh phục hồi này để tiếp tục đợi cùng một công việc.

#### Đợi công việc gốc

```bash
: "${FLASHDATA_STATE_DIR:?Set the existing absolute state directory}"
: "${RUN_ID:?Set the run ID from the original receipt}"
flashdata runs recover "$RUN_ID" --output recovered.json --timeout 10m \
  --profile "${FLASHDATA_PROFILE:-research}" --state-dir "$FLASHDATA_STATE_DIR" --json --non-interactive
```


- [Đọc một công việc từ xa đã biết ID](https://flashdata.dev/vi/docs/guides/async-batch/reference.md#job-status)

<a id="verify"></a>

### Xác nhận phục hồi trước khi tiếp tục

1. Kiểm tra mã thoát 0 và ok: trueVậy thì mở ra đi. recovered.json. Xuất khẩu đã lưu cached: true; sử dụng ám chỉ thực hiện gốc.
2. Giữ cùng tài khoản, hồ sơ, tình trạng và chạy ID khi thử lại lần nữa. Không xóa tạp chí hoặc thay đổi tên của chạy để ép buộc một thử lại.
3. Tiếp tục lên kế hoạch chỉ sau khi truy cập và kết quả được kiểm tra. Cho mỗi lần xuất hiện theo lịch mới của nó chạy ID.

- [Name](https://flashdata.dev/vi/docs/guides/recurring-tasks/reference.md#slot)
- [Lưu kết quả để dùng sau](https://flashdata.dev/vi/docs/guides/save-results/reference.md)

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

## Phục hồi một nhiệm vụ MCP

MCP cuộc gọi không được tạo CLI Chạy hồ sơ. Sử dụng các điều đã có MCP kết nối đến tài khoản đã gửi công việc này. Thay thế công việc ID trong dấu nhắc này và gửi nó cho đại lý kết nối của anh.

### Dán vào tác nhân kết nối của bạn

```text
Phục hồi lại tôi đã có FlashData công việc: job_REPLACE_WITH_SAVED_ID.
Dùng kết nối MCP hiện tại. nhỏ get_balance có {} Để kiểm tra quyền truy cập,
Vậy thì get_job Với cái này job_id.
Nếu câu trả lời chứa result_id, finish đọc nó get_result Phần
và kết hợp chúng trước khi phân tích JSON.
Vì job.status Đợi hoặc xử lý, thăm dò cùng một công việc mỗi 5 giây
cho đến phút 2, sau đó báo cáo tình trạng mới nhất và dừng lại.
Để hoàn thành, lưu kết xuất và nguồn của nó URLs và sử dụng trong nhiệm vụ này.
Trong một lỗi truy cập, thất bại công việc hoặc không có kết quả, dừng và báo cáo các ID.
Không chạy công cụ nguồn, gửi một mẻ, hoặc tạo thông tin mới.
```

- [Tái kết nối một máy MCP](https://flashdata.dev/vi/docs/guides/agent-access/reference.md)
- [MCP tham chiếu công cụ](https://flashdata.dev/vi/docs/mcp/reference.md)

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

### Đọc công việc gốc

Cho một phong tục MCP trạm khách, chuyển đối tượng này tới callTool sau khi thay thế job_id. Đây là cuộc gọi công cụ, không phải lệnh hệ vỏ. get_job kiểm tra tài khoản công việc và quyền truy cập nguồn; thành công get_balance Chỉ kiểm tra thôi không chứng minh được quyền truy cập công việc này.

#### get_job

```json
{
  "name": "get_job",
  "arguments": {
    "job_id": "job_REPLACE_WITH_SAVED_ID"
  }
}
```


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

### Kiểm tra MCP Trạng thái công việc

| Phản hồi | Hành động tiếp theo |
| --- | --- |
| job.status: pending / processing | Đợi đã, sau đó đọc cùng một công việc ID. Thời hạn địa phương không hủy bỏ nó. |
| job.status: completed | Lưu kết xuất. Cách sử dụng của nó thuộc về yêu cầu ban đầu; get_job không đệ lại hay tính phí cho một yêu cầu mới. |
| job.status: failed / isError: true | Đọc lỗi trước khi dùng kết xuất nào. Đừng tự động chạy lại nguồn. |
| code: result_unavailable | Hãy thử đọc lại lần nữa cho một thất bại tạm thời. Nếu kết quả đã được lưu quá hạn, hãy sử dụng các xuất bản trước đó. Async JSON Kết quả được giữ lại 24 giờ. |


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

### Lớn MCP trả lời bị ngắt quãng

Sử dụng người được cứu result_id với cùng một API Chìa khóa. Bắt đầu ở bù đắp 0 để xây dựng lại toàn bộ phản ứng, nếu bạn giữ các mẫu trước đó, sử dụng chính xác next_offset Thay vào đó. Thay thế bộ giữ chỗ trước khi gọi công cụ này.

1. Phụ thêm mỗi miếng theo thứ tự, dùng next_offset Cho đến khi nó là null. Phân tích kết hợp JSON Chỉ sau lần cuối thôi.
2. Bộ nhớ tạm tồn tại 10 phút và giữ 4 câu trả lời lớn mới nhất cho mỗi phím. Nếu nó hết hạn hoặc bị đuổi việc và anh đã cứu được một công việc ID, gọi get_job Một lần nữa và đọc những đoạn mới của nó.
3. Một phản ứng thời gian thực không đảm bảo sẽ khôi phục được công việc nền. Mà không có một công việc được lưu ID hay xuất khẩu, kiểm tra History và hỏi trước khi chạy một truy vấn mới.

#### get_result

```json
{
  "name": "get_result",
  "arguments": {
    "result_id": "REPLACE_WITH_RESULT_ID",
    "offset": 0
  }
}
```

- [Trình khách MCP với bộ xử lý mảng](https://flashdata.dev/vi/docs/guides/mcp-custom-client/reference.md)

<a id="missing-id"></a>

## Tôi không có chạy hay làm việc. ID

Kiểm tra các tập tin lưu, lịch sử công cụ tác nhân và yêu cầu của người sở hữu History. A request_id là chẩn đoán IDkhông phải job_id. Nếu bạn không thể xác nhận việc này đã được chấp nhận, hãy tạm dừng công việc. Lặp lại cuộc gọi nguồn gốc có thể tạo ra một nguồn điện khác.

- [Mở lịch sử yêu cầu](https://flashdata.dev/app/jobs)

<a id="errors"></a>

## Tìm cách sửa chữa bởi mã lỗi

| Tín hiệu | Sửa |
| --- | --- |
| 400 / 422 | Kiểm tra các đối số so với các công cụ hoặc endpoint . Vì CLI yêu cầu, sử dụng truy vấn --dry-run Trước khi làm nhiệm vụ mới. |
| 401 / 403 | Đối với CLI, kiểm tra truy cập vào bước 2. Vì MCP OAuthHãy để máy được tái tạo, một quỹ trợ cấp bị hủy bỏ cần sự tái kết nối chủ sở hữu. Với một chìa khóa API, kiểm tra các bí mật và quyền truy cập nguồn của máy. |
| 402 | Dừng công việc mới cho đến khi người chủ quyết định tài trợ. |
| 406 | Dùng Accept: application/json. Cho nội dung kết thúc điểm, yêu cầu Markdown có X-Respond-WithĐánh dấu. |
| 429 | Danh dự Retry-After và khôi phục lại công việc đã biết trước trước khi nộp lại. Chờ đợi không rõ ràng là thất bại CLI Chạy kỷ lục. |
| Thời hạn / 5xx / bị mất phản ứng | Phục hồi được công việc đã được chấp nhận. Giữ kết quả phục tùng không rõ tạm dừng và kiểm tra History. |
| run_id_input_conflict | Phục hồi dữ liệu gốc. Việc nhập dữ liệu mới cần có chủ định để chạy ID. |
| run_account_mismatch | Dùng danh sách thay đổi tài khoản theo bước 2; một cuộc chạy mới ID không phải là đường tắt để hồi phục. |
| output_exists | Chọn một tên tập tin xuất mới. Giữ cho người được cứu sống chạy đi. |
| result_unavailable | Đối với MCP, kiểm tra công việc hoặc mảng bước trên. Đối với CLI, khôi phục lại công việc từ xa đã được chấp nhận. Kết quả đã hết hạn cần phải xuất khẩu sớm hơn hoặc lưu trữ của riêng bạn. |

- [HTTP Gặp lỗi khi tham chiếu](https://flashdata.dev/vi/docs/errors/reference.md)
- [Tái kết nối một máy MCP](https://flashdata.dev/vi/docs/guides/agent-access/reference.md)

<a id="support"></a>

## Name

Vì CLIChạy cái này đi jq lọc trên error.json được cứu bởi nhiệm vụ của anh. Vì MCPBản sao mã, http_status và request_id từ câu trả lời công cụ, cộng với lưu job_id hay result_id. Bao gồm phiên bản khách hàng, điểm cuối, thời gian UTC và cho dù chấp nhận được xác nhận hay không biết. Giấy ủy nhiệm mở rộng, cookie và đã ký URLs.

### Chọn các trường chẩn đoán (chỉ cục bộ)

```bash
# Read a saved CLI error envelope; no network request.
jq '{ok, runId, error: (.error | {
  code, httpStatus, retryAfter, runId, remoteId
})}' error.json
```

- [Liên hệ hỗ trợ](https://flashdata.dev/vi/contact)
