メインコンテンツへスキップ

Documentation Index

Fetch the complete documentation index at: https://docs.therefrain.ai/llms.txt

Use this file to discover all available pages before exploring further.

​
概要

メモリ操作により、複数のステップやループの反復にわたってデータを収集・集計できます。データは名前付きコレクションに保存され、実行全体を通じて永続化します。

​
2つの操作タイプ

タイプ説明用途
appendコレクションにアイテムを追加行、レコード、キャプチャ値の蓄積
aggregateコレクションのサマリーを計算合計、カウント、最小/最大値の算出

​
append

キャプチャした値を名前付きコレクションに追加します： 
steps:
  - ordinal: 0
    description: "商品データを抽出"
    action:
      type: extract
      script: "document.querySelector('.product-name').textContent"
    url: "https://app.example.com/products"
    riskLevel: low
    requiresConfirmation: false
    captures:
      - name: productName
        strategy: snapshot
        description: "商品名"
    memoryOperations:
      - type: append
        collection: products
        source: productName
フィールド型必須説明
type"append"Yes操作タイプ
collectionstringYes対象コレクション名
sourcestringNo追加するキャプチャ変数名

​
aggregate

コレクションからサマリー値を計算します： 
steps:
  - ordinal: 5
    description: "合計を計算"
    action:
      type: memory
    url: "https://app.example.com/products"
    riskLevel: low
    requiresConfirmation: false
    memoryOperations:
      - type: aggregate
        collection: prices
        operation: sum
        field: price
        outputVariable: totalPrice
フィールド型必須説明
type"aggregate"Yes操作タイプ
collectionstringYesソースコレクション名
operationAggregateOpYes集約操作
fieldstringNo集約対象フィールド
outputVariablestringNo結果を格納する変数

​
集約操作

操作説明結果例
sum数値の合計1500
countアイテム数25
avg数値の平均60.5
min最小値10
max最大値200
concat文字列値の連結"A, B, C"
unique_countユニーク値の数18

​
完全な例

商品リストを複数ページにわたってスクレイピングし、CSV にエクスポートします： 
title: 商品カタログのスクレイピング
steps:
  - ordinal: 0
    description: "商品リストに遷移"
    action:
      type: navigate
      url: "https://store.example.com/products"
    url: "https://store.example.com/products"
    riskLevel: low
    requiresConfirmation: false

  - ordinal: 1
    description: "現在のページの商品をループ処理"
    action:
      type: extract
      script: "JSON.stringify([...document.querySelectorAll('.product')].map(e => e.textContent))"
    url: "https://store.example.com/products"
    riskLevel: low
    requiresConfirmation: false
    loop:
      forEach: "collection:productElements"
      itemVariable: product
      maxIterations: 100
    steps:
      - ordinal: 0
        description: "商品名をキャプチャ"
        action:
          type: extract
          script: "document.querySelector('.product-name').textContent"
        url: "https://store.example.com/products"
        riskLevel: low
        requiresConfirmation: false
        captures:
          - name: name
            strategy: snapshot
        memoryOperations:
          - type: append
            collection: products
            source: name

  - ordinal: 2
    description: "商品数をカウント"
    action:
      type: memory
    url: "https://store.example.com/products"
    riskLevel: low
    requiresConfirmation: false
    memoryOperations:
      - type: aggregate
        collection: products
        operation: count
        outputVariable: productCount

  - ordinal: 3
    description: "商品を CSV にエクスポート"
    action:
      type: export
      exportCollection: products
      exportFormat: csv
      exportPath: "./output/products.csv"
    url: "https://store.example.com/products"
    riskLevel: low
    requiresConfirmation: false

​
コレクションの反復処理

forEach ループで collection:name 構文を使用してコレクション内のアイテムを反復処理できます： 
loop:
  forEach: "collection:products"
  itemVariable: product
ループの詳細はループ・分岐を参照してください。