> ## Documentation Index
> Fetch the complete documentation index at: https://docs.tryprofound.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Sheets から Agents を実行する

> Sheet を設定し、入力をマッピングして、すべての行に対して Agent を実行します

Profound Sheets を使用すると、大量の入力に対して [Agent ワークフロー](/agents/about)を同時に実行できます。入力ごとに 1 つずつ Agents を起動するのではなく、Sheets では数百から数千件の入力を並行して処理できます。

## Sheet に Agent を追加する

Sheet に Agent を追加するには、次の手順に従います。

1. ヘッダー行で最後に使用されている列見出しの横にある **+ Add Column** をクリックします。

   <img src="https://mintcdn.com/profound-37face47/d3tYUJ4mfdayQ4Zm/images/sheets/run-agents-from-sheets-1.png?fit=max&auto=format&n=d3tYUJ4mfdayQ4Zm&q=85&s=8c6b77573c82d358ed5a50f8d72d68c1" alt="Add column がハイライトされ、Agent オプションを含む列の種類メニューが開いた Sheet" width="1424" height="1078" data-path="images/sheets/run-agents-from-sheets-1.png" />
2. 列の種類メニューから **Agent** を選択します。
3. **Add an Agent** ダイアログで、実行する Agent を選択するか、新しい Agent を作成します。
4. 画面の指示に従って Agent の入力列と出力列を設定し、Sheet に追加します。

Agent 列は、他の列と並んで Sheet のグリッドに表示されます。その列の各行には **Run** ボタンが表示され、起動されるとその行の入力を処理できる状態であることを示します。

## Sheet から Agent を実行する

### 単一実行

1 つの行で [Agent を実行](/agents/agent-runs)するには、その行の Agent 列のセル内にある **Run** ボタンをクリックします。Agent がその行の入力を処理し、完了すると出力がセルに直接返されます。

<img src="https://mintcdn.com/profound-37face47/2mGao8qF1TMHCUpR/images/sheets/run-agents-from-sheets-2.png?fit=max&auto=format&n=2mGao8qF1TMHCUpR&q=85&s=ceabbef6a2632c3bb250f56fb038e619" alt="Screen Shot 2026-04-03 at 12.00.59 PM.png" width="2276" height="628" data-path="images/sheets/run-agents-from-sheets-2.png" />

セルのステータスが実行中に更新され、完了すると緑色の **Completed** インジケーターが表示されます。単一実行は、列全体を実行する前に、特定の入力で Agent の設定をテストするのに便利です。

### 一括実行

すべての行で Agent を一度に実行するには、Agent 列の見出し上部にある **Run** をクリックします。これにより、Sheet 内で入力データのあるすべての行に対して Agent が同時に起動し、すべての入力が並行して処理されます。

各セルのステータスがリアルタイムで **Run** から実行中、そして各 Agent の完了に伴い **Completed** へと更新されるので、進行状況を確認できます。

<Warning>Agents は**必要な入力が揃っている場合にのみ**実行されます。たとえば、100 行あっても必要な入力が含まれているのが 13 行だけの場合、Agent はその 13 行に対してのみ実行されます。</Warning>

## 出力を扱う

Agent の実行が完了すると、その出力は該当する行の出力セル（**Add an Agent** ダイアログで設定したもの）に表示されます。Agent 列の横に別の Text 列または Long text 列を追加すると、出力を記録したり、ラベルや注釈を付けたりできます。

Agent の出力を後続の処理で使用するには、その列の値を他の列やワークフローの入力として参照します。
