Microsoft Foundry Agent Service のツールのベスト プラクティス

Microsoft Foundry Agent Service でエージェントを構築すると、ツールはエージェントが実行できる機能 (情報の取得、API の呼び出し、外部サービスへの接続) を拡張します。 この記事は、ツールを効果的に構成し、エージェントが呼び出すタイミングを制御し、データのセキュリティを維持するのに役立ちます。

ヒント

エージェントの手順で、各ツールの目的と使用方法を説明します。 例えば：

When you need information from my indexed documents, use File Search. When you need to call an API, use the OpenAPI tool. When a tool call fails or returns no results, explain what happened and ask a follow-up question.

前提 条件

  • Azure AI Developer ロールまたは同等のアクセス許可を使用して Foundry ポータルで Foundry プロジェクトにアクセスします。
  • 同じプロジェクトにデプロイされたモデル。
  • 使用する予定のツール (例えば、Azure AI 検索、SharePoint、または Bing 基盤調整) に必要な接続の構成。

ツールの使用状況を構成して検証する

ツール呼び出しの信頼性を向上させる

tool_choiceで制御ツールを呼び出す

ツール呼び出しを最も確定的に制御するために、 tool_choice を使用します。

  • auto: モデルは、ツールを呼び出すかどうかを決定します。
  • required: モデルは 1 つ以上のツールを呼び出す必要があります。
  • none: モデルはツールを呼び出しません。

詳細については、Foundry project REST（プレビュー）内のtool_choiceを参照してください。

効果的なツール命令を記述する

  • 手順を特定し、ツールのセットアップと一貫性を保ちます。
  • 各ツールの目的をモデルに伝えます。
  • 重複する複数のツールがある場合は、決定ルールを追加します (たとえば、"内部コンテンツの Web 検索の前にファイル検索を使用する")。

セキュリティで保護されたツールの使用

ツールは、モデルの外部でデータを送受信します。 次のプラクティスを使用して、セキュリティとプライバシーのリスクを軽減します。

  • ツールの出力を信頼できない入力として扱い、重要な値を検証してから操作します。
  • タスクを完了するために必要な情報のみを送信します。
  • プロンプトにキー、トークン、またはその他の資格情報を含めないでください。
  • トレースまたはアプリケーション ログでシークレットをログに記録しないようにします。
  • Microsoft サービス以外のサーバー (サード パーティ製 MCP サーバーなど) に接続する場合は、Foundry ツール カタログ (プレビュー) の検出および管理ツールの考慮事項を確認します。
  • MCP ツールの一元的なルーティングとポリシーの適用が必要な場合は、 AI Gateway を使用したツール ガバナンス (プレビュー) を参照してください。

リージョンとモデル別のツールサポート

リージョンとモデルによって、エージェントで使用できるツールが決まります。

メモ

次の表では、 はい は完全にサポートされ、 いいえ はサポートされていないことを意味し、 制限 付きはツールの構成によって異なる部分的なサポートを意味します。 詳細については、個々のツールのドキュメントを参照してください。

次の表は、 リージョン別のツールの可用性を示しています。

メモ

このリージョンの可用性テーブルでは、サービスの可用性のみが考慮されます。 使用するモデルが同じリージョンでも使用できることを確認する必要があります。

