Przeglądaj dokumentację
Poradniki
Odzyskiwanie przerwanego zadania CLI lub MCP za pomocą zapisanego uruchomienia, zadania lub wyniku ID.
Na tej stronie
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. |
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.
# 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: "${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-interactiveWybierz 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. |
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.
: "${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-interactiveSprawdź 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. |
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. |
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.
: "${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-interactive3. 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.
: "${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-interactiveCzas wyborów zatrzymuje lokalne czekanie. Uruchom to polecenie odzyskiwania, żeby czekać na tę samą pracę.
: "${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-interactivePotwierdzenie odzyskania pomocy przed wznowieniem
- 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.
- 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ę.
- Wznowienie planowania tylko po uzyskaniu dostępu i wynik jest weryfikowany. Dać każdemu nowemu planowemu zdarzeniu swój własny bieg ID.
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.
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.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.
{
"name": "get_job",
"arguments": {
"job_id": "job_REPLACE_WITH_SAVED_ID"
}
}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. |
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.
- 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.
- 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.
- 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.
{
"name": "get_result",
"arguments": {
"result_id": "REPLACE_WITH_RESULT_ID",
"offset": 0
}
}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.
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. |
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.
# Read a saved CLI error envelope; no network request.
jq '{ok, runId, error: (.error | {
code, httpStatus, retryAfter, runId, remoteId
})}' error.json