> For the complete documentation index, see [llms.txt](https://docs.allganize.ai/alli-llm-app-market/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.allganize.ai/alli-llm-app-market/manual/document/table-agent.md).

# Excelファイルをテーブルデータとして実行して利用する

Excelファイルを、検索精度と結果の一貫性を最大限に高める構造化データベース形式に変換します。シート単位で、「この列は何の情報か」というデータの型をダッシュボード上で直接確認・編集できます。完成したデータは自動的にデータベース化され、LLMがより効果的に分析できるようになります。これにより、正確で信頼性の高い回答や分析結果を生成できます。

※この機能は、.csv、.xls、.xlsx形式のExcelファイルでのみご利用が可能です。.docxなどの他のファイル形式ではご利用いただけません。

### 1.Excelファイルをアップロードする <a href="#upload-file" id="upload-file"></a>

ダッシュボードからExcelファイルをアップロードすると、<img src="/files/xgbg17JmWs0JZ6PeWFX4" alt="" data-size="line"> が表示されます。このアイコンは、文書に対する編集権限を持つメンバーのみに表示されます。

<figure><img src="/files/otyGuKiXWaGHJI0mBDDW" alt=""><figcaption></figcaption></figure>

<img src="/files/ku9FGPwpPjzp7FrBpX8z" alt="" data-size="line"> をクリックすると、Excelファイルのテーブル範囲、ヘッダー（列名）、データ型などを設定する画面に遷移します。

手順[3.データベースとして保存する](#id-3dtabsutoshitesuru)にて、\[データベースに変換]ボタンをクリックするまでは、従来と同様にExcelファイルがマークダウン形式で解析されます。

### 2.テーブルデータを追加する <a href="#add-data" id="add-data"></a>

画面左：アップロードしたExcelファイルのプレビューが表示されます。\
画面右：Excelファイルに基づいてテーブルデータを編集することができます。

{% hint style="warning" %}
Excelテーブルデータには、列数や行数の制限はありません。\
ただし、テーブルデータのプレビュー表示のみ、デフォルトでは1000行までの表示制限があります。\
その際は、画面上部に「ソースファイルを参照してテーブルデータを追加してください」というメッセージが表示されますので、元のExcelファイルを参照しながらテーブル構成を設定してください。
{% endhint %}

\[+追加]をクリックします。

<figure><img src="/files/9Ptd0W3uFXocPbsKpnJ5" alt=""><figcaption></figcaption></figure>

テーブルの構成を設定します。

<figure><img src="/files/HSqiD7yOClR3SUFr8ADW" alt=""><figcaption></figcaption></figure>

#### **テーブル構成設定手順** <a href="#table" id="table"></a>

1. **テーブルの命名**\
   データの用途に合ったテーブル名を入力します。 （例：従業員詳細情報 or 従業員人事情報など）
2. **テーブル範囲の指定**\
   シート内でデータとして使用するセル範囲を指定します。たとえば、A1:N1001 のように入力すると、A 列から N 列、1 行から 1001 行までのデータをテーブル情報として活用します。
3. **テーブルの説明の入力**\
   テーブルの目的やデータ構造を簡単に記載します（例：2025年入社者の年俸、入退日、直軍情報）。必要に応じて、各列の入力規則またはデータ制約をまとめて作成することができます。\
   ただし、この説明で入力した内容はモデルプロンプトに直接反映されますので、**必要なルールのみを簡潔に作成してください。不必要に長い文章や内容が重複すると、モデルが内容を混同する場合があります。**

次に、テーブルに含める各ヘッダー（列情報）を設定します。ヘッダーはデータ構造を定義する重要な要素であり、検索およびSQL問合せ時に参照される基準となります。

<figure><img src="/files/WVwBDphnNJ9tCgHlxQM2" alt=""><figcaption></figcaption></figure>

#### **ヘッダーを追加する方法** <a href="#header" id="header"></a>

1. **ヘッダーセル番号入力**
   \
   ヘッダーとして使用する行番号を入力します。例えば、テーブルの最上位の行をヘッダーにしたい場合は、「A1」のように、対応する列のアルファベットと行の数値で入力します。テーブルの範囲全体を指定する場合（例：A1からD99）、ヘッダーとして機能するすべてのセルを入力する必要があります。この例では、ヘッダーとして「A1、B1、C1、D1」の4つすべてのセルを入力してください。
2. **ヘッダー名の入力**
   \
   各列に使用するヘッダー名を入力します。 ※Excelソースの列名と完全に一致する必要はなく、検索やフィルタリング時に利用する名前での指定を推奨します。
3. **データ型の指定**
   \
   各列に入れるデータの種類を選択します。データ型は検索精度とSQLクエリの結果に直接影響するため、実際のデータ属性に合わせて正確に指定することが重要です。たとえば、タイプをDATETIMEに指定し、実際の値がSTRINGの場合はnull値として保存されますのでご注意ください。

**データ型別の説明と例**

| データ型            | 説明                                                  | 例                                                   |
| --------------- | --------------------------------------------------- | --------------------------------------------------- |
| STRING(文字列)     | 文字で構成されるプレーンテキストデータです。数値でも計算ではなく単純表記用の場合は文字列で指定します。 | <p>社員名：田中太郎</p><p>四番：A-102</p>                      |
| NUMBER(数値)      | 整数または実数型の数値データです。合計、平均などの計算が必要なデータに使用します。           | <p>単価：1200</p><p>比率：0.85</p>                        |
| DATETIME(日付/時間) | 日付または時刻情報を含むデータです。 SQL検索時に期間フィルタとして活用できます。          | <p>入社日：2025-10-16</p><p>退社日：2025-09-01 14:32:00</p> |
| BOOLEAN(ブーリアン)  | 真/偽（True/False）形式のデータです。選択のステータス値を表現するために使用します。     | <p>アクティブ：TRUE</p><p>完了：FALSE</p>                    |

#### **Excelファイルに隠し列が含まれている場合** <a href="#hidden-column" id="hidden-column"></a>

<figure><img src="/files/1B0OdmjRzpQpDDswlQeY" alt=""><figcaption></figcaption></figure>

ドキュメントをアップロードするときに非表示の列が含まれている場合、**その列はプレビュー画面でも非表示になり、テーブルデータに変換しても自動的に除外されます。**&#x4E0A;画像の場合、列Bは隠し列のため、ヘッダー情報にはA、C、Dのみを入力できます。非表示の列までを含むテーブルデータを構成するには、ソースファイルを参照して非表示の列のヘッダーを直接入力する必要があります。入力したヘッダーに基づいてテーブルが再編成され、直接入力した場合は、非表示の列データも一緒にテーブルデータに含まれます。

#### **Excelファイルに結合されたセルが含まれている場合** <a href="#merged-cells" id="merged-cells"></a>

<figure><img src="/files/4SYM1AFN4LfhGXKmFbME" alt=""><figcaption></figcaption></figure>

結合されたセルはテーブルデータに変換されると自動的に解放され、元の値が結合領域のすべてのセルに複製されます。したがって、次のように入力します。

例:

D1：E1がマージされ、「製品名」という値がある場合→D1 =「製品名」、E1 =「製品名2」などで入力します。

このときセル名は固有の値なので2などの記号を入れておくことを推奨します。

#### **データとして保存したいヘッダーの位置がそれぞれ異なる場合** <a href="#the-header-rows-are-different" id="the-header-rows-are-different"></a>

<figure><img src="/files/oixQrbJLGjJSYj9t94tD" alt=""><figcaption></figcaption></figure>

構成したいテーブルのセル行が一致しない場合には、ヘッダで指定したい領域の番号を入力してください。上記画面のように入力した場合、実際の空の値はNULLとして処理され、データが壊れることなくそのまま保持されます。

### 3.データベースとして保存する <a href="#save-as-db" id="save-as-db"></a>

ヘッダー情報を入力したら、保存ボタンをクリックします。

<figure><img src="/files/9yXUumQ9uQ3XtNxmB2ST" alt=""><figcaption></figcaption></figure>

全てのヘッダー情報を入力できたら、\[データベースに変換]ボタンをクリックし、テーブルデータに変換をします。

アプリを設定して、対応するテーブルデータを回答として活用できるようになりました。

<figure><img src="/files/Jr0pp6fI71rZmTbLpAyr" alt=""><figcaption></figcaption></figure>

### 4.アプリを設定する <a href="#setting" id="setting"></a>

アプリ管理 > \[+新しいアプリを作成] > \[会話型アプリを作成]ボタンをクリックします。

<figure><img src="/files/hkmpoaIhkyleWIJUKxyq" alt=""><figcaption></figcaption></figure>

以下のようにフローを組みます。

<figure><img src="/files/V8GHSm4RBJPTJ3mk45wc" alt=""><figcaption></figcaption></figure>

各ノードは、以下のように設定します。

**LLMインプット**

* ドキュメントの適用範囲：テーブルデータとして保存した対象のExcelファイルを指定しておきます。\ <mark style="color:red;">※LLMインプットノードで指定できるExcelファイルは1つのみ(Excelファイル内のシートも１シートのみ)となりますため、複数ファイル・フォルダ単位での指定はできません。</mark>\
  \ <mark style="color:red;">※2025年11月時点では、ユーザーによってアップロードされたExcelファイルへの対応は未実装です。事前に、ダッシュボード上で設定が完了されたファイルのみに適用できます。</mark>
* 応答内容を以下の変数に保存する：@EXCEL\_DOCUMENTS

**変数**

* **変数名： EXCEL\_DOCUMENTS**
* **変数種別： 会話変数**
* **タイプ： ドキュメント**

変数名と種類が一致しない場合、実行時にエラーが発生する可能性があります。

<figure><img src="/files/J2Tb32nc5M9avWlpMiEV" alt="" width="533"><figcaption></figcaption></figure>

**質問応答ノード**

* 応答追加：ON
* 回答形式：テキスト

<figure><img src="/files/Cc7tzUVAp8gyQFPKotOA" alt="" width="563"><figcaption></figcaption></figure>

**LLM実行ノード**

* 実行するタイプ：エージェント
* エージェント：Table Agent
* ベースモデル：GPT-4o(推奨)

<figure><img src="/files/7MuotTuUJQ6tZS1MdrCa" alt="" width="563"><figcaption></figcaption></figure>

### 5.アプリの動作確認をする <a href="#check" id="check"></a>

設定したテーブルデータに基づいて、情報検索し、回答を生成できるようになります。

<figure><img src="/files/4xCcidqX8e2XAoeTJswi" alt=""><figcaption></figcaption></figure>

\[回答プロセスを見る]をクリックすると、SQLクエリがどのように生成されたかを確認できます。

<figure><img src="/files/ryirMURYq3RnlOhlIyQx" alt=""><figcaption></figcaption></figure>

### 注意事項 <a href="#caution" id="caution"></a>

* 本機能追加前にAlliにアップロードされたExcelファイルには、テーブル編集アイコンは表示されません。既存のExcelファイルをデータベース形式に変換する場合は、再アップロードする必要があります。<br>

  <figure><img src="/files/XxTzqiDfNFx8XfkdStuV" alt=""><figcaption></figcaption></figure>
* すべての Excel ファイルにテーブル編集アイコンが表示されます。ただし、実際の編集画面でテーブルとして構成されていない場合、Excelファイルはマークダウン（ジュール）形式で解析され、従来のようにドキュメント内の回答ソースとして自由に利用されます。 1つの文書を**テーブルデータとマークダウンの**両方で使用したい場合は、**文書名を異なるようにして2つをアップロード**してから、片側でテーブルデータに整理してください。
* Alliの標準機能であるドキュメントアップデートボタンは、テーブルデータとして登録されていないExcelファイルでのみ利用可能です。一度テーブルデータで構成されたExcelファイルは、更新ボタンが非表示になります。<br>

  <figure><img src="/files/CRRuY58KjaG5uYmKulgZ" alt=""><figcaption></figcaption></figure>

  <figure><img src="/files/TfqhR2WWLmdl6NZXhidE" alt=""><figcaption></figcaption></figure>


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.allganize.ai/alli-llm-app-market/manual/document/table-agent.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.