ツールとは

完了

Microsoft Foundry モデルには、ツールを使用して情報を検索したり、タスクを実行したりできるモデルが含まれています。 OpenAI Responses API を使用して送信されたプロンプトでモデルを使用するツールを指定することで、モデルでツールサポートを使用できます。

ツールを使用するようにモデルを構成するアプリケーションの図。

Microsoft Foundry を使用して生成 AI アプリケーションを開発する場合は、Foundry Models でツール呼び出し機能を持つモデルを検索してデプロイできます。 次に、OpenAI Responses API を使用するクライアント アプリケーションを開発し、デプロイされたモデルにプロンプトを送信し、モデルで使用できるツールを指定できます。

既定では、プロンプトに基づいて、ツール (およびツール) を使用するタイミングが モデル によって選択されます。 ツール選択規則を構成し、 Instructions (システム プロンプト) パラメーターを使用してこの選択をガイドできます。

Responses API で使用できる一般的に使用されるツールには、次のようなものがあります。

  • code_interpreter: モデルがコードを生成して実行できる Python 環境。
  • web_search: モデルがインターネット上で一般的な情報を検索できるようにするツール。これにより、トレーニングされたデータよりも最新のデータに基づいて応答を行うことができます。
  • file_search: モデルが専用のベクター検索インデックスにアップロードした特定のファイルを検索できるようにするツールです。これにより、特定の知識で応答をグラウンドにできます。
  • function: モデルがアプリケーション コードでカスタム関数を呼び出すツール。

このモジュールでは、これらのツールについて説明します。

ヒント

これらは、使用可能なツールの 一部 のみを表します。エージェント AI ソリューション用のツールの開発は成長領域です。 OpenAI Response API でサポートされているツールの詳細については、OpenAI 開発者ガイドを参照してください。

Responses API でのツールの指定

モデルから応答を生成するときに、 responses.create() メソッドの呼び出しで 1 つ以上のツールを指定できます。 次の Python 擬似コードの例は、呼び出し可能なツールの一覧が指定されている場所を示しています。

from openai import OpenAI

client = OpenAI(
    base_url={openai_endpoint},
    api_key={auth_key_or_token}
)

response = client.responses.create(
    model={model_deployment},
    instructions="You are a helpful AI assistant.",
    input="Find me some information about vintage computers.",
    # Specify available tools as a JSON list
    tools=[
        { 
            # A tool definition
            "type": "{tool_type}",
            "{tool-specific-setting}": "{value}",
                ...
        },
        { 
            # Another tool definition
            "type": "{another_tool_type}",
            "{tool-specific-setting}": "{value}",
                ...
        }
    ]
)
print(response.output_text)

ヒント

Responses API を使用して Microsoft Foundry のモデルにプロンプトを送信する方法の詳細については、「Microsoft Foundry を使用した生成 AI チャット アプリの開発」モジュールを参照してください。