Bewährte Methoden für Microsoft Foundry Agent Service

Wenn Sie Agents in Microsoft Foundry Agent Service erstellen, erweitern Tools, was Ihr Agent tun kann – Abrufen von Informationen, Aufrufen von APIs und Herstellen einer Verbindung mit externen Diensten. Dieser Artikel hilft Ihnen, Tools effektiv zu konfigurieren, zu steuern, wann der Agent sie aufruft, und Ihre Daten sicher zu halten.

Tipp

Beschreiben Sie in Ihren Agent-Anweisungen, wofür und wann jedes Tool verwendet werden soll. Zum Beispiel:

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.

Voraussetzungen

  • Zugriff auf ein Foundry-Projekt im Foundry-Portal mit der Azure AI Developer Rolle oder gleichwertigen Berechtigungen.
  • Ein Modell, das im selben Projekt bereitgestellt wird.
  • Alle erforderlichen Verbindungen, die Sie für die geplante Nutzung der Tools konfiguriert haben (z. B. Azure KI-Suche, SharePoint oder Bing Grounding).

Konfigurieren und Überprüfen der Toolverwendung

Verbessern der Zuverlässigkeit von Toolanrufen

Steuerung des Toolaufrufs mit tool_choice

Verwenden Sie tool_choice für die deterministischste Steuerung von Toolaufrufen.

  • auto: Das Modell entscheidet, ob Tools aufgerufen werden sollen.
  • required: Das Modell muss eines oder mehrere Werkzeuge aufrufen.
  • none: Das Modell ruft keine Tools auf.

Ausführliche Informationen finden Sie im tool_choiceFoundry-Projekt REST (Vorschau).

Schreiben effektiver Toolanweisungen

  • Halten Sie die Anweisungen spezifisch und konsistent mit Ihrer Tool-Konfiguration.
  • Teilen Sie dem Modell mit, wofür jedes Tool steht.
  • Wenn mehrere Tools überlappen, fügen Sie eine Entscheidungsregel hinzu (z. B. "Dateisuche vor der Websuche für interne Inhalte verwenden").

Sichere Toolverwendung

Tools senden und empfangen Daten außerhalb des Modells. Verringern Sie Sicherheits- und Datenschutzrisiken mit diesen Methoden:

  • Behandeln Sie Toolausgaben als nicht vertrauenswürdige Eingabe. Validieren Sie kritische Werte, bevor Sie auf sie reagieren.
  • Senden Sie nur die informationen, die zum Abschließen der Aufgabe erforderlich sind.
  • Schließen Sie keine Schlüssel, Token oder andere Anmeldeinformationen in Eingabeaufforderungen ein.
  • Vermeiden Sie die Protokollierung von geheimen Daten in Ablaufverfolgungen oder Anwendungsprotokollen.
  • Wenn Sie eine Verbindung mit nicht Microsoft-Dienste (z. B. MCP-Servern von Drittanbietern) herstellen, überprüfen Sie die Überlegungen in Discover und verwalten Sie Tools im Foundry-Toolkatalog (Vorschau).
  • Wenn Sie eine zentrale Routing- und Richtlinienerzwingung für MCP-Tools benötigen, lesen Sie Tools Governance mit AI Gateway (Vorschau).

Toolunterstützung nach Region und Modell

Region und Modell bestimmen, welche Tools für Ihren Agent verfügbar sind.

Hinweis

In den folgenden Tabellen: Ja bedeutet vollständig unterstützt, Nein bedeutet nicht unterstützt, und eingeschränkt bedeutet teilweise Unterstützung, die je nach Toolkonfiguration variiert. Ausführliche Informationen finden Sie in der Dokumentation zu einzelnen Tools.

Die folgende Tabelle zeigt die Verfügbarkeit des Tools nach Region.

Hinweis

Diese Verfügbarkeitsübersicht berücksichtigt nur die Verfügbarkeit der Dienste. Sie müssen sicherstellen, dass das modell, das Sie verwenden möchten, auch in derselben Region verfügbar ist.

