Was ist Microsoft Foundry Agent Service?

Der Foundry Agent Service ist eine verwaltete Plattform zum Erstellen, Bereitstellen und Skalieren von KI-Agents. Verwenden Sie jedes Framework, jedes unterstützte Modell aus dem Foundry-Modellkatalog und die Antwort-API als einzelnen Einstiegspunkt.

Sie wählen aus, wie viel von der gewünschten Plattform Sie benötigen:

• Eingabeaufforderungs-Agents – Erstellen Sie einen Eingabeaufforderungs-Agent im Foundry-Portal, oder definieren Sie ihn mit SDKs und REST, und Foundry führt ihn für Sie aus. Kein Anwendungscode, der verwaltet werden muss, keine Berechnung für die Bezahlung und keine Container oder Pakete zum Optimieren, Skalieren oder Patchen.
• Hosted Agents – schreiben Sie Ihren Agentcode mit Agent Framework>, LangGraph, das OpenAI Agents SDK, das Anthropic Agent SDK, das GitHub Copilot SDK oder Ihren eigenen Code, Packen Sie es als Container, und lassen Sie Foundry es mit einem verwalteten Endpunkt, Skalierung, Identität und Observability ausführen.

Verfügen Sie bereits über Agentcode, der außerhalb von Foundry ausgeführt wird? Rufen Sie die Antwort-API aus Ihrem vorhandenen Prozess auf, um Foundry-Modelle und Plattformtools abzurufen, ohne Ihren Code zu verschieben.

Was ist ein Agent?

Ein Agent ist eine KI-Anwendung, die ein Modell aus dem Foundry-Modellkatalog verwendet, um über Benutzeranforderungen zu gründen und autonome Aktionen zu ergreifen, um sie zu erfüllen. Im Gegensatz zu einem einfachen Chatbot, der nur Text generiert, kann ein Agent Tools aufrufen, auf externe Daten zugreifen und Entscheidungen über mehrere Schritte treffen, um eine Aufgabe auszuführen. In einigen Fällen handeln Agents überhaupt ohne Chatschnittstelle – arbeiten autonom im Hintergrund, ausgelöst durch Systemereignisse, um Aufgaben im Auftrag eines Benutzers oder einer Organisation auszuführen.

Jeder Agent kombiniert drei Kernkomponenten:

• Modell: Ein Modell aus dem Foundry-Modellkatalog, das Schlussfolgerungs- und Sprachfähigkeiten bereitstellt.
• Anweisungen: Definieren von Zielen, Einschränkungen und Verhalten. In Foundry können Anweisungen eingabeaufforderungsbasiert oder Code in einem gehosteten Agent sein.
• Tools: Bieten Sie Zugriff auf Daten oder Aktionen, z. B. Suchen, Dateivorgänge oder API-Aufrufe.

Agent-Dienst auf einen Blick

Erste Schritte mit Agenten

Wählen Sie Ihren Pfad basierend auf dem, was Sie tun möchten:

• Neu bei Agenten?Beginnen Sie mit einem Eingabeaufforderungs-Agent – erstellen Sie einen Agent im Foundry-Portal, wählen Sie ein Modell aus, fügen Sie Tools an, und rufen Sie ihn dann aus Code auf. Kein Laufzeitcode zum Schreiben oder Warten – Foundry führt den Agent für Sie aus.
• Möchten Sie einen codebasierten Agent in Foundry erstellen?Bereitstellen eines gehosteten Agents – Schreiben Sie Ihren Agent mit Agent Framework, LangGraph, dem OpenAI Agents SDK oder Ihrem eigenen Code, packen Sie ihn als Container, und lassen Sie Foundry es mit einem verwalteten Endpunkt, einer Skalierung und Identität ausführen.
• Möchten Sie Foundry-Modelle und Tools aus Dem Agentcode verwenden, den Sie bereits an anderer Stelle ausführen?Rufen Sie die Antwort-API aus Ihrem vorhandenen Prozess auf, um Foundry-Modelle und Plattformtools abzurufen, ohne Ihren Code zu verschieben.

Agenttypen

Es gibt zwei Haupt-Agent-Typen im Agentdienst:

• Prompt-Agents – im Portal oder per Code erstellen, vollständig verwaltete Laufzeitumgebung.
• Gehostete Agents (Vorschau) – Ihr Agentcode, der von Foundry ausgeführt wird.

