翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

# UI エージェント
<a name="ui-agents"></a>

UI エージェントは、複雑なブラウザアクションを実行するための自然言語の手順を理解するネイティブエージェントです。ウェブサイトを自律的にナビゲートし、クリック、入力、データの読み取りを行い、ダウンストリームの自動化ステップに最適化された構造化出力を生成できます。ユースケースの例には、ウェブページでの製品の要約や、ウェブサイトのナビゲーションによるデータの取得などがあります。

## プロパティ
<a name="ui-agent-properties"></a>

タイトル  
ステップ/UI エージェントの名前

指示  
このフィールドには、エージェントのプロンプトを自然言語で書き込みます。プロンプトを記述する際のベストプラクティス:  
+ 目的を明確かつ明確にします。
+ プロンプトを構造化します。最初に「タスク」または「ロール」に言及し、次に「指示」に言及して、番号付きのステップでタスクを達成する
+ 制約を追加 (製品セクションのみを確認するなど) し、いつ停止/終了するかを指定する (関連情報が見つかったときに停止するなど)
+ 肯定的な例と否定的な例を提供する (これを行わない)
+ 長さの要件 (100 語未満など) または出力形式 (MM/DD/YY 形式の日付など) を明確に指定する
テキストを三重引用符 ("") で囲み、複数行のプロンプトを書き込みます。例えば、次のようになります。  

```
"""Task: Locate the company's latest annual report.
* Visit the provided URL.
* Look for the annual report. The report may be titled 'Annual Report', 'Financial Report', 'Year in Review', or similar variations..."""
```

構造化出力 (オプション)  
エージェントレスポンス: このオペレーションの出力を割り当てる変数の名前

## 構造化出力フィールドを設定する方法
<a name="ui-agent-structured-output"></a>

**フィールドの追加**
+ フィールドの追加をクリックして新しい出力フィールドを作成します
+ 出力名を入力する - JSON プロパティ名になります
+ ドロップダウンからタイプを選択する
+ フィールドが常に存在する必要がある場合は必須にチェックする
+ AI エージェントをガイドする説明を追加する

**フィールドタイプ**
+ *文字列* - テキスト値 (名前、説明、概要)
+ *数値* - 数値 (カウント、スコア、パーセンテージ)
+ *ブール値* - 真/偽の値 (ステータスフラグ、はい/いいえの質問)
+ *オブジェクト* - ネストされた構造 (複雑なデータグループ化)
+ *配列* - 項目のリスト (タグ、カテゴリ、複数の値)
+ *ファイル* - ファイルリファレンス (ドキュメントアタッチメント、イメージ)
+ *データテーブル* - 表形式データ (構造化データセット、レポート)

**複雑なタイプの操作**

オブジェクトと配列には、ネストされたフィールドを含めることができます。
+ オブジェクトフィールドまたは配列フィールドの横にある展開矢印 (▶) をクリックします。
+ ネストされた構造内でフィールドの追加を使用する
+ 最適なパフォーマンスを得るには、ネストを最大 2～3 レベルに維持します。

**設定例**

お客様のフィードバックの概要を示す簡単な設定を次に示します。

```
{
  "orderId": "12345",
  "numberOfOrders": 3,
  "hasShipped": true,
  "orderDetails": {
    "quantity": 2,
    "productName": "ABC",
  },
  "tags": ["electronics", "urgent"]
}
```

この構造は次のように設定されます。
+ orderId (文字列、必須)
+ numberOfOrders (数値、必須)
+ hasShipped (ブール値、必須)
+ orderDetails (オブジェクト、必須)
  + 数量 (数値、必須)
  + productName (文字列、必須)
+ タグ (文字列の配列、オプション)

**ベストプラクティス**
+ わかりやすいフィールド名を使用する - AI が抽出するデータを理解するのに役立ちます
+ 明確な説明を追加する - 複雑なフィールドのコンテキストを提供する
+ 重要なフィールドを必須としてマークする - 重要なデータが常に存在することを確認する
+ ネストの深さを制限する - パフォーマンスを向上させるために構造をシンプルに保つ
+ 設定をテストする - エージェントステップを実行してレスポンスを検証することで、出力が期待どおりであることを確認します。

**重要な注意事項**
+ JSON に関する知識: JSON に慣れていませんか? 基本については、json.org を参照してください。
+ 検証なし: 現在、システムは出力構造を検証しません - オートメーションが欠落または不正な形式のデータを処理することを確認します