Regionsname Agent2Agent Azure KI-Suche Browserautomatisierung Codedolmetscher Computerverwendung Fabric Daten-Agent Dateisuche Funktion Einführung in die benutzerdefinierte Bing-Suche Fundamentierung mit Bing Search Bildgenerierung MCP OpenAPI SharePoint Websuche
Australia East Ja Ja Ja Ja Nein Ja Ja Ja Ja Ja Ja Ja Ja Ja Ja
südbrasilien Ja Ja Ja Ja Nein Ja Ja Nein Ja Ja Ja Ja Ja Ja Ja
canadaeast Ja Ja Ja Ja Nein Ja Ja Ja Ja Ja Ja Ja Ja Ja Ja
eastus Ja Ja Ja Ja Nein Ja Ja Ja Ja Ja Ja Ja Ja Ja Ja
Eastus2 Ja Ja Ja Ja Ja Ja Ja Ja Ja Ja Ja Ja Ja Ja Ja
francecentral Ja Ja Ja Ja Nein Ja Ja Ja Ja Ja Ja Ja Ja Ja Ja
DeutschlandWestZentral Ja Ja Ja Ja Nein Ja Ja Ja Ja Ja Ja Ja Ja Ja Ja
italienNord Ja Ja Ja Ja Nein Ja Ja Ja Ja Ja Ja Ja Ja Ja Ja
Japaneast Ja Ja Ja Ja Nein Ja Ja Ja Ja Ja Ja Ja Ja Ja Ja
koreacentral Ja Ja Ja Ja Nein Ja Ja Ja Ja Ja Ja Ja Ja Ja Ja
Northcentralus Ja Ja Ja Ja Nein Ja Ja Nein Ja Ja Ja Ja Ja Ja Ja
norwayeast Ja Ja Ja Ja Nein Ja Ja Ja Ja Ja Ja Ja Ja Ja Ja
Polenzentral Ja Ja Ja Ja Nein Ja Ja Ja Ja Ja Ja Ja Ja Ja Ja
southafricanorth Ja Ja Ja Ja Nein Ja Ja Ja Ja Ja Ja Ja Ja Ja Ja
southcentralus Ja Ja Ja Nein Nein Ja Ja Nein Ja Ja Ja Ja Ja Ja Ja
Südostasien Ja Ja Ja Ja Nein Ja Ja Ja Ja Ja Ja Ja Ja Ja Ja
Südindien Ja Ja Ja Ja Ja Ja Ja Ja Ja Ja Ja Ja Ja Ja Ja
spaincentral Ja Ja Ja Nein Nein Ja Ja Ja Ja Ja Ja Ja Ja Ja Ja
schwedencentral Ja Ja Ja Ja Ja Ja Ja Ja Ja Ja Ja Ja Ja Ja Ja
schweiznord Ja Ja Ja Ja Nein Ja Ja Ja Ja Ja Ja Ja Ja Ja Ja
uaenorth Ja Ja Ja Ja Nein Ja Ja Ja Ja Ja Ja Ja Ja Ja Ja
uksouth Ja Ja Ja Ja Nein Ja Ja Ja Ja Ja Ja Ja Ja Ja Ja
Westus Ja Ja Ja Ja Nein Ja Ja Nein Ja Ja Ja Ja Ja Ja Ja
westus3 Ja Ja Ja Ja Nein Ja Ja Ja Ja Ja Ja Ja Ja Ja Ja

Tools werden von den folgenden Modellen unterstützt.

Hinweis

Für das Tool zur Bildgenerierung benötigen Sie sowohl das gpt-image-1-Modell als auch ein großes Sprachmodell (LLM) als Orchestrator im selben Microsoft Foundry-Projekt.

