# リスト変数・ファイル変数

リスト変数を使用すると、外部データを使用して顧客向けの動的な回答リストを作成でき、ファイル変数を使用すると、ユーザーは所定のファイルをアップロードすることができます。

一般的な変数の管理方法については、[こちらを参照](/alli-llm-app-market/project-settings/variables.md)してください。

## リスト変数 <a href="#list-variable" id="list-variable"></a>

リスト変数には３つの異なるタイプがあります。 ・文字列リスト ・JSON ・JSONリスト すべてのタイプのリスト変数を利用するには、JSONに関する基本的な知識が必要となります。

### **STEP 1. リスト変数を作成**

Alliダッシュボードにログインして、文字列型変数の作成を開始します。\
Alliダッシュボードにログインして、文字列型変数の作成を開始します。 変数の作成方法は以下の３パターンがあります。\
**方法 1** -\[設定]メニューから>変数>を作成する 。\
\[設定]> \[変数]> \[カスタム]に移動し、\[+追加]をクリックします。

\
**方法 2** – チャットフロー編集で変数を作成する。\
チャット編集画面でノードに新しい変数を追加します。\[応答内容を以下で保存する]直下のドロップダウンメニューから\[新しい変数を作成]をクリックします。<br>

**方法 3** – チャット編集内＠変数リストメニューから作成する 。\
変数追加画面の\[タイプ]選択にて“文字列リスト”、“JSON”、“JSONリスト”から選択します。 変数の名前と説明も入力して保存します。

#### **方法1-\[設定]メニューから変数を作成する**

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

#### **方法2-チャットフロー編集で変数を作成する**

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

#### **方法3-チャット編集内＠変数リストメニューから作成する**&#x20;

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

### **STEP 2. JSON形式でデータポイントを準備する**

使用する変数に応じて、適切な形式でリストを準備します。 以下に例を示します。

{% code lineNumbers="true" %}

```json
{
  "STR_LIST_VAR": [
    "TypeA",
    "TypeB",
    "TypeNew"
  ],
  "JSON_VAR": {
    "empno": 1,
    "name": "Chris",
    "email": "Chris@allganize.ai"
  },
  "JSON_LIST_VAR": [
    {
      "empno": 1,
      "name": "James",
      "email": "James@allganize.ai"
    },
    {
      "empno": 2,
      "name": "Peter",
      "email": "Peter@allganize.ai"
    }
  ]
}
```

{% endcode %}

キーが変数の名前と一致することを確認してください。 上記の例では、STR\_LIST\_VAR、JSON\_VAR、JSON\_LIST\_VARが各変数の名前である必要があります。 ちなみに、後で[**連携ノード**](/alli-llm-app-market/app-management/node/integrate-node-advanced.md)のAdvancedオプションを使用してJSONパスを指定する場合は、変数名は一致していなくても問題ありません。

### **STEP 3. チャットフローを設計する**

[**【外部データ連携】**](/alli-llm-app-market/app-management/node/integrate-node-advanced.md)ノードを使用して、設定したデータポイントからデータを取得します。 リスト変数を使用する前に、外部データ連携ノード（設定の参照はこちら）および会話応答ノードを配置する必要があります。

<figure><img src="https://i0.wp.com/guide.allganize.ai/wp-content/uploads/2022/05/%E3%83%AA%E3%82%B9%E3%83%88%E5%A4%89%E6%95%B04.png?resize=719%2C361&#x26;ssl=1" alt="" height="361" width="719"><figcaption><p>Place Integrate node before you use any List variables.</p></figcaption></figure>

【会話・質問応答】ノードで、\[応答の追加]に☑を入れ、\[+動的応答オプションの追加]をクリック後、 🖊をクリックし、\[動的応答オプションの編集]にて、使用する変数を選択します。 JSONまたはJSONリストを使用している場合は、DisplayパスとバリューパスをJSON形式で入力する必要があります。 Displayパスは、チャットフローで顧客に表示されるオプション用であり、バリューパスは、顧客がオプションを選択したときに返される値用です。

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

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

### **STEP 4. リストの表示を確認**

PREVIEWを使用して、リストが意図したとおりに表示されるかどうかを確認できます。

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

## ファイル変数 <a href="#file-variable" id="file-variable"></a>

File変数の使用は非常に簡単です。

### **STEP 1. ファイル変数の作成**

変数タイプとして\[ファイル]を選択する以外は、上記のリスト変数のSTEP１と同じ内容です。

### **STEP 2. チャットフローの設計**

【会話・質問応答】ノードまたは[**【入力フォーム】**](/alli-llm-app-market/app-management/node/build-a-form-node.md)ノードでFile変数を使用できます。 【会話・質問応答】ノードで、\[応答追加]をオンにして、応答種別として\[ファイル]を選択し、\[応答の保存先]としてファイル変数を選択します。 【入力フォーム】ノードで、フィールドの変数の１つとして\[ファイル]変数を選択します。

<figure><img src="/files/0rQnFeUJhDEMOTAqBEUA" alt=""><figcaption></figcaption></figure>

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

### **STEP 3. 動作確認**

【会話・質問応答】ノードの場合、ユーザーは\[クリップ]アイコンをクリックしてファイルをアップロードできます。【入力フォーム】ノードの場合、\[ファイルを添付]をクリックし、該当ファイルをアップロードすることができます。

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

<figure><img src="/files/3SiOwAJaGLLWsXhCTRwU" alt=""><figcaption></figcaption></figure>

Dashboardのユーザーリスト内でもアップロードされたファイルが表示・確認できます。

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


---

# Agent Instructions: 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/project-settings/variables/list-variable.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.
