次の方法で共有

MCP エージェント作成ツール のコレクション

重要

この記事の一部の情報は、市販される前に大幅に変更される可能性があるプレリリース製品に関するものです。 Microsoft は、ここに記載された情報に関して、明示または黙示を問わず、いかなる保証も行いません。

モデル コンテキスト プロトコル (MCP) を使用すると、サーバーは言語モデルによって呼び出すことができるツールを公開できます。 ツールを使用すると、モデルが外部システムと対話したり、計算を実行したりできます。 各ツールは名前で一意に識別され、そのスキーマを記述するメタデータが含まれています。

この記事では、Security Copilot エージェントを構築するための MCP エージェント作成ツール コレクションの詳細について説明します。

前提条件

エージェント作成コレクションのツール リスト

コレクション内のツールの一覧は次のとおりです。

ツールを検索する (search_for_tools)

用途

このツールは、スキル、エージェント、MCP ツールなどの関連ツールをSecurity Copilotで検索し、意図を満たすために使用できます。

パラメーター

名前 必須 説明
userQuery はい 関連するツールを検索するためのクエリまたは問題ステートメント。 たとえば、Defender インシデントの詳細などです。

エージェントの作成を開始する (start_agent_creation)

用途

このツールは、新しいエージェントの構築を開始するための新しいSecurity Copilot セッションを作成します。

パラメーター

名前 必須 説明
userQuery はい エージェントの問題ステートメント。

Compose エージェント (compose_agent)

用途

このツールは、Security Copilot エージェント YAML の作成を反復処理します。

パラメーター

名前 必須 説明
sessionID はい start_agent_creation ツールは、Security Copilot セッション ID を作成します。 これは、search_for_toolsによって作成されたセッション ID にすることはできません。
userQuery はい エージェント ビルダーが処理するユーザー入力。 これには、確認、明確化、または追加情報を指定できます。
existingDefinition 不要 (省略可能)ツールを編集するための既存のエージェント定義 YAML。 YAML は、このツールの以前の実行から生成することも、コンテキストに YAML ファイルを追加することで提供することもできます。

評価の取得 (get_evaluation)

用途

このツールは、search_for_tools、start_agent_creation、compose_agentツールを実行して結果を取得した後に呼び出されます。

パラメーター

名前 必須 説明
sessionID はい 評価のセッション ID
promptID はい 評価のプロンプト ID
evaluationID はい 評価の評価 ID

エージェントのデプロイ (deploy_agent)

用途

このツールは、エージェントをSecurity Copilotユーザーまたはワークスペース スコープにアップロードします。

パラメーター

名前 必須 説明
agentDefinition はい YAML 形式のエージェント定義。 YAML は、compose_agent ツールから生成することも、コンテキストに YAML ファイルを追加することで提供することもできます。
scope はい エージェントをアップロードするスコープ。 "ユーザー" または "ワークスペース" のみを指定できます。
agentSkillsetName はい エージェント スキルセット名。 エージェント定義 YAML の 'Descriptor' の 'Name' 値と完全に一致する必要があります。
  • Last updated on