Modell Agent2Agent Azure KI-Suche Azure Functions Anpassung von Bing-Grundlagen Bing-Suche wird verankert Browserautomatisierung Codedolmetscher Computerverwendung Fabric Daten-Agent Dateisuche Funktionen Bildgenerierung MCP OpenAPI SharePoint Websuche Work IQ (Vorschau)
Cohere-command-r Nein Nein Nein Nein Nein Nein Ja Nein Nein Ja Nein Nein Nein Nein Nein Nein Nein
Cohere-command-r-plus Nein Nein Nein Nein Nein Nein Ja Nein Nein Ja Nein Nein Nein Nein Nein Nein Nein
DeepSeek-R1-0528 Nein Nein Nein Nein Nein Nein Ja Nein Nein Ja Nein Nein Nein Nein Nein Nein Nein
DeepSeek-V3-0324 Nein Ja Nein Ja Ja Ja Ja Nein Ja Ja Ja Nein Ja Ja Ja Ja Ja
DeepSeek-V3.1 Nein Nein Nein Ja Ja Ja Ja Nein Ja Ja Ja Nein Ja Ja Ja Ja Ja
FW-DeepSeek-V3.1 Nein Ja Nein Nein Nein Nein Ja Nein Ja Ja Nein Nein Ja Ja Nein Ja Ja
FW-DeepSeek-V3.2 Nein Ja Nein Nein Nein Nein Ja Nein Ja Ja Nein Nein Ja Ja Nein Ja Ja
FW-GLM-4.7 Nein Ja Nein Nein Nein Nein Ja Nein Ja Ja Nein Nein Ja Ja Nein Ja Ja
FW-GLM-5 Nein Ja Nein Nein Nein Nein Ja Nein Ja Ja Nein Nein Ja Ja Nein Ja Ja
FW-GLM-5.1 Nein Ja Nein Nein Nein Nein Ja Nein Ja Ja Nein Nein Ja Ja Nein Ja Ja
FW-GPT-OSS-120B Nein Ja Nein Nein Nein Nein Ja Nein Ja Ja Nein Nein Ja Ja Nein Ja Ja
FW-Kimi-K2-Instruct-0905 Nein Ja Nein Nein Nein Nein Ja Nein Ja Ja Nein Nein Ja Ja Nein Ja Ja
FW-Kimi-K2-Thinking Nein Ja Nein Nein Nein Nein Ja Nein Ja Ja Nein Nein Ja Ja Nein Ja Ja
FW-Kimi-K2.5 Nein Nein Nein Nein Nein Nein Ja Nein Ja Ja Nein Nein Ja Ja Nein Ja Ja
FW-Kimi-K2.6 Nein Nein Nein Nein Nein Nein Ja Nein Ja Ja Nein Nein Ja Ja Nein Ja Ja
FW-MiniMax-M2.5 Nein Ja Nein Nein Nein Nein Ja Nein Ja Ja Nein Nein Ja Ja Nein Ja Ja
FW-Qwen3.5-122B-A10B Nein Ja Nein Nein Nein Nein Ja Nein Ja Ja Nein Nein Ja Ja Nein Ja Ja
FW-Qwen3.5-397B-A17B Nein Ja Nein Nein Nein Nein Ja Nein Ja Ja Nein Nein Ja Ja Nein Ja Ja
GROK-4-20-REASONING Nein Ja Nein Ja Ja Ja Ja Nein Ja Ja Ja Nein Ja Ja Ja Ja Ja
Llama-3.3-70B-Instruct Nein Ja Nein Ja Ja Ja Ja Nein Ja Ja Ja Nein Ja Ja Ja Ja Ja
Llama-4-Maverick-17B-128E-Instruct-FP8 Nein Ja Nein Ja Ja Ja Ja Nein Ja Ja Ja Nein Ja Ja Ja Ja Ja
Llama-4-Scout-17B-16E-Instruct Nein Nein Nein Nein Nein Nein Ja Nein Nein Ja Nein Nein Nein Nein Nein Nein Nein
MAI-DS-R1 Ja Nein Nein Nein Nein Ja Ja Nein Nein Ja Ja Nein Ja Nein Nein Nein Nein
Meta-Llama-3.1-405B-Anweisung Nein Nein Nein Nein Nein Nein Ja Nein Nein Ja Nein Nein Nein Nein Nein Nein Nein
Mistral-large-2407 Nein Nein Nein Nein Nein Nein Ja Nein Nein Ja Nein Nein Nein Nein Nein Nein Nein
claude-haiku-4-5 Ja Ja Nein Nein Nein Ja Ja Nein Ja Ja Nein Nein Ja Ja Ja Ja Ja
claude-mythos-preview Ja Ja Nein Nein Nein Ja Ja Nein Ja Ja Nein Nein Ja Ja Ja Ja Ja
claude-opus-4-1 Ja Ja Nein Nein Nein Ja Ja Nein Ja Ja Nein Nein Nein Ja Ja Ja Ja
claude-opus-4-5 Ja Ja Nein Nein Nein Ja Ja Nein Ja Ja Nein Nein Ja Ja Ja Ja Ja
claude-opus-4-6 Ja Ja Nein Nein Nein Ja Ja Nein Ja Ja Nein Nein Ja Ja Ja Ja Ja
claude-opus-4-7 Ja Ja Nein Nein Nein Ja Ja Nein Ja Ja Nein Nein Ja Ja Ja Ja Ja
claude-sonnet-4-5 Ja Ja Nein Nein Nein Ja Ja Nein Ja Ja Nein Nein Ja Ja Ja Ja Ja
claude-sonnet-4-6 Ja Ja Nein Nein Nein Ja Ja Nein Ja Ja Nein Nein Ja Ja Ja Ja Ja
codex-mini Nein Nein Nein Nein Nein Nein Ja Nein Nein Ja Nein Nein Nein Nein Nein Nein Nein
Computer-Nutzungsvorschau Nein Nein Nein Nein Nein Nein Nein Ja Nein Nein Nein Nein Nein Nein Nein Nein Nein
gpt-35-turbo Nein Nein Nein Nein Nein Nein Ja Nein Nein Ja Nein Nein Nein Nein Nein Nein Nein
gpt-4 Nein Nein Nein Nein Nein Nein Ja Nein Nein Ja Nein Nein Nein Nein Nein Nein Ja
gpt-4.1 Ja Ja Nein Ja Ja Ja Ja Nein Ja Ja Ja Nein Ja Ja Ja Ja Ja
gpt-4.1-mini Ja Ja Nein Ja Ja Ja Ja Nein Ja Ja Ja Nein Ja Ja Ja Ja Ja
gpt-4.1-nano Ja Ja Nein Ja Ja Ja Ja Nein Ja Ja Ja Nein Ja Ja Ja Ja Ja
gpt-4.5-preview Nein Nein Nein Nein Nein Nein Ja Nein Nein Ja Nein Nein Nein Nein Nein Nein Nein
gpt-4o Ja Ja Nein Ja Ja Ja Ja Nein Ja Ja Ja Nein Ja Ja Ja Ja Ja
gpt-4o-mini Ja Nein Nein Ja Ja Ja Ja Nein Ja Ja Ja Nein Ja Ja Ja Ja Ja
gpt-5 Ja Ja Nein Ja Ja Ja Ja Nein Ja Ja Ja Ja Ja Ja Ja Ja Ja
gpt-5-chat Nein Nein Nein Nein Nein Nein Ja Nein Nein Ja Nein Nein Nein Nein Nein Nein Ja
gpt-5-codex Nein Nein Nein Nein Nein Nein Ja Nein Nein Ja Nein Nein Ja Nein Nein Nein Ja
gpt-5-mini Nein Nein Nein Nein Nein Nein Ja Nein Nein Ja Nein Nein Ja Nein Nein Ja Ja
gpt-5-nano Nein Nein Nein Nein Nein Nein Ja Nein Nein Ja Nein Nein Nein Nein Nein Nein Ja
gpt-5-pro Nein Nein Nein Nein Nein Nein Ja Nein Nein Ja Nein Nein Nein Nein Nein Nein Nein
gpt-5.1 Nein Ja Ja Nein Ja Nein Ja Nein Ja Ja Ja Nein Ja Ja Ja Ja Ja
gpt-5.1-chat Nein Nein Nein Nein Nein Nein Ja Nein Nein Ja Nein Nein Nein Nein Nein Nein Nein
gpt-5.1-codex Nein Nein Nein Nein Nein Nein Ja Nein Nein Ja Nein Nein Ja Nein Nein Nein Ja
gpt-5.1-codex-max Nein Nein Nein Nein Nein Nein Ja Nein Nein Ja Nein Nein Nein Nein Nein Nein Nein
gpt-5.1-codex-mini Nein Nein Nein Nein Nein Nein Ja Nein Nein Ja Nein Nein Nein Nein Nein Nein Nein
gpt-5.2 Nein Ja Ja Nein Ja Nein Ja Nein Ja Ja Ja Nein Ja Ja Ja Ja Ja
gpt-5.2-chat Ja Ja Nein Ja Ja Ja Ja Nein Ja Ja Ja Nein Ja Ja Nein Ja Ja
gpt-5.2-codex Nein Nein Nein Nein Nein Nein Ja Nein Nein Ja Nein Nein Ja Nein Nein Nein Ja
gpt-5.3-chat Ja Ja Nein Ja Ja Ja Ja Nein Ja Ja Nein Nein Ja Ja Ja Ja Ja
gpt-5.3-codex Ja Ja Nein Ja Ja Ja Ja Nein Ja Ja Nein Nein Ja Ja Ja Ja Ja
gpt-5.4 Ja Ja Nein Ja Ja Ja Ja Nein Ja Ja Nein Nein Ja Ja Ja Ja Ja
gpt-5.4-mini Ja Ja Nein Ja Ja Ja Ja Nein Ja Ja Nein Nein Ja Ja Ja Ja Ja
gpt-5.4-nano Ja Ja Nein Ja Ja Ja Ja Nein Ja Ja Nein Nein Ja Ja Ja Ja Ja
gpt-5.4-pro Ja Ja Nein Ja Ja Ja Ja Nein Ja Ja Nein Nein Ja Ja Ja Ja Ja
gpt-5.5 Ja Ja Nein Ja Ja Ja Ja Nein Ja Ja Nein Nein Ja Ja Ja Ja Ja
gpt-chat-latest Ja Ja Nein Ja Ja Ja Ja Nein Ja Ja Nein Nein Ja Ja Ja Ja Ja
gpt-oss-120b Nein Nein Nein Nein Nein Nein Ja Nein Nein Ja Ja Nein Ja Nein Nein Nein Ja
grok-3 Nein Ja Nein Ja Ja Ja Ja Nein Ja Ja Ja Nein Ja Ja Ja Ja Ja
grok-3-mini Nein Ja Nein Ja Ja Ja Ja Nein Ja Ja Ja Nein Ja Ja Ja Ja Ja
grok-4 Nein Nein Nein Nein Nein Nein Ja Nein Nein Ja Nein Nein Nein Nein Nein Nein Nein
grok-4-1-schnell-nicht-schlussfolgernd Nein Ja Nein Ja Ja Ja Ja Nein Ja Ja Ja Nein Ja Ja Ja Ja Ja
grok-4-1-fast-reasoning Nein Ja Nein Ja Ja Ja Ja Nein Ja Ja Ja Nein Ja Ja Ja Ja Ja
grok-4-20-Nichtbegründung Nein Ja Nein Ja Ja Ja Ja Nein Ja Ja Ja Nein Ja Ja Ja Ja Ja
grok-4-20-Reasoning Nein Ja Nein Ja Ja Ja Ja Nein Ja Ja Ja Nein Ja Ja Ja Ja Ja
grok-4-fast-non-reasoning Nein Ja Nein Ja Ja Ja Ja Nein Ja Ja Ja Nein Ja Ja Ja Ja Ja
grok-4-fast-reasoning Nein Ja Nein Ja Ja Ja Ja Nein Ja Ja Ja Nein Ja Ja Ja Ja Ja
mistral-small-2503 Nein Nein Nein Nein Nein Nein Ja Nein Nein Ja Nein Nein Nein Nein Nein Nein Nein
Modellrouter Nein Nein Nein Ja Ja Ja Ja Nein Ja Ja Ja Nein Ja Ja Ja Nein Ja
o1 Nein Ja Nein Ja Nein Ja Ja Nein Nein Ja Ja Nein Ja Nein Ja Ja Ja
o1-mini Nein Nein Nein Nein Nein Nein Ja Nein Nein Ja Nein Nein Nein Nein Nein Nein Nein
o1-Preview Nein Nein Nein Nein Nein Nein Ja Nein Nein Ja Nein Nein Nein Nein Nein Nein Nein
o3 Ja Ja Nein Ja Nein Ja Ja Nein Ja Ja Ja Nein Ja Ja Nein Ja Ja
o3-tiefenforschung Nein Nein Nein Nein Nein Nein Nein Nein Nein Nein Nein Nein Ja Nein Nein Ja Ja
o3-mini Ja Nein Nein Ja Ja Ja Ja Nein Ja Ja Nein Nein Nein Nein Nein Nein Ja
o3-pro Nein Nein Nein Nein Nein Nein Ja Nein Nein Ja Nein Nein Nein Nein Nein Nein Nein
o4-mini Ja Nein Nein Ja Ja Ja Ja Nein Ja Ja Ja Nein Ja Nein Ja Ja Ja

