> For the complete documentation index, see [llms.txt](https://docs.wicle.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.wicle.io/analytics/dashboard/custom-dashboard/create-widget.md).
# ウィジェットを追加・編集する
## ウィジェットを追加する
1. ヘッダーの`ウィジェットを追加`をクリックします
2. 右パネルに`ウィジェットを作成`が開きます
3. 測りたい指標を自然言語で入力します（例:「日別UUの推移を折れ線で」「LP別セッション一覧」）
4. AIがチャート案を作成し、パネル下部にプレビューが表示されます
5. 内容を確認して`追加する`をクリックします。不要な場合は`破棄`をクリックします
追加後も作成パネルは開いたままなので、続けて別のウィジェットを追加できます。
{% hint style="info" %}
作成パネルには、よく使う依頼のサジェスト（日別UUの推移、流入チャネル別セッションなど）が表示されます。クリックして入力の起点にできます。
{% endhint %}
{% hint style="warning" %}
プロジェクト内のウィジェット合計数が上限に達している場合、`ウィジェットを追加`は利用できません。ボタンにマウスを合わせると上限の案内が表示され、`上限設定を確認する`から制限の確認画面へ移動できます。上限は [リミット](/organization-project/project-setting/limitation.md) から確認できます。
{% endhint %}
## 分析アシスタントから追加する
[チャットエージェント](/ai/agent.md)で生成したチャートを、カスタムダッシュボードのウィジェットとして追加できます。
1. 分析アシスタントでチャートが表示されたら、チャート上の`ダッシュボードに追加`をクリックします
2. ダイアログで追加先を選びます
* 既存のダッシュボードへ追加する場合は、`ダッシュボードを選択`から選びます
* 新しいダッシュボードを作成する場合は、`新規作成`をオンにして`ダッシュボード名`を入力します
3. 必要に応じて`ウィジェット名`を編集します
4. `追加する`をクリックします
追加が完了すると、トーストから`ダッシュボードを開く`で対象のダッシュボードへ移動できます。
{% hint style="info" %}
分析アシスタントから追加したウィジェットは、分析時の期間で`期間固定`されます。相対期間（例: 直近N日）も、登録時点の絶対期間に変換して固定されます。
{% endhint %}
## ウィジェットを対話で編集する
1. 対象ウィジェット右上の`⋯`メニューから`対話で編集`を選択します
2. 右パネルに`ウィジェットを編集`が開きます
3. 変更したい内容を伝えます（例:「棒グラフにして」「デバイス別に分けて」）
4. プレビューを確認し、`更新する`をクリックします
{% hint style="info" %}
SQLだけ直す場合は、ウィジェットメニューの`SQLを編集`を使います。詳しくは [SQLを編集する](#edit-sql) をご覧ください。
{% endhint %}
## チャート種別を変更する
ウィジェット右上のチャート種別アイコン（ツールチップ`チャート種別`）から、対話なしで種別を切り替えできます。
1. 対象ウィジェットのチャート種別アイコンをクリックします
2. 一覧から種別を選択します
切り替え可能な種別の例は次のとおりです。データの形に応じて、表示される選択肢が変わります。
* 系列なし: `折れ線` / `棒` / `円` / `ファネル`
* 系列あり: `折れ線` / `棒` / `積み上げ棒` / `グループ棒`
{% hint style="info" %}
散布図・ヒートマップ・数値・表など、互換のない種別ではチャート種別アイコンは表示されません。対話での編集からも種別変更を依頼できます。
{% endhint %}
## 名前・説明を変更する
1. 対象ウィジェットの`⋯`メニューから`名前・説明を変更`を選択します
2. ウィジェット名（必須）と説明（任意）を入力します
3. 保存します
## 期間固定を変更する
ウィジェットは、特に指定がなければダッシュボード上部の期間セレクタに従います。次の場合に`期間固定`バッジが付き、上部の期間変更の影響を受けなくなります。
* 対話で絶対期間での固定を明示して作成・編集したとき
* 分析アシスタントからチャートを追加したとき
期間固定のウィジェットでは、`期間固定`バッジをクリックして次の操作ができます。
* `カレンダーで期間を変更` — 固定する日付範囲を直接変更します
* `ダッシュボードの期間に合わせる` — 対話編集パネルが開き、期間固定を解除してダッシュボード上部の期間に従うよう依頼できます
{% hint style="info" %}
ダッシュボード上部の期間と同じ日付で作成しても、固定を明示しない限り期間固定にはなりません。
{% endhint %}
## SQLを編集する
`⋯`メニューの`SQLを編集`から、ウィジェット実行に使われるSQLを直接編集できます。列の追加やWHERE条件の微調整など、軽微な修正に向いています。指標の意図変更やチャート種別の変更、複雑な書き換えは`対話で編集`を使ってください。
1. 対象ウィジェットの`⋯`メニューから`SQLを編集`を選択します
2. テキストエリアでSQLを編集します
3. 必要に応じて`整形`や`SQLをコピー`を使います
4. `SQLチェック`で検証するか、`保存して再実行`で保存してウィジェットを再実行します
未保存の変更がある状態で閉じようとすると、確認ダイアログが表示されます。SQLが保存されていないウィジェットでは、対話で編集する案内が表示されます。
SQLは1〜10,000文字です。テーブルは次のプレースホルダで指定します。
* `{{user}}` / `{{session}}` / `{{event}}`
* グループ分析オプションが有効な場合は、`{{group}}` / `{{groupuser}}` も使えます
`{{session}}` / `{{event}}` を使うときは、期間条件を次の形式でのみ指定できます（`BETWEEN` や `<=`、日付の直書きは使えません）。
```
session: start_date >= '{{startDate}}' AND start_date < DATE_ADD(DATE('{{endDate}}'), INTERVAL 1 DAY)
event: sync_date >= '{{startDate}}' AND sync_date < DATE_ADD(DATE('{{endDate}}'), INTERVAL 1 DAY)
```
`{{user}}` / `{{group}}` / `{{groupuser}}` だけのSQLでは、期間条件は不要です。
{% hint style="info" %}
`SQLチェック`は保存せずに構文やルールを検証します。`保存して再実行`も保存前に同様の検証を行い、問題がある場合は保存されません。検証に使う期間は、期間固定ウィジェットでは固定期間、それ以外ではダッシュボード上部の現在の期間です。
{% endhint %}
## ウィジェットを削除する
1. 対象ウィジェットの`⋯`メニューから削除を選択します
2. 確認ダイアログで削除を実行します
レイアウト編集中は、ウィジェット右上の`×`からも削除できます。この場合の削除は、ヘッダーの`保存`を押すまで確定されません。
{% hint style="danger" %}
メニューから削除したウィジェットは取り消せません。
{% endhint %}
## レイアウトを編集する
1. ヘッダーの`編集`をクリックします（ウィジェットが1件以上あるときのみ利用できます）
2. ウィジェットをドラッグして位置を変更したり、端をドラッグしてサイズを変更したりします
3. `保存`をクリックして反映します。変更を破棄する場合は`取り消す`をクリックします
{% hint style="info" %}
レイアウト編集中は、期間セレクタとウィジェット追加パネルは利用できません。また、画面幅が狭い場合はレイアウト編集できません。
{% endhint %}
## データを更新する
各ウィジェットの更新アイコンをクリックすると、そのウィジェットのデータを再取得できます。
## 会話について
### 作成チャット
ウィジェット作成時の対話は、ダッシュボード単位で保存されます。同じダッシュボードを再度開いても、前回の作成チャットを続けられます。
作成チャットは、プロジェクト内のメンバー全員で共有されます。他のメンバーが同じダッシュボードでウィジェットを追加した会話も、同じ履歴として表示されます。
### 編集チャット
ウィジェットの対話編集を開くたびに、新しい会話スレッドが始まります。
### 会話をやり直す
作成・編集パネルで`やり直す`をクリックすると、会話履歴をクリアできます。作成モードでは、同じダッシュボードでの作成チャットも最初からやり直せます。
---
# 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, and the optional `goal` query parameter:
```
GET https://docs.wicle.io/analytics/dashboard/custom-dashboard/create-widget.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.
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.