S3アップローダー
このスキルは、自動化ランで永続的な成果物ストレージが必要な場合に使用します。CSVレポート、PDF、JSONチェックポイント、スクリーンショット、モデル出力、ログなど、ローカルマシンの外部に保存すべきファイルを扱います。ヘルパーは汎用S3互換ストレージを対象とし、バケット、エンドポイント、認証情報を環境変数からのみ読み取ります。
使用するタイミング
- ユーザーが「このレポートをS3にアップロードして」「成果物をオブジェクトストレージに保存して」「最後の実行ファイルをダウンロードして」「MinIO/R2/Spacesを使って」と言った場合。
- 会話内のコードがローカルにファイルを書き込んでいるが、ポータブルな受け渡しやアーカイブ場所が必要な場合。
使用してはいけないタイミング
- 成果物が同じプロセス内でのみ必要な場合(そのままディスクに保持)。
- ユーザーがパブリックWebサイトCDNワークフロー(キャッシュ無効化や署名付きURLが必要)を必要としている場合。
具体的な例
ユーザー入力:
スクレイパー終了後に、生成されたCSVを私のS3互換バケットにアップロードしてください。
出力:
# assets/s3.py をプロジェクトにコピーし、次を実行:
from s3 import upload_file
key = upload_file("out/daily_report.csv", key="reports/daily_report.csv")
print("アップロード完了:", key)
ヘルパーはS3_BUCKET、S3_ACCESS_KEY_ID、S3_SECRET_ACCESS_KEY、オプションでS3_ENDPOINT_URLとS3_REGIONを環境変数から読み取ります。ターゲット固有の情報や秘密情報はコミットされません。
適用するパターン
- バケット名、エンドポイント、アクセスキー、シークレットキーは必ず環境変数にのみ保持します。
- 決定論的なオブジェクトキーを使用します(例:
reports/YYYY-MM-DD/name.csv)。これにより再実行時に簡単に見つけられます。 - ローカルファイルの書き込みが完全に終了した後にのみアップロードし、書き込み途中の成果物をストリームすることはありません。
- S3互換エンドポイントをサポートするには、
endpoint_urlをAWSをハードコードする代わりに渡します。 - 環境変数やクライアントライブラリがない場合は、明確な設定エラーを表示して失敗します。
参考:assets/s3.py。
ソース
作者の自動化プロジェクトでの本番利用から抽出されました。v1.0.0。
関連スキル:[[csv-report-writer]]、[[playwright-pdf-snapshot]]、[[pipeline-orchestrator]]。
→ Trawlkitで完全な実行可能ボットを構築しましょう。