# インターフェースの作成

インターフェースオブジェクトは、ワークスペースに表示されるエージェントの設定または画面です。このオブジェクトが作成されると、基盤となるエージェントが定義されたインターフェースでワークスペースに表示されます。現在、インターフェース定義はフォームタイプのみをサポートしています。

## インターフェースの作成

1. TDコンソールを開きます。
2. **AI Agent Foundry**に移動します。
3. **プロジェクト**を選択します。
4. **Interfaces**を選択し、**Create interface**を選択します。


![](/assets/creating-an-interface-2025-08-05-16-45-36s.31853372a6a9c505a3e64ea4da27ff7ae0b9166fb1b359206377b35a0faa5857.91c26685.png)

1. フォームに入力します
![](/assets/creating-an-interface-2025-08-05-17-07-39.c42a80d203216f151b20229f8ef85d2f50707cfd9d931fe3f873d51aaa9ec339.91c26685.png)


| フィールド | 説明 |
|  --- | --- |
| Interface Name | ワークスペースに表示されるこのインターフェースの名前 |
| Agent name | 基盤となるエージェント名 |
| Prompt template | ユーザーがワークスペースでGenerateボタンをクリックしたときにエージェントに与えられる入力テキスト。テキストは、フォームに入力されたデータを参照する必要があります。フォームアイテムに与えられた変数名は{{}}を使用して参照できます。会社名で、フォームアイテムにcompany_nameというフォームIDが与えられている場合、このフォームアイテムに入力された値は、このフィールドで{{company_name}}で参照できます。 |


1. _Next_ボタンをクリックし、_Form_定義に移動します
2. フォームデザイナーに必要なフォームアイテムを配置し、右側の_Properties_パネルで必要な設定を入力します
![](/assets/creating-an-interface-2025-08-05-17-18-34.29d1780f9e02f1f0f0729e4adc42ff5eb4fd2ab14ab9cfc010c0f2c8602a8e6d.91c26685.png)
3. _Apply_ボタンをクリックして変更を適用します
![](/assets/creating-an-interface-2025-08-05-17-20-28.62bea52774228f14ebf54f116ee33790bc22812995bbfac7be70c226a3b30710.91c26685.png)
4. _Create_ボタンをクリックして完了します


### ツールキット

左上の_Toolkit_ボタンをクリックして、フォームアイテムのリストを開きます。

![](/assets/creating-an-interface-2025-08-05-17-25-10.0c2c0cf97f55ee8c9ae90b2e97f6f005e1bea4e3bcf303ae80bd8333feded53d.91c26685.png)

フォームアイテムには独自の設定があります。すべての設定をセットアップする必要はありませんが、このフォームアイテムの変数名である_Field ID_を除き、_Prompt template_で参照する必要があります。また、フォームアイテムには英語と日本語の両方の設定があります。日本語設定は、TDコンソールで日本語が選択されている場合に使用されます。

以下は_Basic text_の設定例です。

| フィールド | 説明 |
|  --- | --- |
| Field ID | プロンプトテンプレートで参照される変数名。 |
| Text Type | `Basic text`または`Text area`を選択します。 |
| Label | 入力の上に表示されるタイトル。 |
| Description | フィールドを説明する追加のヘルパーテキスト。 |
| Placeholder | 入力内に表示されるプレースホルダーテキスト。 |
| Hint | `?`アイコンにホバーしたときに表示されるツールチップテキスト。 |
| Disabled | フィールドを無効として表示します。 |
| Read only | 編集を許可せずに値を表示します。 |
| Required | フィールドを必須としてマークします。 |
| Default value | 入力に入力される初期値。 |


### フォームの例

以下は、AIDAマーケティングファネルを生成するエージェントのプロンプトテンプレートとフォーム定義の例です。エージェントは、会社名、業界、製品、およびマーケティングの詳細の情報に基づいてテキスト出力を生成すると想定されます。

フォームベースのインターフェースで生成されたコンテンツをレンダリングするには、エージェントに出力タイプ：アーティファクトの出力関数が必要です。アーティファクトについては、[出力の追加](/products/customer-data-platform/ai-agent-foundry/ai-agent/creating-an-agent#add-outputs)を参照してください

#### プロンプトテンプレート

以下の情報からAIDAストーリーを作成します

- 会社名: {{company_name}}
- 業界: {{industry_info}}
- 製品: {{product_info}}
- マーケティングの詳細: {{marketing_detail}}


#### フォーム

![](/assets/creating-an-interface-2025-08-05-17-44-16.a3981d54c5b6a827ce8ffbf6cd19e7aee730a690ea185e8e250efee62061115e.91c26685.png)

| フォームアイテム（ラベル） | フォームID |
|  --- | --- |
| Company Name | company_name |
| Industry | industry_info |
| Product | product_info |
| Marketing Detail | marketing_detail |