リージョン名 Agent2Agent Azure AI 検索 ブラウザーの自動化 コード インタープリター コンピューターの使用 ファブリックデータエージェント ファイル検索 関数 Bingカスタム検索による基盤 Bing検索での基盤構築 イメージの生成 MCP OpenAPI SharePoint Web Search
australiaeast はい はい はい はい いいえ はい はい はい はい はい はい はい はい はい はい
brazilsouth はい はい はい はい いいえ はい はい いいえ はい はい はい はい はい はい はい
canadaeast はい はい はい はい いいえ はい はい はい はい はい はい はい はい はい はい
eastus はい はい はい はい いいえ はい はい はい はい はい はい はい はい はい はい
eastus2 はい はい はい はい はい はい はい はい はい はい はい はい はい はい はい
francecentral はい はい はい はい いいえ はい はい はい はい はい はい はい はい はい はい
germanywestcentral はい はい はい はい いいえ はい はい はい はい はい はい はい はい はい はい
italynorth はい はい はい はい いいえ はい はい はい はい はい はい はい はい はい はい
japaneast はい はい はい はい いいえ はい はい はい はい はい はい はい はい はい はい
koreacentral はい はい はい はい いいえ はい はい はい はい はい はい はい はい はい はい
northcentralus はい はい はい はい いいえ はい はい いいえ はい はい はい はい はい はい はい
norwayeast はい はい はい はい いいえ はい はい はい はい はい はい はい はい はい はい
polandcentral はい はい はい はい いいえ はい はい はい はい はい はい はい はい はい はい
southafricanorth はい はい はい はい いいえ はい はい はい はい はい はい はい はい はい はい
southcentralus はい はい はい いいえ いいえ はい はい いいえ はい はい はい はい はい はい はい
southeastasia はい はい はい はい いいえ はい はい はい はい はい はい はい はい はい はい
南インド はい はい はい はい はい はい はい はい はい はい はい はい はい はい はい
spaincentral はい はい はい いいえ いいえ はい はい はい はい はい はい はい はい はい はい
swedencentral はい はい はい はい はい はい はい はい はい はい はい はい はい はい はい
スイス・ノース はい はい はい はい いいえ はい はい はい はい はい はい はい はい はい はい
uaenorth はい はい はい はい いいえ はい はい はい はい はい はい はい はい はい はい
uksouth はい はい はい はい いいえ はい はい はい はい はい はい はい はい はい はい
westus はい はい はい はい いいえ はい はい いいえ はい はい はい はい はい はい はい
westus3 はい はい はい はい いいえ はい はい はい はい はい はい はい はい はい はい

ツールは、次のモデルでサポートされています。

メモ

イメージ生成ツールでは、同じ Microsoft Foundry プロジェクトのオーケストレーターとして、gpt-image-1 モデルと大きな言語モデル (LLM) の両方が必要です。