Prompt-Agenten

Prompt-Agenten werden vollständig über die Konfiguration definiert – durch Anweisungen, Modellauswahl und Tools. Sie erstellen sie im Foundry-Portal für einen Schnellen Start, oder definieren Sie sie programmgesteuert mit den SDKs oder der REST-API, um sie in Ihre CI/CD-Workflows zu integrieren. So oder so betreibt Foundry den Agenten für Sie — es gibt keinen Anwendungscode, den Sie warten müssen, keine Rechenleistung, für die Sie bezahlen müssen, und keine Container oder Pakete, die Sie im Hinblick auf Sicherheit optimieren, skalieren oder überwachen müssen.

Zwei Pfade für die ersten Schritte:

• Portal-first – Erstellen Sie einen Agent interaktiv im Foundry-Portal, testen Sie ihn im Playground, und rufen Sie ihn aus Ihrem Anwendungscode auf.
• Code first – Definieren Sie den Agent mithilfe der SDK- oder REST-API in Ihrer Bereitstellungspipeline, und aktivieren Sie die Versionssteuerung, Codeüberprüfung und automatisiertes Rollout.

Am besten für: einen schnellen Einstieg, interne Tools, Produktions-Agenten, die keine benutzerdefinierte Orchestrierungslogik benötigen, und Teams, die eine verwaltete Laufzeitumgebung ohne Infrastruktur-Overhead wollen.

Gehostete Agents (Vorschau)

Hosted Agents sind codebasierte Agents, die Sie mit Agent Framework erstellen>, LangGraph, das OpenAI Agents SDK, das Anthropic Agent SDK, das GitHub Copilot SDK, oder Ihren eigenen Code. Versenden Sie Ihren Agent entweder als Containerimage oder als Zip-Datei Ihres Quellcodes – Foundry erstellt das Image für Sie, wenn Sie eine Zip-Datei mitbringen , und Foundry führt es mit einem verwalteten Endpunkt, einer automatischen Skalierung, einer dedizierten Microsoft Entra Identität, Persistenz auf Sitzungsebene und End-to-End-Observability aus.

Unter der Haube ruft Ihr Agentcode die api Responses API auf Ihrem Foundry-Projektendpunkt für Modellableitungen und Tool-Orchestrierung auf, die Ihnen Zugriff auf Foundry-Modelle aus dem Katalog und einen einheitlichen Satz von Plattformtools bietet – Standard-OpenAI-Tools wie Dateisuche, Codedolmetscher und Websuche sowie Foundry-exklusive Tools wie SharePoint, WorkIQ und Fabric IQ.

Am besten geeignet für: Agents, die Ihren eigenen benutzerdefinierten Code aufrufen; in zweiter Linie für benutzerdefinierte Orchestrierungslogik, Multi-Agenten-Systeme und benutzerdefinierte Protokolle (Webhooks, Sprache, AG-UI), bei denen Sie die volle Kontrolle über die Agentenlogik haben möchten, während Foundry Hosting, Skalierung und Identitätsverwaltung übernimmt.

Wenn Sie Ihren Agentcode lieber außerhalb von Foundry ausführen möchten , z. B. eingebettet in eine vorhandene Anwendung, können Sie weiterhin die Modelle und Plattformtools von Foundry abrufen, indem Sie die Antwort-API direkt aus Ihrem Prozess aufrufen. Siehe So verwenden Sie die Responses API in Ihrem eigenen Code.

Vergleichen von Agenttypen

Verwenden Sie die Responses API in Ihrem eigenen Code

Die Antwort-API ist der endpunkt für einzelne Modelle und Tools hinter jedem Agenttyp. Sie können es direkt aus Ihrem eigenen Code aufrufen, um Foundry-Modelle und Plattformtools abzurufen, ohne eine Agentressource in Foundry zu erstellen. Dieses Muster ist eine Ergänzung zu gehosteten Agents, keine Alternative – derselbe Agent Framework-Code kann bereits heute die Responses API aus Ihrem eigenen Prozess heraus aufrufen und später als containerisierter gehosteter Agent verpackt werden, wenn Sie einen von Foundry verwalteten Endpunkt wünschen.

Siehe Schnellstart: Verwenden der Antwort-API für Endpunktoptionen und End-to-End-Beispiele.