Problembehandlung

Verwenden Sie diese Prüfungen, um häufige Probleme zu beheben:

  • Ihr Agent ruft kein Tool auf:
    • Bestätigen Sie, dass das Tool an den Agent angefügt ist.
    • Bestätigen Sie, dass das Modell das Tool unterstützt.
    • Wenn Sie ein deterministisches Verhalten benötigen, setzen Sie tool_choice auf required.
    • Überprüfen Sie Ausführungsablaufverfolgungen, um zu bestätigen, ob das Modell einen Toolaufruf erstellt hat.
  • Toolaufrufe geben leere oder irrelevante Ergebnisse zurück:
    • Verbessern Sie Die Toolbeschreibungen und Agentenanweisungen.
    • Stellen Sie für Abruftools sicher, dass Ihre Daten aufgenommen und durchsuchbar sind.
  • Toolaufrufe schlagen fehl:
    • Überprüfen Sie die Konfiguration und Authentifizierung des Tools.
    • Überprüfen Sie für MCP- und OpenAPI-Tools, ob der Endpunkt erreichbar ist, und gibt erwartete Antworten zurück.
  • Foundry gibt einen Fehler "Tool nicht unterstützt" zurück, obwohl die Tabellen Unterstützung zeigen:
    • Die Verfügbarkeit von Tools erfordert Unterstützung sowohl vom Modell als auch von der Region. Überprüfen Sie die Regionsverfügbarkeitstabelle für Ihre Region und die Modellunterstützungstabelle für Ihr Modell. Wenn beides angezeigt wird No, kann das Tool nicht ausgeführt werden, auch wenn das andere angezeigt wird Yes.
    • Vergewissern Sie sich, dass das Modell tatsächlich im Projekt und in der Region bereitgestellt wird, auf das Sie abzielen. Ein Modell, das ein Tool im Allgemeinen unterstützt, wird möglicherweise nicht in jeder Region bereitgestellt.
    • Probieren Sie eine andere Region oder eine andere Modellbereitstellung aus, die das Tool unterstützt. Beispielsweise wird der Code-Interpreter nicht in Regionen ausgeführt, die no für den Code-Interpreter anzeigen (wie southcentralus und spaincentral), unabhängig davon, welches Modell Sie verwenden.

Häufig gestellte Fragen

Wie kann ich überprüfen, ob ein Tool aufgerufen wurde?

Überprüfen Sie Ausführungsablaufverfolgungen, um zu bestätigen, ob Ihr Agent ein Tool aufgerufen hat, und um Tooleingaben und -ausgaben zu prüfen. Informationen zum Einrichten der End-to-End-Ablaufverfolgung finden Sie unter Trace your application.

Wie kann ich die Verwendung von Tools zuverlässiger machen?

Beginnen Sie mit klaren Toolanweisungen. Wenn Sie deterministische Toolaufrufe benötigen, verwenden Sie tool_choice. Weitere Informationen finden Sie unter Aufrufe des Steuerelement-Tools mit tool_choice.

Toolverwaltung

Abruf- und Suchtools

Daten- und Integrationstools

Automatisierungs- und Erzeugungstools