문서 둘러보기
가이드
Reuse 승인 된 액세스, 예정된 발생 당 하나의 검색을 실행, 실수로 동일한 작업을 다시 제출하지 않고 복구.
이 페이지의 내용
작업 실행 방법 선택
에이전트 호스트 또는 OS 스케줄러는 타이밍을 제공합니다. FlashData는 데이터를 공급합니다. 한 실행 경로를 선택하고 무인하게 실행되는 환경에서 테스트하십시오.
| 제품 정보 | 으로 | 국가 보존 |
|---|---|---|
| CLI | 터미널 액세스, cron, 또는 예정된 스크립트를 가진 대리인. | CLI 프로필, 주 디렉토리 및 원래 실행 ID. |
| MCP | 연결된 FlashData 서버와 함께 에이전트 호스트. | 호스트의 자격, 발생 기록, 작업 IDs 및 결과. |
예약된 환경에서의 액세스 확인
google_search 권한과 기존 소유자 연결을 재사용합니다. 사용의 앞에 임시 접근을 Claim. 신선한 예정된 과정 또는 세션에서 테스트, 대화형 일뿐만 아니라.
Bash 및 jq (Git Bash Windows)에서 OS 사용자가 키 저장. 기존 프로파일 이름과 절대 상태 디렉토리를 아래에 설정합니다. 동일한 맨끝에 있는 구획을 둘 다 달리십시오; 주자는 이 조정을 재사용합니다.
액세스 체크는 true를 인쇄해야합니다. availableCredits와 비교하여 첫 번째 검색 전에 estimatedCredits. 이 체크는 쿼리를 제출하지 않습니다.
# 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_KEYset -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신선한 예정된 세션에서 이것을 실행하십시오. 호스트 재사용 및 승인 된 OAuth 자격 증명을 새로 고침하십시오. 각 실행에서 대화형 로그인 없이 FlashData에 도달 할 수 있어야 합니다.
기존의 FlashData MCP 연결을 이 예정된 환경에서 재사용합니다.
{}와 get_balance를 호출합니다.
{"source":"google_search","request_count":1}와 get_pricing를 호출합니다.
균형과 예상된 가격을 보고하십시오. 새로운 접근을 검색하거나 만들지 마십시오.CLI: 발생 당 1개의 작업을 저장하십시오
아래 작업 폴더를 작성하면 request.json 및 run-research.sh를 저장합니다. 이 폴더를 기존의 credential state 디렉토리에서 분리하십시오. 1개의 날짜는 1개의 Google 조회를 대표합니다; num는 결과의 수를 놓습니다. 첫 번째 실행 전에 자체 실행-ID 접두사로 다른 워크플로를 제공합니다.
mkdir -p flashdata-research
cd flashdata-research{
"source": "google_search",
"query": "battery recycling research",
"params": {
"num": 5
}
}저장 run-research.sh
작업 폴더에서 request.json 옆에 run-research.sh를 만듭니다. 아래 전체 스크립트를 복사하고 실행하기 전에 저장하거나 작업 스케줄링.
스크립트는 각 날짜에 입력을 동결하고 각 시도에 대한 영수증, 결과 및 오류 파일을 유지합니다. 성공적인 시도는 dated 폴더의 최고 수준에서 result.json 및 receipt.json를 게시합니다. --recurring는 소유자의 액세스를 확인합니다. 일정을 만들지 않습니다.
#!/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"한 번 실행하면 신선한 프로세스 재시동을 테스트합니다
작업 폴더에서 실행. 첫 번째 명령은 검색을 제출합니다. 두 번째는 동일한 계정, 입력, 프로필 및 상태를 사용하여 저장 된 결과를 읽을 수 있습니다. 그 액세스는 여전히 유효합니다.
# 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결과가 재사용되었습니다
두 번째 영수증은 cached: true를 표시해야합니다. 그것의 사용법은 본래 수색에 속합니다. 빈 유기 배열은 아직도 성공적인 결과일 수 있습니다.
jq '{ok, runId, cached, usage}' runs/2026-11-04/receipt.json
jq '.results[0].organic | map({title, link})' runs/2026-11-04/result.json{
"schemaVersion": 1,
"ok": true,
"runId": "scheduled-research:2026-11-04:Asia-Shanghai",
"cached": true
}실행 사이에 파일을 유지
| 파일 | 제품 정보 |
|---|---|
| runs/DATE/request.json | 그 발생에 대한 정확한 입력; 변경 그것은 런너 정지. |
| runs/DATE/result.json + receipt.json | 마지막 성공적인 시도. 현재 명령이 성공적으로 종료한 후만 소모합니다. |
| runs/DATE/attempt.*/ | 실패를 포함하여 각 시도를 위한 결과, 영수증 및 과실. |
| FLASHDATA_STATE_DIR | 보호된 credentials 및 CLI는 기록을 달립니다. 동일한 프로파일과 OS 사용자를 유지하십시오. |
MCP: 발생과 일 ID를 지속
이 작업을 사용하여 튼튼한 작업 상태를 유지하고 발생 당 하나의 활성 실행을 허용 호스트와 함께합니다. 반환된 작업 ID를 즉시 저장하십시오; 재시작 후에, 다시 검색 대신 받아들인 일을 읽으십시오.
스케줄러의 원래 발생률 ID 및 예정된 시간을 사용하십시오.
기존 FlashData MCP 연결 및 저장된 발생 기록 재사용을 재사용합니다.
1. 이 발생이 완료되면, 검색하지 않고 저장된 결과를 반환합니다.
2. ID를 가지고 있다면 get_job를 job_id로 호출하여 기존 작업을 읽을 수 있습니다.
3. 제출이 시작되었지만 결과가 없거나 ID가 없으면 검토를 중지합니다.
4. 새로운 발생을 위해 get_balance 및 get_pricing를 한 google_search를 확인하십시오.
승인 된 per-task 예산 및 사용 가능한 균형 내에서만 계속하십시오.
5. google_search를 호출하기 전에 Persist submission_started :
{"query":"battery recycling pilot plant announcements","num":5,"gl":"us","hl":"en","tbs":"qdr:w","mode":"async"}
6. 반환된 작업 ID를 즉시 저장하십시오. 터미널까지 get_job로 읽으십시오. 실패를 멈추십시오.
Timeouts를 통해 ID를 유지하고 호스트의 마감일을 기다리십시오.
7. 결과 저장, 소스 URLs 및 사용, 다음이 발생을 표시 완료.
401, 403, 402, 429 또는 알 수없는 결과, 정지 및 저장된 레코드를보고.
명예 Retry-After. 대체 액세스 또는 다른 유료 쿼리를 만들지 마십시오.
보고서 로컬 유지; 별도로 구성하면 배달 목적지를 사용합니다.호스트가 persist해야 할 일
혼자의 신속한 복제를 방지 할 수 없습니다. MCP 통화는 CLI run-ID 보호를 상속하지 않습니다. 호스트는 원래 발생, 제출 상태 및 작업 ID를 지속해야합니다. 데이터 단계에 CLI 런너를 사용할 수 없습니다. 이 예제 기록은 호스트에 속합니다. MCP 요청이 아닙니다.
{
"occurrence": "research:2026-11-04:Asia-Shanghai",
"state": "accepted",
"job_id": "<returned job ID>",
"output": null
}시험된 업무 일정
아래 예는 09:00 Asia/Shanghai.에서 OpenClaw를 사용합니다. 작업이 비활성화 된 작업을 수동으로 저장하고 출력을 검사 한 다음 활성화하십시오. 다른 스케줄러의 경우, 테스트 실행 컨트롤과 동일한 순서에 따라 달라집니다.
| 을 읽다 | 제품 정보 |
|---|---|
| 계정 관리 | 이 작업 흐름에 대한 하나의 활성 실행, 튼튼한 상태와. |
| 런타임 | CLI, 작업 폴더 및 자격 상태에 대한 동일한 OS 사용자 및 절대 경로를 사용하십시오. 터미널 수출은 자동으로 실행 게이트웨이에 의해 상속되지 않습니다. |
| 관련 기사 | 자정을 지키며, 자정을 지키며, 수동 시험은 Asia/Shanghai.에서 그것의 invocation 날짜를 이용합니다 |
| 관련 상품 | 건너뛰기 또는 잡기 여부를 선택하십시오. 검색은 오늘 현재 데이터를 반환, 심지어 어제의 날짜로 라벨링. |
| 제품 정보 | 현지에서 먼저 저장하십시오. 보고서를 발송하기 전에 목적지 및 알림 정책을 구성하십시오. |
에이전트 호스트 CLI 작업 바디
프로필 및 경로 홀더를 대체, 다음 작업 폴더에서 recurring-task.txt을 저장. 이 몸을 사용 CLI 실행, 또는 MCP 위 몸 MCP 실행. 직접 OS 스케줄러는 모델없이 이러한 환경 변수를 가진 Bash 스크립트를 실행할 수 있습니다.
승인 된 실행 FlashData 연구 업무 OS 키를 저장하는 사용자.
주자: <run-research.sh로의 접근 경로>
runner 프로세스에 대한 이러한 환경 변수를 설정:
FLASHDATA_BIN: <플래쉬 데이터에 대한 접근 경로>
FLASHDATA_PROFILE: <existing profile name>
FLASHDATA_STATE_DIR: <모든 상태 디렉토리>
저장된 자격 증명을 재사용하기 위해 FLASHDATA_API_KEY를 설치하십시오.
Asia/Shanghai의 원래 일정한 날짜를 YYYY-MM-DD로 사용하십시오.
수동 실행을 위해, 실행하기 전에 그것의 invocation 날짜를 저장하십시오.
실행: bash "<absolute path to run-research.sh>" YYYYY-MM-DD
그 날짜를 유지 retries, 심지어 밤 후. 1개의 활동 실행을 허용하십시오.
동일한 프로파일을 유지, request.json 및 상태 디렉토리.
명령이 성공적으로 종료한 후 dated result.json만 읽습니다.
소스 링크, 실행 ID 및 사용. 출력을 로컬로 유지하십시오.
오류, 중지 및 저장된 오류를 보고합니다. 교체 작업을 시작하거나 새로운 액세스를 만들지 마십시오.1. 비활성화 OpenClaw 작업 만들기
게이트웨이와 기존 에이전트를 사용하여 액세스 확인을 통과했습니다. 아래 명령은 OpenClaw 2026.10.10를 사용; --wait가 사용할 수없는 경우 이전 클라이언트를 업데이트합니다. recurring-task.txt를 포함하는 폴더에서 OPENCLAW_AGENT_ID를 에이전트의 ID로 설정합니다.
명령은 기존 파일에 덮어쓰지 않고 openclaw-job.json를 저장합니다. OPENCLAW_JOB_ID를 리턴 작업 ID로 설정하십시오. 작성이 응답을 잃으면 자동화 목록 --all --json를 다른 작업을 만들기 전에 검사합니다. --no-deliver는 자동 발표를 비활성화합니다. 작업 바디는 로컬 보고서를 유지합니다.
: "${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
)2. 그것을 가능하게 하기 전에 저장된 일을 시험하십시오
한 번 저장된 작업을 실행하면 일정이 비활성화됩니다. 하나의 테스트 검색 및 모델 비용에 대한 예산; 일치하는 완료 CLI 발생은 결과를 재사용 할 수 있습니다. 이 명령은 10 분까지 기다립니다.
예상 completionStatus: 성공, 다음 저장 된 결과, 소스 링크 및 사용 확인. CLI의 경우 runs/DATE/result.json 및 receipt.json를 읽으십시오; MCP를 위해, 주인의 저장된 발생과 일 결과를 읽으십시오. enqueued: true는 혼자 받아들일 수 없는, 완료하지 않습니다.
: "${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
)cat openclaw-test-run.jsontimed-out 또는 실패 테스트 검사
타임 아웃은 대기, 게이트웨이 작업이 아닙니다. 영수증이 빈 경우에 최근의 역사를 읽으십시오. 설치하기 OPENCLAW_RUN_ID 으로 OpenClaw runId 영수증 또는 역사에서, 그 실행을 검사합니다. 실행 명령을 반복하지 마십시오.
이 스케줄러 실행 ID, 아니 FlashData recurring 런 ID 또는 MCP 데이터 작업 ID. 에이전트가 로그인하거나 데이터 작업을 수행 할 수 없으면 일정을 비활성화하고 첫 단계로 수리하십시오.
: "${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" --json3. 산출을 검사한 후에 사용 가능
저장된 에이전트, 일정, 시간대 및 완료된 테스트를 검토합니다. 출력이 정확하고 반복 비용이 승인된 후에만 사용 가능. 나중에 중지를 중지 미래 invocations; 그것은 이미 제출 된 쿼리를 취소하지 않습니다.
: "${OPENCLAW_JOB_ID:?Set the saved OpenClaw job ID}"
openclaw automations show "$OPENCLAW_JOB_ID" --json
openclaw automations runs "$OPENCLAW_JOB_ID" --limit 5 --jsonopenclaw automations enable "$OPENCLAW_JOB_ID"openclaw automations disable "$OPENCLAW_JOB_ID"비용 및 실패 규칙 설정
| - 연혁 | 조치 |
|---|---|
| 비용 계획 | 쿼리당 가격 × 계획 발생. 모델과 호스트 비용을 별도로 추가하십시오. 결과 수는 쿼리 수 없습니다. |
| 공유 계정 잔액 | 스케줄러 또는 호스트에서 예산을 강화하십시오. 이 예제는 별도의 키 지출 캡을 부과하지 않습니다. |
| 401 / 403 / 402 | 일시적인 미래 파견. credentials, permission 또는 balance를 수정하십시오; 본래 파업 및 저장된 국가로 재개하십시오. |
| 429 | 전망 Retry-After. CLI 실행 또는 MCP가 새로운 제출이 안전하다는 것을 결정하기 전에 발생합니다. |
| 알 수없는 제출 결과 | 저장된 상태를 유지하고 중지합니다. 알려진 작업 ID 복구; 신선한 실행 ID를 만들지 않고 불확실성을 우회합니다. |
일정을 중지하고 별도의 액세스 취소
- 스케줄러를 일시 중지합니다.
- 에이전트 연결, OAuth 앱 또는 콘솔의 API 키를 리턴합니다. Revocation 블록 새로운 인증 사용; 그것은 수출 된 파일을 지우지 않습니다.
- 신선한 공정에서 무료 액세스 체크를 반복합니다. 재발송 후 실패해야 합니다. CLI auth 로그아웃은 로컬 크리덴셜을 제거합니다. 원격 액세스가 해제되지 않습니다.