# 変数

Alliをより効果的に利用するためには、”変数”を活用することがポイントになります。 ”変数”は、ユーザーとのコミュニケーション時に取得した情報を保存する箱となります。この情報は顧客エクスペリエンスをパーソナライズしたり、カスタマーチームに重要な情報を提供することができます。

## メニューの概要 <a href="#menu-overview" id="menu-overview"></a>

<figure><img src="https://3244404108-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FR2CRA2CisD1pVQUgqd1g%2Fuploads%2FIOZBN1nlkDWR5ZQHY3qC%2F%E3%82%B9%E3%82%AF%E3%83%AA%E3%83%BC%E3%83%B3%E3%82%B7%E3%83%A7%E3%83%83%E3%83%88%202024-10-23%2016.51.34.png?alt=media&#x26;token=0a66d405-ac0f-4835-b9bc-034b98022d44" alt=""><figcaption></figcaption></figure>

1. \[変数]メニューは\[プロジェクト設定]内にあります。
2. \[カスタム変数] カスタム変数を追加／削除／編集します。
3. \[システム変数] システムで使用され、NLU APIによって指定された変数（[**SDK変数**](https://docs.allganize.ai/alli-llm-app-market/project-settings/variables/sdk-variables-system-variables)）が リストアップされます。 ダッシュボードで編集することはできません。
4. ユーザー変数 この変数は、それぞれのユーザーに依存します。 変数の値は、ユーザー情報に格納されます。
5. 会話変数 変数の値は、会話が終了するまで保存され、次のダイアログでは、 リセットされます。
6. 選択した変数を削除または新しい変数を追加します。
7. 各変数の要約 MAILなどのデフォルトの変数以外は\[編集]のアイコンをクリックして、 変数を編集することができます。

## 変数を追加する <a href="#adding-variables" id="adding-variables"></a>

Alliには変数がいくつか事前に設定されていますが、ニーズに合わせて変数を追加作成することができます。変数を追加するには３つの方法があります。

### **＜１．変数設定メニューから追加＞** <a href="#add-from-variable-settings-menu" id="add-from-variable-settings-menu"></a>

\[変数の設定]メニューの\[追加]ボタンをクリックします（上記の＃６を参照）。 「新しい変数を作成」がポップアップ表示されます。

<figure><img src="https://3244404108-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FR2CRA2CisD1pVQUgqd1g%2Fuploads%2Fpgv14zPHJP5ZJc7lW0rN%2F%E3%82%B9%E3%82%AF%E3%83%AA%E3%83%BC%E3%83%B3%E3%82%B7%E3%83%A7%E3%83%83%E3%83%88%202024-10-23%2017.08.02.png?alt=media&#x26;token=4b5394e2-abfd-4508-b85c-4ee9a49c7bd1" alt=""><figcaption></figcaption></figure>

<figure><img src="https://i0.wp.com/guide.allganize.ai/wp-content/uploads/2022/07/image.png?resize=345%2C161&#x26;ssl=1" alt="" height="161" width="345"><figcaption></figcaption></figure>

【名称】 変数の名前を入力します。 名前には、英数字、アンダースコア（\_）、ハイフン（-）、またはピリオド（。）を含めることができます。文頭はアルファベットまたはアンダースコア（\_）で始まる必要があります。

<figure><img src="https://3244404108-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FR2CRA2CisD1pVQUgqd1g%2Fuploads%2FCyGZjFua3LJZq4Fyg5KY%2F%E3%82%B9%E3%82%AF%E3%83%AA%E3%83%BC%E3%83%B3%E3%82%B7%E3%83%A7%E3%83%83%E3%83%88%202024-10-23%2017.08.56.png?alt=media&#x26;token=227eab17-7131-496e-940e-6e6e4c89bb2c" alt=""><figcaption></figcaption></figure>

<figure><img src="https://i0.wp.com/guide.allganize.ai/wp-content/uploads/2022/07/image-1.png?resize=347%2C116&#x26;ssl=1" alt="" height="116" width="347"><figcaption></figcaption></figure>

【タイプ】 変数タイプを選択します。 以下に注意事項を記載します。

* ファイル変数を使用すると、顧客またはシステムはファイルをアップロードできます。
* JASON、JSONリスト、文字列のリストは、上級ユーザー向けのオプションであり、外部JSONアドレスを必要とします。
* ファイル／ JSON ／文字列リスト／JSONリストについての詳細は、以下のUser Guideを参照してください。[**リスト変数＆ファイル変数**](https://docs.allganize.ai/alli-llm-app-market/project-settings/variables/list-variable)**,** [**変数の値を設定ノードで変数を使用する**](https://docs.allganize.ai/alli-llm-app-market/project-settings/variables/set-variable-values)

<figure><img src="https://3244404108-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FR2CRA2CisD1pVQUgqd1g%2Fuploads%2FGxuyJkztsGKNMZ1cSRkg%2F%E3%82%B9%E3%82%AF%E3%83%AA%E3%83%BC%E3%83%B3%E3%82%B7%E3%83%A7%E3%83%83%E3%83%88%202024-10-23%2017.10.48.png?alt=media&#x26;token=ce0c4fb6-d689-4acd-ac47-99b39ea13191" alt=""><figcaption></figcaption></figure>

<figure><img src="https://i0.wp.com/guide.allganize.ai/wp-content/uploads/2022/07/image-2.png?resize=348%2C281&#x26;ssl=1" alt="" height="281" width="348"><figcaption></figcaption></figure>

【有用性】 文字列タイプを選択した場合にのみ表示されます。 文字列検証の詳細については、こちらのUser Guideを参照してください。 –[**文字列検証**](https://docs.allganize.ai/alli-llm-app-market/project-settings/variables/string-validation)

<figure><img src="https://3244404108-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FR2CRA2CisD1pVQUgqd1g%2Fuploads%2FQYDpxdM106PWETfuLbbe%2F%E3%82%B9%E3%82%AF%E3%83%AA%E3%83%BC%E3%83%B3%E3%82%B7%E3%83%A7%E3%83%83%E3%83%88%202024-10-23%2017.12.08.png?alt=media&#x26;token=c8a3a557-dae2-4dd9-9122-9e9a09101416" alt=""><figcaption></figcaption></figure>

【説明】 必要に応じて当該変数に関する簡単な説明を入力します。 最後に\[適用する]をクリックし作成完了です。

### **＜２．ノードから追加＞** <a href="#add-from-node" id="add-from-node"></a>

チャットフローの編集で利用するノードに、変数を入力するドロップダウンがあります。この中の「新しい変数の作成」をクリックします。

<figure><img src="https://3244404108-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FR2CRA2CisD1pVQUgqd1g%2Fuploads%2FzZwcOrvAz37sjzgLyWG2%2F%E3%82%B9%E3%82%AF%E3%83%AA%E3%83%BC%E3%83%B3%E3%82%B7%E3%83%A7%E3%83%83%E3%83%88%202024-10-23%2017.17.49.png?alt=media&#x26;token=eaedd19b-a637-42f9-b4e8-45e365a48b7d" alt=""><figcaption></figcaption></figure>

クリックすると、\[変数の追加]ウィンドウが表示されます。

### **＜３．チャット編集内＠変数リストメニューから追加＞** <a href="#add-from-variable-list" id="add-from-variable-list"></a>

スキルキャンペーン（スキル）編集中は、画面右上の「@変数リスト」メニューをクリックして、変数リストを開き「+追加」ボタンを押すと、変数を追加することができます。

<figure><img src="https://3244404108-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FR2CRA2CisD1pVQUgqd1g%2Fuploads%2Fw0bgy1vNFZfTD1BLCBRU%2F%E3%82%B9%E3%82%AF%E3%83%AA%E3%83%BC%E3%83%B3%E3%82%B7%E3%83%A7%E3%83%83%E3%83%88%202024-10-23%2017.20.28.png?alt=media&#x26;token=d7678396-c1a5-482b-b31f-1d876a0a14e3" alt=""><figcaption></figcaption></figure>

上記のオプション1と同じく\[追加]ボタンが表示されます。

### ＜補足＞ <a href="#more-tips" id="more-tips"></a>

* 一部のノードでは、特定の条件下でのみ変数のセットタイプを許可します。 チャットフローエディタで作成した変数が表示されない場合は、正しい変数タイプが選択されているか確認してください。
* チャットフローがオン／オフに関わらず、チャットフローで使用されている変数は削除または編集はできません。チャットフローがどの変数を使用しているかわからない場合は、チャット編集画面の右上の「@変数リスト」をクリックして確認することができます。


---

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