Gießerei Lokal

Mit foundry Local können Sie unterstützte Microsoft Foundry-Modelle auf Ihrem lokalen Computer ausführen, während Sie weiterhin das standardmäßige Agent Framework Python Agent Erfahrung verwenden.

Hinweis

Foundry Local wird derzeit in .NET nicht unterstützt.

Voraussetzungen

Installieren Sie Foundry Local und die lokalen Laufzeitkomponenten, bevor Sie Agent Framework für ein lokales Modell ausführen. Die erste Ausführung kann eine Weile dauern, da das ausgewählte Modell möglicherweise heruntergeladen und geladen werden muss.

Einrichtung

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

Konfiguration

Festlegen des lokalen Standardmodells mit:

FOUNDRY_LOCAL_MODEL="phi-4-mini"

Sie können das Modell auch explizit mit FoundryLocalClient(model="phi-4-mini")übergeben.

Hinweis

FoundryLocalClient lebt im agent_framework.foundry Namespace. Es handelt sich um einen lokalen Chatclient, sodass Sie ihn in der Regel mit einem Standard Agentkoppeln.

Erstellen eines lokalen Agents

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())

Tools

FoundryLocalClient ist ein lokaler Chatclient, der mit einem Standard Agentgekoppelt ist, sodass die unterstützten Tools diejenigen sind, die das ausgewählte lokale Modell tatsächlich aufrufen kann – sie werden nicht von einer gehosteten Laufzeit bereitgestellt. Gehostete Foundry-Tooltypen (get_code_interpreter_tool, get_web_search_toolusw.) sind nicht verfügbar auf FoundryLocalClient.

Werkzeug Status Hinweise
Funktionswerkzeuge ⚠️ Wird nur unterstützt, wenn das ausgewählte lokale Modell Funktionsaufrufe unterstützt. Wird FoundryLocalClient.manager verwendet, um Modellfunktionen zu prüfen.
Toolgenehmigung Bereitgestellt durch den Funktions-Aufruf des Chatclients des Frameworks; funktioniert mit jedem Funktionstoolaufruf.
Codedolmetscher Keine gehostete Laufzeit.
Dateisuche Keine gehostete Laufzeit.
Websuche Keine gehostete Laufzeit.
Gehostete MCP-Tools Nicht von der lokalen Laufzeit verfügbar gemacht.
Lokale MCP-Tools Wird in Ihrem Prozess ausgeführt und funktioniert mit jedem Chatclient.

Modellfunktionen

Nicht jedes lokale Modell unterstützt dieselben Features. Funktionsaufrufe und strukturierte Ausgaben hängen vom ausgewählten Modell ab. Das FoundryLocalClient.manager Hilfsprogramm kann verwendet werden, um den lokalen Katalog und die unterstützten Funktionen zu überprüfen, bevor Sie einen Agent ausführen.

Für zusätzliche Laufzeitsteuerelemente FoundryLocalClient werden auch Optionen wie device, , bootstrapund prepare_model.

Nächste Schritte