モデル Agent2Agent Azure AI 検索 Azure Functions Bingカスタムの基礎設定 Bing検索の基盤作り ブラウザーの自動化 コード インタープリター コンピューターの使用 ファブリックデータエージェント ファイル検索 Functions イメージの生成 MCP OpenAPI SharePoint Web Search
Cohere-command-r いいえ いいえ いいえ いいえ いいえ いいえ はい いいえ いいえ はい いいえ いいえ いいえ いいえ いいえ いいえ
Cohere-command-r-plus いいえ いいえ いいえ いいえ いいえ いいえ はい いいえ いいえ はい いいえ いいえ いいえ いいえ いいえ いいえ
DeepSeek-R1-0528 いいえ いいえ いいえ いいえ いいえ いいえ はい いいえ いいえ はい いいえ いいえ いいえ いいえ いいえ いいえ
DeepSeek-V3-0324 いいえ はい いいえ はい はい はい はい いいえ はい はい はい いいえ はい はい はい いいえ
DeepSeek-V3.1 いいえ いいえ いいえ はい はい はい はい いいえ はい はい はい いいえ はい はい はい いいえ
FW-DeepSeek-V3.1 いいえ はい いいえ いいえ いいえ いいえ はい いいえ はい はい いいえ いいえ はい はい いいえ いいえ
FW-DeepSeek-V3.2 いいえ はい いいえ いいえ いいえ いいえ はい いいえ はい はい いいえ いいえ はい はい いいえ いいえ
FW-GLM-4.7 いいえ はい いいえ いいえ いいえ いいえ はい いいえ はい はい いいえ いいえ はい はい いいえ いいえ
FW-GLM-5 いいえ はい いいえ いいえ いいえ いいえ はい いいえ はい はい いいえ いいえ はい はい いいえ いいえ
FW-GPT-OSS-120B いいえ はい いいえ いいえ いいえ いいえ はい いいえ はい はい いいえ いいえ はい はい いいえ いいえ
FW-キミ-K2-インストラクト-0905 いいえ はい いいえ いいえ いいえ いいえ はい いいえ はい はい いいえ いいえ はい はい いいえ いいえ
FW-Kimi-K2-Thinking いいえ はい いいえ いいえ いいえ いいえ はい いいえ はい はい いいえ いいえ はい はい いいえ いいえ
FW-Kimi-K2.5 いいえ いいえ いいえ いいえ いいえ いいえ はい いいえ はい はい いいえ いいえ はい はい いいえ いいえ
FW-MiniMax-M2.5 いいえ はい いいえ いいえ いいえ いいえ はい いいえ はい はい いいえ いいえ はい はい いいえ いいえ
FW-Qwen3.5-122B-A10B いいえ はい いいえ いいえ いいえ いいえ はい いいえ はい はい いいえ いいえ はい はい いいえ はい
FW-Qwen3.5-397B-A17B いいえ はい いいえ いいえ いいえ いいえ はい いいえ はい はい いいえ いいえ はい はい いいえ はい
Llama-3.3-70B-Instruct いいえ はい いいえ はい はい はい はい いいえ はい はい はい いいえ はい はい はい はい
Llama-4-Maverick-17B-128E-Instruct-FP8 いいえ いいえ いいえ いいえ いいえ いいえ はい いいえ いいえ はい いいえ いいえ いいえ いいえ いいえ いいえ
Llama-4-Scout-17B-16E-Instruct いいえ いいえ いいえ いいえ いいえ いいえ はい いいえ いいえ はい いいえ いいえ いいえ いいえ いいえ いいえ
MAI-DS-R1 はい いいえ いいえ いいえ いいえ はい はい いいえ いいえ はい はい いいえ はい いいえ いいえ いいえ
Meta-Llama-3.1-405B-Instruct いいえ いいえ いいえ いいえ いいえ いいえ はい いいえ いいえ はい いいえ いいえ いいえ いいえ いいえ いいえ
Mistral-large-2407 いいえ いいえ いいえ いいえ いいえ いいえ はい いいえ いいえ はい いいえ いいえ いいえ いいえ いいえ いいえ
codex-mini いいえ いいえ いいえ いいえ いいえ いいえ はい いいえ いいえ はい いいえ いいえ いいえ いいえ いいえ いいえ
コンピューター使用プレビュー いいえ いいえ いいえ いいえ いいえ いいえ いいえ はい いいえ いいえ いいえ いいえ いいえ いいえ いいえ いいえ
gpt-35-turbo いいえ いいえ いいえ いいえ いいえ いいえ はい いいえ いいえ はい いいえ いいえ いいえ いいえ いいえ いいえ
gpt-4 いいえ いいえ いいえ いいえ いいえ いいえ はい いいえ いいえ はい いいえ いいえ いいえ いいえ いいえ いいえ
gpt-4.1 はい はい いいえ はい はい はい はい いいえ はい はい はい いいえ はい はい はい はい
gpt-4.1-mini はい はい いいえ はい はい はい はい いいえ はい はい はい いいえ はい はい はい はい
gpt-4.1-nano はい はい いいえ はい はい はい はい いいえ はい はい はい いいえ はい はい はい はい
gpt-4.5-preview いいえ いいえ いいえ いいえ いいえ いいえ はい いいえ いいえ はい いいえ いいえ いいえ いいえ いいえ いいえ
gpt-4o はい はい いいえ はい はい はい はい いいえ はい はい はい いいえ はい はい はい はい
gpt-4o-mini はい いいえ いいえ はい はい はい はい いいえ はい はい はい いいえ はい はい はい はい
gpt-5 はい はい いいえ はい はい はい はい いいえ はい はい はい はい はい はい はい はい
gpt-5-chat いいえ いいえ いいえ いいえ いいえ いいえ はい いいえ いいえ はい いいえ いいえ いいえ いいえ いいえ いいえ
gpt-5-codex いいえ いいえ いいえ いいえ いいえ いいえ はい いいえ いいえ はい いいえ いいえ はい いいえ いいえ いいえ
gpt-5-mini いいえ いいえ いいえ いいえ いいえ いいえ はい いいえ いいえ はい いいえ いいえ はい いいえ いいえ はい
gpt-5-nano いいえ いいえ いいえ いいえ いいえ いいえ はい いいえ いいえ はい いいえ いいえ いいえ いいえ いいえ いいえ
gpt-5-pro いいえ いいえ いいえ いいえ いいえ いいえ はい いいえ いいえ はい いいえ いいえ いいえ いいえ いいえ いいえ
gpt-5.1 いいえ はい はい いいえ はい いいえ はい いいえ はい はい はい いいえ はい はい はい はい
gpt-5.1-chat いいえ いいえ いいえ いいえ いいえ いいえ はい いいえ いいえ はい いいえ いいえ いいえ いいえ いいえ いいえ
gpt-5.1-codex いいえ いいえ いいえ いいえ いいえ いいえ はい いいえ いいえ はい いいえ いいえ はい いいえ いいえ いいえ
gpt-5.1-codex-max いいえ いいえ いいえ いいえ いいえ いいえ はい いいえ いいえ はい いいえ いいえ いいえ いいえ いいえ いいえ
gpt-5.1-codex-mini いいえ いいえ いいえ いいえ いいえ いいえ はい いいえ いいえ はい いいえ いいえ いいえ いいえ いいえ いいえ
gpt-5.2 いいえ はい はい いいえ はい いいえ はい いいえ はい はい はい いいえ はい はい はい はい
gpt-5.2-chat はい はい いいえ はい はい はい はい いいえ はい はい はい いいえ はい はい いいえ はい
gpt-5.2-codex いいえ いいえ いいえ いいえ いいえ いいえ はい いいえ いいえ はい いいえ いいえ はい いいえ いいえ いいえ
gpt-5.3-chat はい はい いいえ はい はい はい はい いいえ はい はい いいえ いいえ はい はい はい はい
gpt-5.3-codex はい はい いいえ はい はい はい はい いいえ はい はい いいえ いいえ はい はい はい はい
gpt-5.4 はい はい いいえ はい はい はい はい いいえ はい はい いいえ いいえ はい はい はい はい
gpt-5.4-mini はい はい いいえ はい はい はい はい いいえ はい はい いいえ いいえ はい はい はい はい
gpt-5.4-nano はい はい いいえ はい はい はい はい いいえ はい はい いいえ いいえ はい はい はい はい
gpt-5.4-pro はい はい いいえ はい はい はい はい いいえ はい はい いいえ いいえ はい はい はい はい
gpt-5.5 はい はい いいえ はい はい はい はい いいえ はい はい いいえ いいえ はい はい はい はい
gpt-oss-120b いいえ いいえ いいえ いいえ いいえ いいえ はい いいえ いいえ はい はい いいえ はい いいえ いいえ いいえ
grok-3 いいえ はい いいえ はい はい はい はい いいえ はい はい はい いいえ はい はい はい いいえ
grok-3-mini いいえ いいえ いいえ いいえ いいえ いいえ はい いいえ いいえ はい いいえ いいえ いいえ いいえ いいえ いいえ
grok-4 いいえ いいえ いいえ いいえ いいえ いいえ はい いいえ いいえ はい いいえ いいえ いいえ いいえ いいえ いいえ
grok-4-1-fast-non-reasoning いいえ いいえ いいえ いいえ いいえ いいえ はい いいえ いいえ はい いいえ いいえ いいえ いいえ いいえ いいえ
grok-4-1-fast-reasoning いいえ いいえ いいえ いいえ いいえ いいえ はい いいえ いいえ はい いいえ いいえ いいえ いいえ いいえ いいえ
grok-4-20-non-reasoning いいえ はい いいえ はい はい はい はい いいえ はい はい はい いいえ はい はい はい はい
grok-4-20-reasoning いいえ はい いいえ はい はい はい はい いいえ はい はい はい いいえ はい はい はい はい
grok-4-fast-non-reasoning いいえ いいえ いいえ いいえ いいえ いいえ はい いいえ いいえ はい いいえ いいえ いいえ いいえ いいえ いいえ
grok-4-高速推論 いいえ いいえ いいえ はい いいえ はい はい いいえ いいえ はい はい いいえ はい いいえ いいえ いいえ
mistral-small-2503 いいえ いいえ いいえ いいえ いいえ いいえ はい いいえ いいえ はい いいえ いいえ いいえ いいえ いいえ いいえ
モデルルーター いいえ いいえ いいえ はい はい はい はい いいえ はい はい はい いいえ はい はい はい いいえ
o1 いいえ はい いいえ はい いいえ はい はい いいえ いいえ はい はい いいえ はい いいえ はい はい
o1-mini いいえ いいえ いいえ いいえ いいえ いいえ はい いいえ いいえ はい いいえ いいえ いいえ いいえ いいえ いいえ
o1-preview いいえ いいえ いいえ いいえ いいえ いいえ はい いいえ いいえ はい いいえ いいえ いいえ いいえ いいえ いいえ
o3 はい はい いいえ はい いいえ はい はい いいえ はい はい はい いいえ はい はい いいえ はい
o3-deep-research いいえ いいえ いいえ いいえ いいえ いいえ いいえ いいえ いいえ いいえ いいえ いいえ はい いいえ いいえ はい
o3-mini はい いいえ いいえ はい はい はい はい いいえ はい はい いいえ いいえ いいえ いいえ いいえ いいえ
o3-pro いいえ いいえ いいえ いいえ いいえ いいえ はい いいえ いいえ はい いいえ いいえ いいえ いいえ いいえ いいえ
o4-mini はい いいえ いいえ はい はい はい はい いいえ はい はい はい いいえ はい いいえ はい はい

