---
title: "ウィジェットを作成または編集"
slug: "create-or-edit-a-widget"
abstract: "エージェントが一貫した出力を生成するために使う再利用可能なJSONスキーマの作成と編集方法。"
---
# ウィジェットを作成または編集

ウィジェットは自己完結型で再利用可能なUIコンポーネントです。ウィジェットは期待されるデータが明確なときに最も効果的に機能します。ウィジェットテンプレートは視覚的な構造を定義し、ウィジェットプロンプトはエージェントにウィジェットスキーマに合致するデータを生成するよう導きます。これにより、エージェントは一つのテキスト応答ではなく、一貫したインタラクティブな結果を生成できます。

ウィジェットの一般的な用途には以下があります:

-   ペルソナ監査スコアカード
-   SEOスコアカード
-   ブランドコンプライアンスの概要
-   アカウントプロフィールカード
-   キャンペーンパフォーマンスダッシュボード
-   マーケットシグナルインサイトパネル

ウィジェットスキーマは、ウィジェットに必要なデータやコンテキスト(例:ページURL、ブランドブリーフ、コンテンツのセット)、ウィジェットが表示する内容(例:SEOスコア、AI生成の推薦、市場シグナル、パフォーマンス指標)、そしてユーザーが出力でできること(結果の適用・編集、再生成など)を定義します。

> !注ウィジェットスキーマを作成するには*Admin*でなければなりません。

## ウィジェットテンプレートを作成する

ウィジェットテンプレートを作成するには:

1.  ナビゲーションメニューで**Agentic**をクリックし、左側のサイドバーで:mdiCogOutline: **Settings**をクリックします。
    
2.  左側のペインで :mdiViewGridOutline: **Widgets**をクリックします。
    
3.  **ウィジェット**ページで :mdiPlusCircle: **Create widget**をクリックしてください。
    
4.  ページ上部のタイトル欄をクリックし、ウィジェットのタイトルを定義してください。
    
    ![Widget page showing the title field](https://doc.sitecore.com/api/markdown-image/sai/ja/users/sitecoreai/images/widget-title-field.png)
    
5.  左側の **プロンプト** パネのチャットで、作りたいウィジェットを説明してください。あるいは、あらかじめ定義されたプロンプトのいずれかをクリックしてください。
    
6.  「 **送信」** をクリックしてください:mdiSendOutline:。
    
7.  以下のタブを使ってウィジェットのプレビュー、修正、テストを行います:
    
    -   **プレビュー** - レンダリング時のウィジェットの見た目を示します。
    -   **JSON** - ウィジェットの定義を表示し、設定の詳細を編集、コピー、デバッグできます。
    -   **スキーマ** - ウィジェットが入力と出力に使用するフィールド、型、必要な値を定義します。
    -   **ビジュアル** - ウィジェット構造を作成・編集できるビジュアルエディターを表示します。
    -   **Stream** - ウィジェットをテストし、実行中にウィジェットの結果をリアルタイムで確認できます。
8.  ウィジェットに満足していただけたら、:mdiContentSave: **Save Widget**をクリックしてください。
    

## ウィジェットを編集する

管理者はウィジェットの動作やメタデータを修正するために更新できます。

ウィジェットを編集するには:

1.  ナビゲーションメニューで**「Agentic** 」をクリックし、左側のサイドバーで **「Settings** :mdiCogOutline:」をクリックしてください。
2.  左側のペインで :mdiViewGridOutline: **Widgets** をクリックします。
3.  **ウィジェット**ページで、編集したいウィジェットを探してください。
4.  **アクション**をクリックしてください :mdiDotsHorizontal: > **編集**。
5.  ウィジェットの詳細やJSON構造は必要に応じて更新してください。
6.  クリック:mdiContentSave: **Update ウィジェット**。