Przejdź do treści
PL
Uzyskaj klucz API
Przeglądaj dokumentację

Poradniki

Odzyskiwanie integracji agenta

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.

MaszStosowanie
CLI runIdCLI 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 IDOpenClaw 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.

Wybierz istniejące zadanie · ten terminal
# 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
: "${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

Wybierz działanie w zakresie odzyskiwania

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

Status zapisanyCo zrobić
succeededSprawdź dostęp, a następnie eksportuj zapisany wynik w kroku 3.
acceptedSprawdź dostęp, a następnie odzyskać przyjęte zadanie w kroku 3.
uncertain / intentWstrzymaj się z zadaniem. Sprawdź remoteId, candidateRemoteIds i History przed podjęciem decyzji, czy należy coś ponownie złożyć.
failedNapraw najpierw errorCode. Nieudany rekord jest zachowany; zastępstwo jest nowym zadaniem i może korzystać z kredytów.
partialZachowaj 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_foundSprawdź 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.

Weryfikacja dostępu i odczyt salda
: "${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

Sprawdź te pola

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

Pole auth statusOczekiwane
data.accessVerifiedtrue; w przeciwnym razie należy naprawić dostęp przed odczytem wyników.
data.identity.identity.accountIdKonto, które złożyło to zadanie.
data.identity.permittedSourcesZawiera źródło wykorzystywane przez zapisane zadanie.
data.identity.identity.recurringAllowedtrue 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.

SytuacjaDziałanie
Złe kontoSprawdź nadrzędne sterowanie kluczem środowiskowym, wybrany profil i pochodzenie management/data. Przywrócić zamierzone konto przed odzyskaniem.
Klucz obróconyUżyj klucza zastępczego dla tego samego konta z wymaganym pozwoleniem źródła. Zachowaj oryginalny profil, katalog stanu i uruchom ID.
Zatwierdzony procesKonto 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.

Zakończ istniejące przekazanie
: "${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

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.

Eksportuj zapisany wynik
: "${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

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.

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

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

Sprawdź status zadania MCP

OdpowiedźNastępna akcja
job.status: pending / processingCzekaj, potem przeczytaj to samo ID. Lokalny timeout nie anuluje go.
job.status: completedZapisz 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: trueOdczytaj błąd przed użyciem jakiegokolwiek wyjścia. Nie uruchamiaj źródła automatycznie.
code: result_unavailableNależ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.

  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
{
  "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 / 422Sprawdzić 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 / 403Dla 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.
402Przerwać nową pracę, dopóki właściciel nie ustali finansowania.
406Użyj Accept: application/json. W przypadku obsługiwanych punktów końcowych zawartości, prosimy o Markdown z X-Respond-With: markdown.
429Honor 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_conflictPrzywróć oryginalne wejście. Nowe wejście wymaga celowego nowego zadania i uruchomić ID.
run_account_mismatchUżyj listy kontrolnej recordt- change w kroku 2; nowy bieg ID nie jest skrótem do odzyskiwania.
output_existsWybierz nową nazwę pliku wyjściowego. Zachowaj zapisany bieg.
result_unavailableDla 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.

Wybierz pola diagnostyczne · tylko lokalne
# Read a saved CLI error envelope; no network request.
jq '{ok, runId, error: (.error | {
  code, httpStatus, retryAfter, runId, remoteId
})}' error.json