トラブルシューティング

一般的な問題を解決するには、次のチェックを使用します。

  • エージェントはツールを呼び出しません。
    • ツールがエージェントにアタッチされていることを確認します。
    • モデルでツールがサポートされたことを確認します。
    • 決定論的な動作が必要な場合は、 tool_choice を required に設定します。
    • 実行トレースを確認して、モデルがツール呼び出しを生成したかどうかを確認します。
  • ツール呼び出しでは、空または無関係な結果が返されます。
    • ツールの説明とエージェントの指示を改善します。
    • 取得ツールの場合は、データが取り込まれており、検索可能であることを確認します。
  • ツール呼び出しが失敗する:
    • ツールの構成と認証を確認します。
    • MCP および OpenAPI ツールの場合は、エンドポイントに到達可能であり、予期される応答が返されていることを確認します。

FAQ

ツールが呼び出されたかどうかを検証するにはどうすればよいですか?

実行トレースを確認して、エージェントがツールを呼び出したかどうかを確認し、ツールの入力と出力を検査します。 エンドツーエンドのトレースのセットアップについては、「 アプリケーションのトレース」を参照してください。

ツールの使用をより信頼性の高いものにするにはどうすればよいですか?

ツールの明確な指示から始めます。 決定的なツール呼び出しが必要な場合は、 tool_choiceを使用します。 詳細については、「tool_choiceを使用したコントロール ツールの呼び出し」を参照してください。

関連コンテンツ

ツール管理

検索および検索ツール

データと統合ツール

自動化と生成ツール

  • Last updated on