Activities (アクティビティ)

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

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

注:

Integration Service のアクティビティをエージェント ツールとして使用するには、まずコネクタをインストールし、Integration Service でコネクションを設定する必要があります。詳細については、「コネクタ」をご覧ください。

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

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

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

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

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

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

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

注:

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

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

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

Web 検索

The Web Search tool executes a web search using natural language. Like other tools, the Search field can be inferred from instructions in the system and user prompt. For instance, you can tell your agent to get details on industry trends and competitor activities which would be used to construct a forecasting report.

By offering the instruction in your prompt and adding the Web Search tool, the agent knows it needs to use the tool to access this critical, up-to-date context.

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

Web リーダー

The Web Reader tool gives you the ability to extract text from a specific URL and add that as context for your agent. For instance, you have a specific parts supplier and you want to go to their web page and extract current prices for those parts.

By supplying the URL directly or through the prompt, you ensure that only information from that individual URL is used for surfacing the supplier's prices for specific parts (or any other information contained in that URL).

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

制限事項

現在、Integration Service アクティビティは、Gemini モデルを使用する場合はエージェント ツールとしてサポートされません。