Modellunterstützung

Agent Service funktioniert mit vielen Modellen, die im Foundry-Modellkatalog verfügbar sind. Die vollständige Liste finden Sie unter "Kontingente", "Grenzwerte" und "Regionale Unterstützung".

Werkzeuge

Der Agent-Dienst bietet integrierte Tools und unterstützt benutzerdefinierte Tools, damit Ihre Agents Aktionen ausführen und auf Daten zugreifen können. Eine vollständige Liste finden Sie im Foundry-Toolkatalog. Erweiterte Toolauswahlmuster finden Sie unter bewährte Methoden für Tools.

Foundry unterstützt Remote-MCP-Server, die Sie aus dem Katalog " Tools hinzufügen " im Foundry-Portal hinzufügen können. Beispielsweise kann der Azure DevOps MCP-Server (öffentliche Vorschau) direkt aus dem Katalog hinzugefügt werden. Verbinden Sie Ihre Azure DevOps Organisation, um den Agentzugriff zu aktivieren, und konfigurieren Sie eine Teilmenge der verfügbaren Tools, um zu steuern, welche Aktions-Agents ausführen können. Sie können auch benutzerdefinierte MCP-Server verbinden, die auf Azure Functions gehostet werden, indem Sie den MCP-Webhook-Endpunkt (/runtime/webhooks/mcp) verwenden, um benutzerdefinierte Tools für Ihre Agents verfügbar zu machen.

Zu den unterstützten Authentifizierungsoptionen für MCP-Server und andere Toolverbindungen gehören:

• Schlüsselbasierter Zugriff
• Microsoft Entra (mithilfe der verwalteten Identität des Agenten oder der verwalteten Identität des Projekts)
• OAuth Identity Passthrough (Im Namen von)
• Nicht authentifizierter Zugriff, falls zutreffend

Toolbox (Vorschau)

Mit der Toolbox können Sie einen zusammengestellten Satz von Tools einmal definieren, zentral in Foundry verwalten und über einen einzigen MCP-kompatiblen Endpunkt verfügbar machen. Jede MCP-kompatible Agentlaufzeit oder jeder Client kann eine Toolbox nutzen, unabhängig vom verwendeten Framework. Die Toolboxversionsverwaltung bietet Ihnen die explizite Kontrolle darüber, wann Änderungen wirksam werden– erstellen Sie eine neue Version, testen Sie sie, und stellen Sie sie auf Standard her, wenn Sie bereit sind.

Entwicklungslebenszyklus

Der Agentendienst unterstützt den vollständigen Build-Test-Deploy-Monitor-Workflow:

1. Erstellen – Definieren Sie einen Eingabeaufforderungs-Agent im Portal oder mit dem SDK, oder schreiben Sie einen gehosteten Agent, der die Antwort-API aufruft.
2. Testen – Chatten Sie mit Ihrem Agent im Agents-Playground oder führen Sie lokal aus. MCP-Serverintegrationen, einschließlich benutzerdefinierter MCP-Server, die auf Azure Functions gehostet werden, können direkt im Playground ausgeführt werden, um die Konnektivität, Berechtigungen und Das Verhalten von Tools vor der Veröffentlichung zu überprüfen.
3. Ablaufverfolgung – Überprüfen Sie jeden Modellaufruf, Toolaufruf und Entscheidung mit agent-Ablaufverfolgung.
4. Auswerten – Führen Sie Auswertungen aus, um Qualitäts- und Catch-Regressionen zu messen.
5. Optimieren – Verbessern Sie die Anweisungen Ihres gehosteten Agents automatisch mithilfe des Agent-Optimierers.
6. Veröffentlichen – Stufen Sie Ihren Agent höher auf eine verwaltete Ressource mit einem stabilen Endpunkt.
7. Überwachen – Nachverfolgen der Leistung und Zuverlässigkeit mit Dienstmetriken und Dashboards.

Eine detaillierte Anleitung finden Sie unter Agent Development Lifecycle.

Unternehmensfunktionen

Agent Service bietet Infrastruktur auf Unternehmensniveau für jeden Agent, den Sie bereitstellen:

