メインコンテンツへスキップ
フローに渡すURLやファイルの種類に合わせて入力ツールを選び、結果を次のステップに渡します。

ファイル入力ツールを選ぶ

ファイル入力ツールを使用すると、指定された URL からファイルを取得できます。

主な機能

  • INPUT_PDF_FILE: URL から PDF ファイルを取得
  • INPUT_CSV_FILE: URL から CSV ファイルを取得
  • INPUT_DOCX_FILE: URL から DOCX(Word)ファイルを取得し、抽出したテキストを返す
  • INPUT_JSON: JSON データを直接入力
  • INPUT_FILE: 任意のファイルを URL から入力
  • INPUT_TEXT: プレーンテキストを直接入力

ツール

INPUT_PDF_FILE

URL から PDF ファイルを取得して処理に渡します。 入力:
  • value(string、必須): 取得する PDF ファイルの URL
出力:
  • 後続処理用のファイル内容とメタデータ

INPUT_CSV_FILE

URL から CSV ファイルを取得し、行データとして解析します。 入力: 出力:
  • result: 解析された行の配列(ヘッダー行を含め、1 行ごとに文字列の配列)。value に 2 件以上の URL の配列を渡した場合、result はファイルごとの行配列をまとめた配列になります(1 件だけの配列は単一の行配列になります)。
CSV は RFC 4180 の規則で解析されます。引用符で囲まれたフィールドにはカンマや改行を含めることができ、引用符内の "" はリテラルの " に復元されます。先頭の BOM は除去され、空行はスキップされ、フィールド数が異なる行も拒否されずそのまま保持されます。閉じられていない引用符がある場合は、ファイルの残りを黙って捨てるのではなく、問題の開始位置のレコードを示す ValidationError でステップが失敗します。 後続ステップで行やセルを扱う場合はこちらを使ってください。文字化けする場合は encoding に shift_jis などを指定してください。変換の例は下の「例:CSV ファイルを集計する」を参照してください。

INPUT_DOCX_FILE

URL 上の DOCX(Word)ファイルを読み込み、抽出したテキストを返します。 入力: 出力:
  • result: DOCX ファイルから抽出されたテキスト

INPUT_JSON

JSON データを文字列として直接入力します。 入力:
  • value(string、必須): 解析する JSON 文字列
出力:
  • 後続処理で利用できるパース済みの JSON データ

INPUT_FILE

任意のファイルを URL から入力します。 入力: 出力:
  • result: 取得したファイルの URL 文字列(value が配列の場合は URL の配列)。ファイル URL を受け取る後続ステップにそのまま渡します。ファイルの中身は出力に含まれません。
  • filenames / extensions: URL から抽出したファイル名と拡張子(result と同じ形)。

INPUT_TEXT

プレーンテキストを直接入力します。 入力:
  • value(string、必須): プレーンテキストの内容
出力:
  • 後続処理用のテキスト内容

例

例:URL からファイルを取得する

例:CSV ファイルを集計する

売上 CSV を読み込み、Python で地域ごとの amount 列を合計してから、モデルにレポートを作成させます。
{{steps.sales_csv.result}} は JSON テキストとして挿入されるため、json.loads でヘッダー行を先頭とする行のリストになります。セルは文字列なので、数値は自分で変換してください。出力した JSON は steps.summarize_sales.result.data(例:result.data.total_sales)に入り、レポート本文は steps.sales_report.result.content に入ります。amount と region はファイルのヘッダー行に合わせて変更してください。

例:JSON データの処理

ダウンロードの上限

ファイル入力ツール(INPUT_FILE、INPUT_PDF_FILE、INPUT_CSV_FILE、INPUT_DOCX_FILE、INPUT_IMAGE_FILE、INPUT_FILE_AS_TEXT)は、取得する URL ごとに次の上限を適用します。 上限を超えたステップは、ファイルの残りをダウンロードせずに失敗します。リスト内の 1 ファイルが失敗した場合、進行中の他のダウンロードも停止します。また INPUT_CSV_FILE と INPUT_IMAGE_FILE は、URL が HTTP エラーのステータスを返した場合、エラーページをデータとして読み込まずに失敗します。

関連する入力ツール

以下の入力ツールは別のページで説明しています。