> ## 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.

# Agents で Excel を使用する

> Microsoft Excel の Agent ノードで Excel ワークブックを読み書きします

[Microsoft SharePoint を接続](/ja-jp/integrations/microsoft-365/connect-microsoft-sharepoint-to-profound)すると、Profound Agents の **Microsoft Suite** > **Microsoft Excel** で以下のノードが利用可能になります。これらのノードを使用して、ワークブックから値や行を読み取ったり、セルや行を書き戻したり、新しいワークブックやワークシートを作成したりできます。

すべてのノードは、**Microsoft Account** で選択したアカウントの権限で実行されます。ノードがアクセスできるのは、接続されたアカウントで開けるファイルのみです。

<Note>
  Agents を初めてお使いの場合は、Profound Help Center の [Getting started with Agents](https://help.tryprofound.com/articles/2212787792-create-an-agent) をご覧ください。
</Note>

## 共通設定

既存のワークブックを操作するすべてのノードは、**Workbook** と、オプションの **Worksheet name** を受け取ります。ワークシートを空のままにすると、最初に表示されているワークシートが使用されます。[**Create Workbook**](#create-workbook) は新しいファイルを作成するため、**Workbook** フィールドはありません。

### ワークブックの選択

ノード設定で **Microsoft Account** を選択してから、次のいずれかの方法でワークブックを選択します。

* **Workbook** フィールドで**名前で検索**します。検索の対象は Microsoft がインデックスを作成したファイルのみのため、作成したばかりのファイルはまだ表示されない場合があります。
* 同じフィールドにワークブックの **SharePoint または OneDrive のリンクを貼り付け**ます。
* リストの下部にある **Browse workbooks in OneDrive or SharePoint** を選択して**参照**します。Microsoft のファイルピッカーが開き、検索ではまだ表示されないファイルも見つけられます。
* 前のノードの出力から**変数を使用**します。たとえば、[**Create Workbook**](#create-workbook) が返す `workbook_ref` などです。

これらのノードは `.xlsx` および `.xlsm` ファイルに対応しています。

### Value property

いくつかのノードでは、**Advanced settings** に **Value property** があります。これは、セルの値の扱い方を制御します。

* **Values** — 値を入力どおり、または読み取りノードが返したとおりに解釈します。たとえば `10` は数値の 10 になり、`=A1+1` は数式になります。
* **Formulas** — そのフィールド内のすべての値を数式として扱います。
* **Text** — セルを表示されているとおりに返します。[Get Values](#get-values) などの読み取りノードでのみ使用できます。

1 回の書き込みで扱えるセルは最大 100,000 個で、1 つのセルには最大 32,767 文字を格納できます。15 桁を超える数値は、Excel によって丸められないようにテキストとして書き込まれます。

## 利用可能なノード

<Tabs>
  <Tab title="Get Values" icon="table">
    ### Get Values

    セル範囲の値を読み取ります。

    #### 必須の入力

    * **Microsoft Account** — ドロップダウンから接続済みのアカウントを選択します
    * **Workbook** — ワークブックを名前で検索するか、SharePoint または OneDrive のリンクを貼り付けるか、参照して選択します

    #### オプションの入力

    | 入力 | デフォルト | 説明 |
    | - | - | - |
    | **Worksheet name** | 最初に表示されているワークシート | 値を読み取るワークシート。 |
    | **Range** | 使用範囲(値が入っているセルの範囲) | `A1:D10` のような A1 形式のセル範囲。ワークシート内のすべての値を読み取るには空のままにします。 |
    | **Value property**(**Advanced settings** 内) | **Values** | 返すセルのプロパティ。詳しくは [Value property](#value-property) をご覧ください |
    | **Output format**(**Advanced settings** 内) | **Rows (2D array)** | 出力の形式: **Rows (2D array)**、**Records (list of dicts)**、**Columns (dict of lists)**、**CSV (string)**、**TSV (tab-separated)**、**HTML table**、**Markdown table**、**Raw (full API response)**。**Records** と **Columns** は、範囲の最初の行を列名として使用します。 |

    #### 出力

    選択した形式の値、出力形式、ワークブックの参照 ID、ワークシート名、読み取ったセル範囲を含む JSON オブジェクト。

    <Tip>
      [**Create Workbook**](#create-workbook) で値を書き戻すには、このノードの出力形式とそのノードの入力形式に同じ形式を選択してください。
    </Tip>
  </Tab>

  <Tab title="Get Row" icon="table-rows">
    ### Get Row

    ワークシートの 1 行を読み取ります。

    #### 必須の入力

    * **Microsoft Account** — ドロップダウンから接続済みのアカウントを選択します
    * **Workbook** — ワークブックを名前で検索するか、SharePoint または OneDrive のリンクを貼り付けるか、参照して選択します
    * **Row selection** — **Specific row**(デフォルト)、**First row**、**Last row** のいずれか
    * **Row number** — **Row selection** が **Specific row** に設定されている場合に必須です。行番号は `1` から `1,048,576` までです

    #### オプションの入力

    * **Worksheet name** — 行を読み取るワークシート。デフォルトは最初に表示されているワークシートです
    * **Range** — 行を読み取る列を制限します。たとえば `A1:D10` を指定すると、列 A から D のみが返されます。データが入っているすべての列を読み取るには空のままにします

    #### 出力

    値の配列としての行、行番号、および各行の値と最初の行の列名を対応付けた `record` フィールドを含む JSON オブジェクト。

    読み取った行が最初の行である場合、`record` フィールドは空になります。
  </Tab>

  <Tab title="Update Cell" icon="pen-to-square">
    ### Update Cell

    1 つのセルに値を書き込みます。

    #### 必須の入力

    * **Microsoft Account** — ドロップダウンから接続済みのアカウントを選択します
    * **Workbook** — ワークブックを名前で検索するか、SharePoint または OneDrive のリンクを貼り付けるか、参照して選択します
    * **Cell** — 書き込み先のセル(例: `B2`)
    * **Value** — 書き込む値。テキスト、数値、ブール値、または `=SUM(A1:B1)` のような数式を指定できます。数式を書き込むには、**Value property** で **Formulas** を選択してください

    #### オプションの入力

    * **Worksheet name** — 書き込み先のワークシート。デフォルトは最初に表示されているワークシートです
    * **Value property**(**Advanced settings** 内) — **Values**(デフォルト)または **Formulas**。詳しくは [Value property](#value-property) をご覧ください

    #### 出力

    ワークブックの参照 ID と URL、ワークシート名、更新されたセル範囲、更新されたセル数を含む JSON オブジェクト。
  </Tab>

  <Tab title="Write Rows" icon="list">
    ### Write Rows

    ワークシートに行を追加または更新します。

    #### 必須の入力

    | 入力 | 説明 | 備考 |
    | - | - | - |
    | **Microsoft Account** | ドロップダウンから接続済みのアカウントを選択します | - |
    | **Workbook** | ワークブックを名前で検索するか、SharePoint または OneDrive のリンクを貼り付けるか、参照して選択します | - |
    | **Mode** | **Add rows**(デフォルト)は、最後の空でない行の後に行を追加します。**Update rows** は既存の行を上書きします | - |
    | **Row data format** | **Arrays**(デフォルト)または **JSON Objects** | 詳しくは [Row data の形式](#how-to-shape-row-data) をご覧ください |
    | **Row data** | 書き込む行 | [Row data の形式](#how-to-shape-row-data) をご覧ください |

    #### **Row data** の形式

    | Row data format | Mode | 形式 | 例 |
    | - | - | - | - |
    | **Arrays** | **Add rows** | 内側の各配列がワークシートの 1 行になります。値は順番に各列に書き込まれます | `[["Alice", "alice@example.com", 90], ["Bob", "bob@example.com", 85]]` |
    | | **Update rows** | 内側の各配列の最初の値は、更新する行の番号です | `[[1, "Alice", "alice@example.com", 95], [3, "Charlie", "charlie@example.com", 88]]` |
    | **JSON Objects** | **Add rows** | 各オブジェクトのキーは列の文字です | `[{"A": "Alice", "B": "alice@example.com", "C": 90}]` |
    | | **Update rows** | 各オブジェクトには、更新する行の番号を示す `row_number` キーも含めます | `[{"row_number": 1, "A": "Alice", "B": "alice@example.com"}]` |

    #### オプションの入力

    * **Worksheet name** — 書き込み先のワークシート。デフォルトは最初に表示されているワークシートです
    * **Value property**(**Advanced settings** 内) — **Values**(デフォルト)または **Formulas**。詳しくは [Value property](#value-property) をご覧ください
    * **Start column**(**Advanced settings** 内) — 書き込みを開始する列(例: `A` や `E`)。最初の列(`A`)から開始するには空のままにします

    #### 出力

    ワークブックの参照 ID と URL、ワークシート名、更新されたセル範囲、作成および更新された行数を含む JSON オブジェクト。

    <Note>
      **Update rows** モードでは、行は 1 行ずつ書き込まれます。途中で Excel が競合を報告した場合、それより前に書き込まれた行はそのまま残ります。同じセルを書き直すには、ノードを再度実行してください。
    </Note>
  </Tab>

  <Tab title="Create Workbook" icon="file-plus">
    ### Create Workbook

    ワークブックを作成するか、既存のワークブックにワークシートを追加します。

    #### 必須の入力

    | 入力 | 説明 | 備考 |
    | - | - | - |
    | **Microsoft Account** | ドロップダウンから接続済みのアカウントを選択します | - |
    | **Title** | 新しいワークブックの名前、または **Add to Existing Workbook** が設定されている場合は新しいワークシートの名前 | 拡張子を付けずに名前を入力します。ノードが自動的に `.xlsx` を付加します |
    | **Rows** | 新しいワークブックまたはワークシートに書き込むデータ | データ形式は **Input format** で選択します |
    | **Input format** | 書き込むデータの形式: **JSON**(デフォルト)、**Markdown table**、**CSV**、**TSV (tab-separated)**、**HTML table** | JSON では、オブジェクトの配列、配列の配列、または各列名を値のリストに対応付けたオブジェクトを受け付けます |

    #### オプションの入力

    | 入力 | デフォルト | 説明 |
    | - | - | - |
    | **Add to Existing Workbook** | 空 | 新しいワークブックを作成するには空のままにします。代わりにワークシートを追加するには、ワークブックを選択します。**Destination folder** と **Worksheet name** は既存のワークブックには適用されないため、ワークブックを選択すると非表示になります。 |
    | **Destination folder** | OneDrive のルート | 新しいワークブックを保存するフォルダー。フォルダーを名前で検索するか、リンクを貼り付けるか、参照して選択します。 |
    | **Worksheet name**(**Advanced settings** 内) | `Sheet1` | 新しいワークブックの最初のワークシートの名前。 |
    | **Value property**(**Advanced settings** 内) | **Values** | **Values** または **Formulas**。詳しくは [Value property](#value-property) をご覧ください |

    #### 出力

    ワークブックの参照 ID、URL、タイトル、およびデータが書き込まれたワークシート名を含む JSON オブジェクト。

    <Tip>
      [**Get Values**](#get-values) の出力を新しいワークブックに保存するには、そのノードの **Output format** とこのノードの **Input format** で同じ形式を選択してください。
    </Tip>
  </Tab>
</Tabs>

## トラブルシューティング

Excel ノードが報告するエラーについては、[Microsoft 365 のセットアップと Agent エラーのトラブルシューティング](/ja-jp/integrations/microsoft-365/microsoft-365-integrations-troubleshooting#excel) をご覧ください。