[エージェント]   - Amazon Quick
UI エージェントカスタムエージェント

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

[エージェント]  

  • UI エージェント - ウェブブラウザタスク用の AI エージェント。動的でインテリジェントなウェブオートメーションに使用されます。ウェブサイトをナビゲートし、データを抽出し、構造化された出力を生成する手順を作成するだけです。

  • カスタムエージェント - 複雑なタスク用の AI エージェント。自然言語での指示を理解し、使用可能なツールを使用してアクションを実行できるエージェントを作成します。推論、判断、動的計画が必要なタスクに使用されます。

UI エージェント

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

プロパティ

タイトル

ステップ/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..."""
構造化出力 (オプション)

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

構造化出力フィールドを設定する方法

フィールドの追加

  • フィールドの追加をクリックして新しい出力フィールドを作成します

  • 出力名を入力する - 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 を参照してください。

  • 検証なし: 現在、システムは出力構造を検証しません - オートメーションが欠落または不正な形式のデータを処理することを確認します

カスタムエージェント

カスタムエージェントは、自然言語入力を処理して、統合されたツール呼び出し機能を使用して複雑なステップを自動化するインテリジェントなアクションです。主に統合をツールインターフェイスとして使用し、Code をツールとして使用できる拡張性や、ヒューhuman-in-the-loopタスクなどのその他のネイティブアクションを提供します。エージェントは、ダウンストリームの自動化ステップにシームレスに統合できるように最適化された構造化された予測可能な出力を提供します。

プロパティ

タイトル

ステップ/カスタムエージェントの名前

モード

モードは、ユースケースに基づいてエージェントの動作を定義します。使用可能なモードは、高速、Pro、カスタムの 3 つです。Fast は、要約、分類、大量のオートメーションなどの単純なタスクに最適です。Pro は、複数のツールやアクションの推論とオーケストレーションを伴う複雑なタスクに最適です。Fast および Pro はフルマネージドモードであり、事前にセットアップする必要はありません。カスタムモードでは、Bedrock Converse コネクタが必要で、使用するモデルを選択できます。これは、特定の Bedrock モデルに対してプロンプトが既にファインチューニングされている場合、特に エージェントに特定の Bedrock モデルが必要な場合、または Bedrock でホストされている独自のカスタムモデルまたはファインチューニングされたモデルを含める場合に最適です。カスタムモードでは、コネクタを介して Bedrock から独自のモデルを取り込むため、モデル推論はその Bedrock コネクタに関連付けられたアカウントに個別に請求されます。

指示

このフィールドには、エージェントのプロンプトを自然言語で書き込みます。プロンプトを記述する際のベストプラクティス:

  • 目的を明確かつ明確にします。

  • プロンプトを構造化します。最初に「タスク」または「ロール」に言及し、次に「指示」に言及して、番号付きのステップでタスクを達成する

  • ツールコールの精度を向上させ、エージェントをガイドするには、必要に応じて各ステップで使用するツールをプロンプトで明確に指定します。

  • 長さの要件 (100 語未満など) または出力形式 (MM/DD/YY 形式の日付など) を明確に指定する

テキストを三重引用符 ("") で囲み、複数行のプロンプトを書き込みます。例えば、次のようになります。

"""You are content summarization agent.
Summarize the last two paragraphs of the provided text, focusing only on the main conclusion."""
ツール (オプション)

ツールを使用すると、AI エージェントは外部システムとやり取りしたり、特定のタスクを実行したりできます。

一般的なツール

ユーザータスクの作成

このツールを有効にすると、エージェントが停止し、実行中に支援を必要とするたびに、Human-in-the-Loop (HITL) タスクをトリガーできるようになります。エージェントは一時停止して人による入力を待ち、必要な情報が提供されたら再開します。HITL タスクはタスクセンターに表示されます。最良の結果を得るために、作成者はエージェントが HITL を呼び出すタイミングを正確にプロンプトで指定できます。

統合

Salesforce、MS Exchange、Bedrock などの特定のコネクタをオートメーショングループに追加した場合、対応するアクションがここに表示されます。その後、作成者は、エージェントのツールとして使用する関連アクションを選択できます。最適なパフォーマンスを得るには、エージェントを 3～5 ツールに制限することをお勧めします。

構造化出力 (オプション)

後続のステップで簡単に処理できる構造化された JSON 出力を返すように AI エージェントを設定します。この機能は、テキストの要約、レポート生成、データ変換、非構造化コンテンツからの統計の抽出に最適です。これはオプションのフィールドです。構造化出力を定義しない場合、エージェントはデフォルトで自然言語で出力を返します。

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

注記

カスタムエージェントの構造化出力設定は、UI エージェントと同じ形式に従います。詳細な設定手順については、UI エージェント構造化出力セクションを参照してください。

カスタムエージェントテスト

ユーザーは、完全な自動化とは無関係にエージェントをテストして、動作の検証、プロンプトのデバッグ、反復処理を高速化できます。

テストを開始する

  • エージェントカードにカーソルを合わせると、カードの上部に別の実行ボタンが表示されます。

  • ボタンをクリックして、この特定のエージェントをユニットテストします。

  • 変数収集ウィンドウがポップアップし、プロンプト/指示で使用される変数が自動的に検出されます。

    • このエージェントのプロンプトのプレビューが表示され、自動検出されたすべての変数が強調表示されます。

    • ユニットテストを開始する前に、各変数の put 値を入力します。Amazon Quick Automate の他のすべての式フィールドと同様に、特定の変数の値は有効な式構文である必要があります。そうしないと、画面にエラーが表示され、ユーザーがテストを開始できなくなります。

テストの実行

ユーザーは、右側の監査パネルで実行ログフィードを確認できます。エクスペリエンスは、オートメーション全体を実行するのと同じです。

テスト実行後

  • ユーザーは、ログフィードの下にある監視変数のタブで入力変数と出力結果を確認できます。

  • ユーザーは、ログフィードの上に基本的なメトリクスカード (合計使用時間とツール) を表示できます。

例

ユースケース 1: E メール分類と割り当てエージェント

ロール: E メールの分類および割り当てエージェントである

手順: 以下のステップに従います。

  • ステップ 1: 提供されたリファレンステーブルのカテゴリ列に基づいて受信 E メールをナレッジとして分類する

  • ステップ 2: E メールシステムを使用して通知を送信します。

    • 送信元: [system_email]

    • 宛先: [team_distribution_email]

    • 件名: [分類結果]

    • 本文: 分類理由と元の E メールの要点を説明する簡単な概要を含めます。

  • ステップ 3: すべての有効なカテゴリ (「不明」を除く) について、Salesforce で次のように新しいケースを作成します。

    • 件名: [元の E メール件名]

    • 説明: E メール本文からの問題の要約

    • 優先度: コンテンツの緊急性に基づく (High/Medium/Low)

    • タイプ: 適切なタイプを選択する (Question/Problem/Featureリクエスト/その他)

    • ステータス: 「新規」

    • カテゴリ: [ステップ 1 の分類結果]

  • ステップ 4: 「不明」として分類された場合:

    • 手動レビューのためにスーパーバイザーにエスカレーションする

    • 分類が不確実な理由を説明するメモを追加

    • スーパーバイザーから受け取ったカテゴリに基づいて、ステップ 2 と 3 に従って停止します。

    • スーパーバイザーから受け取ったカテゴリが不明または無効な場合は、停止します。