Agents ガイド

最終更新日時 2025年10月9日

アクティビティ

エージェントは Integration Service のアクティビティをツールとして使用できます。

エージェントは、セキュリティで保護されて管理された Integration Service のコネクションと、以降のセクションで説明するフィールド設定を通じて、対象のビジネスアプリケーションに対して直接 API 呼び出しを実行できます。

注: すべての Integration Service アクティビティがエージェントで利用できるわけではありません。トリガーや、ファイルの入力と出力が必須のアクティビティはサポートされていません。

ツールとして機能するようにアクティビティを設定する

[デザイン] タブの [ツール] セクションで、[ツールを追加] を選択します。
ツールボックスで、次の手順を実行します。
- 検索バーを使用してアクティビティを検索します。または、
- [アクティビティ] を選択し、コネクタ別に参照します。コネクタを選択すると、サポートされているアクティビティのリストが表示されます。
アクティビティをツールとして追加したら、以下を行うことができます。
1. ツールの名前と説明を編集します。
2. Integration Service の既存のコネクションを選択するか、新しいコネクションを作成する
3. アクティビティの使用方法をエージェントが理解できるように入力フィールドを設定します。

各アクティビティでは既定の説明が提供されています。この説明をカスタマイズして、実行時にエージェントをより適切にガイドすることができます。この手順は任意ですが、出力品質を向上させ、エージェントが特定のユースケースに対してツールをどのように使用すれば良いかを理解するのに役立ちます。

アクティビティの入力メソッドを定義する

エージェントは、アクティビティを正常に実行するために必要な情報を自動的に推論できるため、通常、入力値や出力値を手動で定義する必要はありません。既定では、エージェントはツールの説明とコンテキストに基づいて実行時に適切なフィールド値を決定します。

ただし、コンテキストメニューを使用して別の入力メソッドを選択することで、任意のフィールドについてこの動作を上書きできます。利用可能な入力メソッドは次のとおりです。

プロンプト (既定) – エージェントは、ツールの説明とその他の関連情報を使用して、実行時にフィールドの値を推測します。
引数 – フィールドは、エージェントの入力引数を使用して設定されます。引数を事前に定義しておく必要があります。このオプションは、[エージェントを実行] アクティビティを介して前のワークフローからエージェントにデータを渡す場合に便利です。
静的な値 – フィールドは、エージェントが実行されるたびに変わらない固定値に設定されます。

注:

カスケードフィールドは [プロンプト] の入力メソッドに設定できません。このようなフィールドでは、特定の値 (例: Jira の課題タイプ) を選択すると、アクティビティの残りのフィールドの構造が変更されます。ツールのスキーマは実行時に動的に調整できないため、エージェントはそのようなフィールドの値を推論できません。
その他のフィールドは既定で [プロンプト] に設定され、実行時に LLM によって推論できます。ただし、値を正しく推論するために必要なコンテキストにエージェントがアクセス (事前のツール、プロンプトの文言、または引数を使用するなど) できることを確認する必要があります。

Web からコンテキストを取得する

[Web 検索] と [Web リーダー] は、Web またはパブリックドメインから最新のコンテキストを提供するためにエージェントに追加できる 2 つのファーストパーティツールです。これらのアクティビティは、リアルタイムのデータ (株価、時刻、天気予報、特定の URL で常に利用可能なデータなど) に関する質問に対して使用できます。

Web 検索

[Web 検索] ツールは、自然言語を使用して Web 検索を実行します。他のツールと同様に、[検索] フィールドは、システムプロンプトおよびユーザープロンプトの指示から推論できます。たとえば、業界の動向や競合他社の活動に関する詳細を取得するようにエージェントに指示し、それを使用して予測レポートの作成に使用することができます。プロンプトで指示を出して [Web 検索] ツールを追加すると、エージェントは、この重要な最新のコンテキストにアクセスするためにこのツールを使用する必要があることを認識します。

[Web 検索] は、上位の検索結果に基づいて完全な要約を実行してエージェントに提供します。出力には情報の取得元の URL が含まれます。

Web リーダー

[Web リーダー] ツールでは、特定の URL からテキストを抽出し、それをエージェントのコンテキストとして追加できます。たとえば、特定の部品サプライヤーを利用している場合に、その Web ページにアクセスして、その部品の現在の価格を抽出するとします。サプライヤーの URL を直接またはプロンプトで指定することにより、指定した個々の URL の情報のみを使用して、特定の部品のサプライヤーの価格 (またはその URL に含まれるその他の情報) が表示されます。

[Web 検索] と [Web リーダー] の両方を組み合わせると、エージェントはパブリックドメインで調査を実行し、引用されたソースと URL を使用して特定の詳細を抽出できます。