• Agent-Identität – Jeder Agent kann über eine dedizierte Microsoft Entra Identität verfügen und einen sicheren, bereichsbezogenen Zugriff auf Ressourcen und APIs ermöglichen, ohne Anmeldeinformationen freizugeben. Agentenidentitäten können sich bei externen MCP-Servern authentifizieren, einschließlich der auf Azure Functions gehosteten Server, und OAuth On-Behalf-Of (OBO) wird bei entsprechender Konfiguration unterstützt.
• Private Netzwerke – Führen Sie Agents in Ihrem virtuellen Azure-Netzwerk aus, um die vollständige Netzwerkisolation und die Einhaltung der Datenresidenzanforderungen zu erhalten. Privates Networking ist für Prompt-Agents verfügbar. Gehostete Agents unterstützen bring-your-own Azure Virtual Network (BYO VNet), wobei jede Sitzung in einer vm-isolierten Sandbox ausgeführt wird, die mit Ihrem VNet verbunden ist.
• Role-basierte Zugriffssteuerung – Feinkörnige Berechtigungen über Microsoft Entra und Azure RBAC. Steuern, wer Agents erstellen, aufrufen und verwalten kann.
• Inhaltssicherheit – Integrierte Inhaltsfilter tragen dazu bei, ein promptes Einfügungsrisiko (einschließlich der eingabeaufforderungsübergreifenden Einfügung) zu minimieren und unsichere Ausgaben zu verhindern.

Anweisungen zum Einrichten der Umgebung finden Sie unter "Einrichten Ihrer Umgebung".

Veröffentlichen und Freigeben

Der Agent-Dienst bietet integrierte Versionsverwaltung und -veröffentlichung, damit Ihre Agents von der Entwicklung zur Produktion mit Vertrauen wechseln können.

• Versionsverwaltung – Während Sie an Ihrem Agenten arbeiten, werden Versionen automatisch gesnapshottet. Führen Sie ein Rollback zu einer früheren Version durch, oder vergleichen Sie Änderungen zwischen Versionen.
• Veröffentlichen – Einen Agenten zu einer verwalteten Ressource mit einem stabilen Endpunkt befördern. Veröffentlichte Agents erben die für Ihr Projekt konfigurierten Unternehmensidentitäts- und Zugriffssteuerungen und können programmgesteuert aufgerufen werden.
• Distribution – Teilen Sie veröffentlichte Agents über Microsoft 365 Copilot und Teams und die Entra Agent Registry, und setzen Sie Ihre Agenten dort, wo Ihre Benutzer bereits arbeiten. Der Foundry Agent Service unterstützt die OpenResponses- und Activity-Protokolle für Microsoft 365-Publishing, ein Invocations-Protokoll für die flexible Endpunktintegration mit benutzerdefinierten Apps und Diensten sowie das A2A-Protokoll (Vorschau) für die Agent-zu-Agent-Kommunikation.

Sicherheit, Datenschutz und Compliance

Der Agent-Dienst wurde für Unternehmensworkloads entwickelt, bei denen Sie starke Kontrolle über Identität, Netzwerk, Datenverarbeitung und Sicherheit benötigen.

• Sicherheitskontrollen: Verwenden Sie integrierte Schutzmaßnahmen, um unsichere Ausgaben zu reduzieren und die Risiken von Prompt-Injection-, einschließlich Cross-Prompt-Injection-Angriffen (XPIA), zu mindern.
• Steuerelemente für Netzwerkisolation und Datenresidenz: Verwenden Sie virtuelle Netzwerke, und verwenden Sie Ihre eigenen Ressourcen, um Ihre Anforderungen zu erfüllen.
• Bring Your Own Resources: Verwenden Sie eigene Azure-Ressourcen (zum Beispiel Speicher, Azure KI-Suche und Azure Cosmos DB für den Unterhaltungsstatus), um operative und Complianceanforderungen zu erfüllen. Weitere Informationen finden Sie unter "Eigene Ressourcen verwenden".
• Responsible AI guidance: Eine breitere Reihe von Empfehlungen und Governanceressourcen finden Sie unter Responsible AI für Microsoft Foundry.

Verwandte Inhalte

• Einrichten Ihrer Umgebung
• Lebenszyklus der Agententwicklung
• Bereitstellen Ihres ersten gehosteten Agents
• Toolkatalog
• Kontingente, Grenzwerte und regionale Unterstützung
• Um Hilfe oder eine Verbindung mit der Community herzustellen, treten Sie der Microsoft AI Discord bei.