Environment スキーマ

​

Environment オブジェクト

​

Environment config

{"type": "self_hosted", "setup_script": "./initialize-worker.sh"}

​

Environment packages

​

Environment setup script

{
  "config": {
    "type": "cloud",
    "setup_script": "set -euo pipefail\n[ -d /data/workspace/repo/.git ] || git clone https://github.com/me/repo /data/workspace/repo\ncd /data/workspace/repo && pnpm install --frozen-lockfile"
  }
}

​

Environment startup script

• スクリプトは終了する必要があります。常駐プロセスはバックグラウンドで実行し、出力をファイルにリダイレクトします（例：nohup pnpm dev > /tmp/dev.log 2>&1 &）。これらのプロセスはスクリプトの正常終了後も動作し続けます。フォアグラウンドで動作して終了しないコマンドは、タイムアウトまでツール呼び出しをブロックします。
• スクリプトの終了はサービスの準備完了を意味しません。スクリプトが終了するとすぐに agent の最初のツール呼び出しが始まりますが、バックグラウンドで起動したサービスは待ち受け開始まで数秒かかる場合があります。agent がすぐにサービスを使用する必要がある場合は、スクリプトの末尾でポートが利用可能になるのを待ってから終了します（例：for i in $(seq 30); do curl -sf -o /dev/null localhost:3000 && break; sleep 1; done）。
• タイムアウト時はスクリプトと、それが起動したバックグラウンドプロセスが停止され、失敗として扱われます。
• 再開時に以前のプロセスが動作している場合があります（一部のランタイムは一時停止中もメモリを保持）。そのため、スクリプトはサービスがすでに動作している場合に対応する必要があります（例：pgrep -x redis-server || redis-server --daemonize yes）。スクリプトにも含まれる文字列を pgrep -f で検索しないでください。実行中の shell のコマンドラインにスクリプト全文が含まれて一致してしまい、サービスが起動されなくなります。pgrep -x でプロセス名を確認するか、サービスのポートを確認してください。
• 同じ起動内では最大 1 回実行されます。実行開始前に記録されるため、途中で中断されても同じ起動内では再実行されず、次回起動時に再実行されます。

{
  "config": {
    "type": "cloud",
    "packages": {"apt": ["redis-server"]},
    "startup_script": "pgrep -x redis-server || redis-server --daemonize yes\ncurl -s -o /dev/null localhost:3000 || (cd /data/workspace/repo && nohup pnpm dev > /tmp/dev.log 2>&1 &)"
  }
}

​

Environment storage

{
  "type": "cloud",
  "storage": {
    "buckets": [
      {
        "name": "datasets",
        "provider": "aliyun-oss",
        "region": "cn-hangzhou",
        "bucket": "my-bucket",
        "prefix": "team/data/",
        "access": "read_only",
        "credential": {"type": "ram_role", "role_arn": "acs:ram::1234567890123456:role/qoder-oss-mount"}
      }
    ]
  }
}