# Odzyskiwanie integracji agenta

Odzyskiwanie przerwanego zadania CLI lub MCP za pomocą zapisanego uruchomienia, zadania lub wyniku ID.

Odniesienie kanoniczne: https://flashdata.dev/pl/docs/guides/agent-recovery
Przegląd: 2026-11-05 przez FlashData

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

## Zacznij od zapisanego ID

Wstrzymać niepowodzenie zadania lub harmonogramu. Znajdź jego paragon w folderze zadań lub historii agenta, a następnie podążaj ścieżką dopasowania. Te IDs nie są wymienne.

| Masz | Stosowanie |
| --- | --- |
| CLI runId | CLI krok poniżej, z oryginalnym profilem i katalogiem stanu. |
| MCP job ID · job _. | get_job na istniejącym połączeniu MCP. |
| MCP wynik ID · wynik _. | get_result do finish odczytuje dużą odpowiedź. |
| OpenClaw run ID | OpenClaw uruchom historię, a następnie FlashData ID nagrany przez ten bieg. |

- [Odzysk CLI](https://flashdata.dev/pl/docs/guides/agent-recovery/reference.md#inspect)
- [Odzysk MCP](https://flashdata.dev/pl/docs/guides/agent-recovery/reference.md#mcp)
- [Historia uruchomienia OpenClaw](https://flashdata.dev/pl/docs/guides/recurring-tasks/reference.md#inspect-test)

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

## 1. Sprawdź przebieg CLI

Otwórz Bash (Git Bash na Windows) jako oryginalny użytkownik OS w folderze wyjściowym Twojego zadania. Zastąp wszystkie trzy wartości poniżej tymi z oryginalnego zadania. Ten terminal jest otwarty dla kroków 2 i 3. Rozłączenie FLASHDATA_API_KEY pozwala CLI używać klawisza zapisanego w tym profilu.

### Wybierz istniejące zadanie · ten terminal

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

### Lokalna inspekcja · brak połączeń API

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

### Wybierz działanie w zakresie odzyskiwania

Przeczytaj data.status, data.remoteId i data.errorCode w rekordzie startowym.

| Status zapisany | Co zrobić |
| --- | --- |
| succeeded | Sprawdź dostęp, a następnie eksportuj zapisany wynik w kroku 3. |
| accepted | Sprawdź dostęp, a następnie odzyskać przyjęte zadanie w kroku 3. |
| uncertain / intent | Wstrzymaj się z zadaniem. Sprawdź remoteId, candidateRemoteIds i History przed podjęciem decyzji, czy należy coś ponownie złożyć. |
| failed | Napraw najpierw errorCode. Nieudany rekord jest zachowany; zastępstwo jest nowym zadaniem i może korzystać z kredytów. |
| partial | Zachowaj dostępne wyjścia. Odzyskiwanie znanych miejsc pracy; w przypadku pracy masowej, należy sprawdzić każdy wiersz przed zastąpieniem nieudanych pozycji. |
| run_not_found | Sprawdź profil, użytkownik OS i katalog stanu. Szukaj zapisanych paragonów lub History, jeśli dziennik jest utracony. |

- [Otwórz historię żądań](https://flashdata.dev/app/jobs)
- [Wyniki masowe odzysku](https://flashdata.dev/pl/docs/guides/bulk/reference.md)

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

## 2. Sprawdź dostęp do konta CLI

Te darmowe kontrole wymagają dostępu do pierwotnego konta i pochodzenia API. Rozwiąż wszelkie błędy uwierzytelniania przed odzyskaniem wyników.

### Weryfikacja dostępu i odczyt salda

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

### Sprawdź te pola

Równowaga zerowa jest kwestią finansowania nowej pracy. Nie oznacza to samo w sobie, że klucz jest nieprawidłowy.

| Pole auth status | Oczekiwane |
| --- | --- |
| data.accessVerified | true; w przeciwnym razie należy naprawić dostęp przed odczytem wyników. |
| data.identity.identity.accountId | Konto, które złożyło to zadanie. |
| data.identity.permittedSources | Zawiera źródło wykorzystywane przez zapisane zadanie. |
| data.identity.identity.recurringAllowed | true przed wznowieniem powtarzającego się zadania. |


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

### Konto się zmieniło, albo zażądałem procesu.

run_account_mismatch oznacza, że zapisany bieg należy do innego konta lub pochodzenia API. Ponowne użycie nazwy profilu nie przenosi tej nazwy.

| Sytuacja | Działanie |
| --- | --- |
| Złe konto | Sprawdź nadrzędne sterowanie kluczem środowiskowym, wybrany profil i pochodzenie management/data. Przywrócić zamierzone konto przed odzyskaniem. |
| Klucz obrócony | Użyj klucza zastępczego dla tego samego konta z wymaganym pozwoleniem źródła. Zachowaj oryginalny profil, katalog stanu i uruchom ID. |
| Zatwierdzony proces | Konto właściciela różni się od rachunku tymczasowego. Przeczytaj wyniki próbne, które już wyeksportowałeś. Używa nowej wersji ID tylko do planowanego zadania nowego właściciela; używa salda właściciela. |

- [Zastąp klucz właściciela](https://flashdata.dev/pl/docs/guides/api-keys-and-permissions/reference.md#rotate)
- [Okres próbny i powiązanie konta](https://flashdata.dev/pl/docs/guides/agent-onboarding/reference.md#owner-result)

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

### Wznowienie wniosku o zaprzestanie stosowania

W celu uzyskania zatwierdzenia, w oknie przekazania auth finish należy uruchomić w oryginalnym profilu 24- godzinę. Zapisuje i weryfikuje klucz właściciela, a następnie uznaje instalację. Drugie polecenie sprawdza zapisany dostęp w nowym procesie.

#### Zakończ istniejące przekazanie

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

- [Wygasłe roszczenie lub utracona odpowiedź rejestracyjna](https://flashdata.dev/pl/docs/guides/agent-onboarding/reference.md#help)
- [Protokół uwierzytelniania](https://flashdata.dev/auth.md)

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

## 3. Odzyskiwanie wyniku CLI

Wybierz zapisany status z kroku 1. Użyj nazwy pliku wyjściowego, która nie istnieje. Obie komendy weryfikują dostęp i zachowują oryginalny przebieg; ani nie przedstawia zapytania zastępczego.

### Oszczędzony sukces

#### Eksportuj zapisany wynik

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


### Akceptowane zadanie async

Czas wyborów zatrzymuje lokalne czekanie. Uruchom to polecenie odzyskiwania, żeby czekać na tę samą pracę.

#### Poczekaj na oryginalną robotę

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


- [Przeczytaj znane zdalne zadanie ID](https://flashdata.dev/pl/docs/guides/async-batch/reference.md#job-status)

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

### Potwierdzenie odzyskania pomocy przed wznowieniem

1. Sprawdź kod wyjścia 0 i ok: true, a następnie otwórz recovered.json. Eksport z wynikiem zapisanym ma cached: true; użycie odnosi się do pierwotnego wykonania.
2. Zachowaj to samo konto, profil, stan i uruchom ID przy ponownym uruchomieniu tego zdarzenia. Nie usuwaj jego dziennika ani nie zmieniaj nazwy biegu, aby wymusić ponowną próbę.
3. Wznowienie planowania tylko po uzyskaniu dostępu i wynik jest weryfikowany. Dać każdemu nowemu planowemu zdarzeniu swój własny bieg ID.

- [Recurring- task runner](https://flashdata.dev/pl/docs/guides/recurring-tasks/reference.md#slot)
- [Zapisz wyniki do późniejszego użycia](https://flashdata.dev/pl/docs/guides/save-results/reference.md)

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

## Odzyskiwanie zadania MCP

Rozmowy MCP nie tworzą rekordów uruchamiania CLI. Użyj istniejącego połączenia MCP do konta, które złożyło zadanie. Zastąp zadanie ID w tym trybie i wyślij go do swojego powiązanego agenta.

### Wklej do swojego połączonego agenta

```text
Odzyskam moje dotychczasowe zadanie FlashData: job_REPLACE_WITH_SAVED_ID.
Użyj bieżącego połączenia MCP. Zadzwoń do get_balance z {}, aby sprawdzić dostęp,
następnie get_job z tym job_id.
Jeśli odpowiedź zawiera result_id, finish odczytuje fragmenty get_result
i połączyć je przed parsowaniem JSON.
W przypadku job.status oczekujących lub przetwarzających, prześlij to samo zadanie co kilka sekund 5
dla do 2 minut, a następnie zgłosić najnowszy status i zatrzymać.
Dla zakończonych, zapisać wyjście i jego źródło URLs i wykorzystanie w tym zadaniu.
W przypadku błędu dostępu, nieudanego zadania lub niedostępnego wyniku, zatrzymaj się i zgłoś ID.
Nie uruchamiaj narzędzia źródłowego, nie składaj partii, nie twórz nowych referencji.
```

- [Rozpuścić hosta MCP](https://flashdata.dev/pl/docs/guides/agent-access/reference.md)
- [MCP narzędzie odniesienia](https://flashdata.dev/pl/docs/mcp/reference.md)

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

### Przeczytaj oryginalną pracę

Dla własnego klienta MCP, przekazać ten obiekt callTool po zastąpieniu job_id. Jest to wywołanie narzędzia, a nie polecenie powłoki. get_job sprawdza konto pracy i pozwolenie źródłowe; sama skuteczna kontrola get_balance nie dowodzi dostępu do tego zadania.

#### get_job

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


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

### Sprawdź status zadania MCP

| Odpowiedź | Następna akcja |
| --- | --- |
| job.status: pending / processing | Czekaj, potem przeczytaj to samo ID. Lokalny timeout nie anuluje go. |
| job.status: completed | Zapisz wyjście. Jego użycie należy do oryginalnego zapytania; get_job nie przekazuje ani nie pobiera opłaty za nowe zapytanie. |
| job.status: failed / isError: true | Odczytaj błąd przed użyciem jakiegokolwiek wyjścia. Nie uruchamiaj źródła automatycznie. |
| code: result_unavailable | Należy pobrać odczyt z powodu niesprawności przejściowej dostawy. Jeżeli zapisany wynik wygasł, należy użyć wcześniejszego wywozu. Wyniki Async JSON są zatrzymywane przez godziny 24. |


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

### Duża odpowiedź MCP została przerwana

Użyj zapisanego result_id z tym samym klawiszem API. Zacznij od offsetu 0, aby odbudować całą odpowiedź; jeśli zachowałeś wcześniejsze kawałki, użyj ich dokładnego next_offset zamiast. Zastąp właściciela miejsca przed wywołaniem tego narzędzia.

1. Dołącz każdy kawałek w kolejności, używając next_offset do czasu, aż będzie to null. Przeanalizuj połączone JSON dopiero po ostatnim kawałku.
2. Cache trwa 10 minut i zachowuje cztery najnowsze duże odpowiedzi na klucz. Jeśli wygasł lub został eksmitowany i uratował pracę ID, zadzwoń ponownie get_job i przeczytać jego nowe kawałki.
3. Reakcja w czasie rzeczywistym nie ma gwarantowanej pracy w tle. Bez zapisanego zadania ID lub eksportu, sprawdź History i zapytaj przed uruchomieniem nowego zapytania płatnego.

#### get_result

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

- [Klient MCP z obchodzeniem się z kawałkami](https://flashdata.dev/pl/docs/guides/mcp-custom-client/reference.md)

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

## Nie mam pracy ani biegania ID

Sprawdź zapisane pliki zadania, historię narzędzia agenta i żądanie właściciela History. request_id jest diagnostycznym ID, a nie job_id. Jeśli nie możesz potwierdzić, czy zgłoszenie zostało przyjęte, zatrzymaj zadanie. Powtórzenie oryginalnego wywołania źródłowego może spowodować powstanie kolejnego ładunku.

- [Otwórz historię żądań](https://flashdata.dev/app/jobs)

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

## Znajdź poprawkę według kodu błędu

| Sygnał | Napraw |
| --- | --- |
| 400 / 422 | Sprawdzić argumenty w odniesieniu do narzędzia lub schematu końcowego. W przypadku żądań CLI, użyj query --dry-run przed każdym nowym zadaniem. |
| 401 / 403 | Dla CLI, sprawdź dostęp w kroku 2. Dla MCP OAuth, pozwól hosta odświeżać; cofnięte potrzeby dotacji własne zatwierdzone ponowne połączenie. Za pomocą klawisza API, sprawdź tajne i źródłowe uprawnienia hosta. |
| 402 | Przerwać nową pracę, dopóki właściciel nie ustali finansowania. |
| 406 | Użyj Accept: application/json. W przypadku obsługiwanych punktów końcowych zawartości, prosimy o Markdown z X-Respond-With: markdown. |
| 429 | Honor Retry-After i odzyskać wszelkie znane zadania przed złożeniem ponownie. Czekanie nie oczyszcza nieudanego rekordu przebiegu CLI. |
| Czas / 5xx / utracona odpowiedź | Odzyskaj znane miejsca pracy. Utrzymuj nieznany wynik składania i sprawdź History. |
| run_id_input_conflict | Przywróć oryginalne wejście. Nowe wejście wymaga celowego nowego zadania i uruchomić ID. |
| run_account_mismatch | Użyj listy kontrolnej recordt- change w kroku 2; nowy bieg ID nie jest skrótem do odzyskiwania. |
| output_exists | Wybierz nową nazwę pliku wyjściowego. Zachowaj zapisany bieg. |
| result_unavailable | Dla MCP, sprawdź pracę lub kawałki kroków powyżej. Dla CLI, odzyskać akceptowane zdalne zadanie. Wygasłe wyniki wymagają wcześniejszego wywozu lub własnego przechowywania. |

- [Odniesienie błędu HTTP](https://flashdata.dev/pl/docs/errors/reference.md)
- [Rozpuścić hosta MCP](https://flashdata.dev/pl/docs/guides/agent-access/reference.md)

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

## Wyślij diagnostykę do wsparcia

Dla CLI, uruchom ten filtr jq na error.json zapisanym przez Twoje zadanie. Dla MCP, kod kopiujący, http_status i request_id z odpowiedzi narzędzia, plus zapisany job_id lub result_id. Dołącz wersję klienta, punkt końcowy, czas UTC i czy akceptacja jest potwierdzona lub nieznana. Z wyłączeniem uwierzytelniania, plików cookie i podpisanego URLs.

### Wybierz pola diagnostyczne · tylko lokalne

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

- [Kontakt z pomocą techniczną](https://flashdata.dev/pl/contact)
