본문으로 건너뛰기
KO
API 키 받기
문서 둘러보기

가이드

recurring 대리인 업무를 실행하십시오

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_KEY
무료 액세스, 균형 및 가격 체크
set -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

CLI: 발생 당 1개의 작업을 저장하십시오

아래 작업 폴더를 작성하면 request.json 및 run-research.sh를 저장합니다. 이 폴더를 기존의 credential state 디렉토리에서 분리하십시오. 1개의 날짜는 1개의 Google 조회를 대표합니다; num는 결과의 수를 놓습니다. 첫 번째 실행 전에 자체 실행-ID 접두사로 다른 워크플로를 제공합니다.

작업 폴더 만들기
mkdir -p flashdata-research
cd flashdata-research
request.json
{
  "source": "google_search",
  "query": "battery recycling research",
  "params": {
    "num": 5
  }
}

저장 run-research.sh

작업 폴더에서 request.json 옆에 run-research.sh를 만듭니다. 아래 전체 스크립트를 복사하고 실행하기 전에 저장하거나 작업 스케줄링.

스크립트는 각 날짜에 입력을 동결하고 각 시도에 대한 영수증, 결과 및 오류 파일을 유지합니다. 성공적인 시도는 dated 폴더의 최고 수준에서 result.json 및 receipt.json를 게시합니다. --recurring는 소유자의 액세스를 확인합니다. 일정을 만들지 않습니다.

run-research.sh
#!/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"

한 번 실행하면 신선한 프로세스 재시동을 테스트합니다

작업 폴더에서 실행. 첫 번째 명령은 검색을 제출합니다. 두 번째는 동일한 계정, 입력, 프로필 및 상태를 사용하여 저장 된 결과를 읽을 수 있습니다. 그 액세스는 여전히 유효합니다.

1개의 파기절차 · 2개의 과정 시작
# 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를 즉시 저장하십시오; 재시작 후에, 다시 검색 대신 받아들인 일을 읽으십시오.

MCP 재순환 작업 · recurring-task.txt로 저장
스케줄러의 원래 발생률 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 스크립트를 실행할 수 있습니다.

recurring-task.txt
승인 된 실행 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는 자동 발표를 비활성화합니다. 작업 바디는 로컬 보고서를 유지합니다.

Bash · 장애인 작업을 만듭니다
: "${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.json

timed-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" --json

3. 산출을 검사한 후에 사용 가능

저장된 에이전트, 일정, 시간대 및 완료된 테스트를 검토합니다. 출력이 정확하고 반복 비용이 승인된 후에만 사용 가능. 나중에 중지를 중지 미래 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 --json
매일 일정을 사용
openclaw automations enable "$OPENCLAW_JOB_ID"
Pause 미래가 필요한 경우
openclaw automations disable "$OPENCLAW_JOB_ID"

비용 및 실패 규칙 설정

- 연혁조치
비용 계획쿼리당 가격 × 계획 발생. 모델과 호스트 비용을 별도로 추가하십시오. 결과 수는 쿼리 수 없습니다.
공유 계정 잔액스케줄러 또는 호스트에서 예산을 강화하십시오. 이 예제는 별도의 키 지출 캡을 부과하지 않습니다.
401 / 403 / 402일시적인 미래 파견. credentials, permission 또는 balance를 수정하십시오; 본래 파업 및 저장된 국가로 재개하십시오.
429전망 Retry-After. CLI 실행 또는 MCP가 새로운 제출이 안전하다는 것을 결정하기 전에 발생합니다.
알 수없는 제출 결과저장된 상태를 유지하고 중지합니다. 알려진 작업 ID 복구; 신선한 실행 ID를 만들지 않고 불확실성을 우회합니다.

일정을 중지하고 별도의 액세스 취소

  1. 스케줄러를 일시 중지합니다.
  2. 에이전트 연결, OAuth 앱 또는 콘솔의 API 키를 리턴합니다. Revocation 블록 새로운 인증 사용; 그것은 수출 된 파일을 지우지 않습니다.
  3. 신선한 공정에서 무료 액세스 체크를 반복합니다. 재발송 후 실패해야 합니다. CLI auth 로그아웃은 로컬 크리덴셜을 제거합니다. 원격 액세스가 해제되지 않습니다.