ファウンドリー・ローカル

Foundry Local を使用すると、標準の Agent Framework Python Agent エクスペリエンスを引き続き使用しながら、サポートされている Microsoft Foundry モデルをローカル コンピューターで実行できます。

注

Foundry Local は現在、.NETではサポートされていません。

前提条件

ローカル モデルに対して Agent Framework を実行する前に、Foundry Local とそのローカル ランタイム コンポーネントをインストールします。 選択したモデルをダウンロードして読み込む必要があるため、最初の実行には時間がかかる場合があります。

Installation

pip install agent-framework-foundry-local --pre

コンフィギュレーション

既定のローカル モデルを次の値で設定します。

FOUNDRY_LOCAL_MODEL="phi-4-mini"

FoundryLocalClient(model="phi-4-mini")を使用してモデルを明示的に渡すこともできます。

注

FoundryLocalClient は、 agent_framework.foundry 名前空間に存在します。 これはローカル チャット クライアントであるため、通常は標準の Agentとペアリングします。

ローカル エージェントを作成する

import asyncio

from agent_framework import Agent
from agent_framework.foundry import FoundryLocalClient

async def main():
    agent = Agent(
        client=FoundryLocalClient(model="phi-4-mini"),
        name="LocalAgent",
        instructions="You are a helpful local assistant.",
    )
    result = await agent.run("What's the weather like in Seattle?")
    print(result)

asyncio.run(main())

ツール

FoundryLocalClient は、標準の Agentとペアになっているローカル チャット クライアントであるため、サポートされているツールは、選択したローカル モデルが実際に呼び出すことができるツールであり、ホストされたランタイムによって提供されません。 ホストされている Foundry ツールの種類 (get_code_interpreter_tool、 get_web_search_toolなど) は、 FoundryLocalClientでは使用できません。

ツール 地位 注
関数ツール ⚠ 選択したローカル モデルが関数呼び出しをサポートしている場合にのみサポートされます。 モデルの機能を検査するには、 FoundryLocalClient.manager を使用します。
ツールの承認 ✅ フレームワークの関数呼び出しチャット クライアントによって提供されます。は、任意の関数ツール呼び出しで機能します。
コード インタープリター ❌ ホストされたランタイムがありません。
ファイル検索 ❌ ホストされたランタイムがありません。
Web 検索 ❌ ホストされたランタイムがありません。
ホストされている MCP ツール ❌ ローカル ランタイムによって公開されません。
ローカル MCP ツール ✅ プロセス内で実行され、任意のチャット クライアントで動作します。

モデル機能

すべてのローカル モデルで同じ機能がサポートされているわけではありません。 関数呼び出しと構造化出力は、選択したモデルによって異なります。 FoundryLocalClient.manager ヘルパーを使用して、エージェントを実行する前に、ローカル カタログとサポートされている機能を検査できます。

追加のランタイム コントロールの場合、 FoundryLocalClient では、 device、 bootstrap、 prepare_modelなどのオプションもサポートされます。

次のステップ

Anthropic

  • Last updated on