Übersicht über die Managed Agents API auf der Agent Platform

Dieses Produkt ist ein Pre-GA-Angebot, das den „Bedingungen für Pre-GA-Angebote“ im Abschnitt „Allgemeine Dienstbedingungen“ der dienstspezifischen Nutzungsbedingungen, den Bedingungen für „agentische KI-Dienste“ in den dienstspezifischen Nutzungsbedingungen und den Zusatzbedingungen für Vorschauprodukte auf Basis von generativer KI unterliegt. Pre-GA-Produkte und -Funktionen werden eventuell nur eingeschränkt unterstützt. Änderungen an Pre-GA-Produkten und -Funktionen sind möglicherweise nicht mit anderen Pre-GA-Versionen kompatibel. Weitere Informationen finden Sie unter den Beschreibungen der Startphase.

Diese Pre-GA-Produkte befinden sich in verschiedenen Phasen der internen Tests und Überprüfung. Verwenden Sie daher keine proprietären, sensiblen oder anderen vertraulichen Daten mit diesen Produkten. Diese Produkte stehen Kunden ausschließlich für begrenzte Tests und Evaluierungen zur Verfügung und dürfen nicht für kommerzielle oder Produktionszwecke verwendet werden.

Mit der Managed Agents API auf der Agent Platform können Sie verwaltete, autonome KI-Agenten mit einem einzigen API-Aufruf erstellen. Jeder Agent wird in einer Sandbox-Umgebung ausgeführt, die auf dem Antigravity-Harness basiert. Dort kann er logische Schlussfolgerungen ziehen, planen, Agent-Fähigkeiten nutzen, Code ausführen, im Web suchen sowie Dateien lesen und schreiben.

Hinweis: Die Modellnutzung während der Vorabversion wird zu Standardtarifen abgerechnet. Weitere Informationen finden Sie auf der Preisseite.

Systemarchitektur

Die Managed Agents API auf der Agent Platform nutzt zwei wichtige Schnittstellen:

API	Beschreibung
Agents API	Die Steuerungsebene zum Verwalten von Agents. Damit können Sie Agenten aus Konfigurationen erstellen und ihre Ausführungsumgebungen konfigurieren, einschließlich des Einbindens externer Datenquellen und des Definierens von Netzwerk-Zulassungslisten. Das System wendet diese Konfigurationen auf die Sandbox-Ausführungsumgebung des KI-Agenten an. Für die Verbindung externer Datenquellen und Tools ist eine Authentifizierung erforderlich. Die Einschränkungen werden unter Sicherheit und Best Practices beschrieben.
Interactions API	Dies ist die Datenebene, die als primäre Schnittstelle für die Kommunikation und Interaktion mit Ihren bereitgestellten Agenten zur Laufzeit dient. Er stellt eine Verbindung zum Agenten her, der mit der Agents API erstellt wurde.

Abbildung 1. Systemarchitektur der Managed Agents API auf der Agent Platform.

Für mehr Sicherheit wird jeder Agent in einer isolierten Sandbox-Umgebung ausgeführt. Wenn Sie die Umgebung mit externen Quellen wie Cloud Storage anpassen, lädt das System diese Dateien bei Bedarf direkt in das Dateisystem des Containers. Der Agent kann dann Ergebnisse zurück in Cloud Storage schreiben. Weitere Informationen finden Sie in der Referenz zur Managed Agents API in der Sandbox-Umgebung der Agent Platform.

Sicherheit und Best Practices

Hinweis: Die Agents API befindet sich in der Vorabversion. Es ist für das Testen und Bewerten vorgesehen. Überprüfen Sie die Aktionen und Ausgaben des KI-Agenten, bevor Sie sich in sensiblen Workflows darauf verlassen. Seien Sie vorsichtig, wenn Sie dem KI-Agenten Zugriff auf externe Systeme oder Daten gewähren, um unbeabsichtigte Aktionen des KI-Agenten zu vermeiden, die nicht rückgängig gemacht werden können.

Standardmäßig führen alle KI-Agenten Aktionen in einer Sandbox-Umgebung ohne Zugriff auf externe Systeme, Netzwerke oder Anmeldedaten aus. Der Agent kann nur mit den Dateien, Paketen und Daten in seiner eigenen Sandbox interagieren.

Das bedeutet, dass der Agent standardmäßig keine Netzwerkaufrufe ausführen, nicht auf Datenbanken zugreifen und keine Produktionsinfrastruktur erreichen kann.

Alle Verbindungen außerhalb der Sandbox müssen von Ihnen als Entwickler explizit konfiguriert werden. Weitere Informationen finden Sie unter Netzwerkzugriff konfigurieren.

Netzwerkzugriff

Achtung: Wenn Sie den Netzwerkzugriff aktivieren, kann der Agent ausgehende Anfragen an externe Dienste senden.

Aktivieren Sie diese Option nur, wenn Ihr Anwendungsfall dies erfordert, und beschränken Sie den Zugriff so weit wie möglich.

Wenn Sie den Netzwerkzugriff für eine Umgebung aktivieren, kann der Agent externe APIs erreichen, öffentliche Repositories klonen und Pakete herunterladen. Beachten Sie Folgendes, bevor Sie den Netzwerkzugriff aktivieren:

• Vermeiden Sie die Offenlegung sensibler Endpunkte. Verweisen Sie den Agenten nicht auf interne Dienste, Admin-Bereiche oder Datenbanken, es sei denn, Sie haben die Risiken geprüft und sind bereit, die Aktivitäten des Agenten zu überwachen.
• Aktionen des KI-Agenten prüfen. Wenn der Netzwerkzugriff aktiviert ist, sollten Sie die Interaktionen des KI-Agenten überwachen, insbesondere während der ersten Entwicklungsphase, um sicherzustellen, dass er nur auf die von Ihnen vorgesehenen Ressourcen zugreift.

Best Practices für Anmeldedaten

Wenn Ihr Workflow erfordert, dass sich der Agent bei externen Diensten wie MCP-Servern authentifiziert, sind Sie für die Bereitstellung und den Umfang dieser Anmeldedaten verantwortlich. Beachten Sie die folgenden Richtlinien, um das Risiko zu reduzieren:

• Anmeldedaten mit geringsten Berechtigungen verwenden Erstellen Sie Dienstkonten oder API-Schlüssel nur mit den Berechtigungen, die Ihr Agent benötigt. Vermeiden Sie die Übergabe von Anmeldedaten mit umfassendem oder Administratorzugriff.
• Kurzlebige Tokens bevorzugen Verwenden Sie nach Möglichkeit zeitlich begrenzte Anmeldedaten oder Tokens, die ablaufen, anstatt langlebige API-Schlüssel.
• Übergeben Sie niemals Anmeldedaten, die der KI-Agent nicht verwenden soll. Der Agent kann alle Anmeldedaten verwenden, auf die er Zugriff hat, um die ihm zugewiesene Aufgabe zu erledigen. Geben Sie nur Anmeldedaten an, deren vollen Zugriffsumfang Sie gewähren möchten.
• Anmeldedaten regelmäßig rotieren Behandeln Sie die für den Agent freigegebenen Anmeldedaten wie alle programmatischen Anmeldedaten und rotieren Sie sie regelmäßig.

Externe Tools und APIs verbinden

Die Agents API unterstützt die Verbindung externer Tools und APIs (z. B. MCP-Server), um die Funktionen des KI-Agenten zu erweitern. Dabei gilt:

• Prüfen Sie die Quellen des Tools sorgfältig. Verbinden Sie nur Tools von Quellen, denen Sie vertrauen. Ein schädliches oder schlecht geschriebenes Tool könnte Daten preisgeben oder unbeabsichtigte Aktionen ausführen.
• Toolberechtigungen einschränken: Konfigurieren Sie Tools mit den Mindestberechtigungen, die für Ihren Anwendungsfall erforderlich sind. Wenn ein Tool den Lesemodus unterstützt, verwenden Sie diesen, es sei denn, Schreibzugriff ist erforderlich.
• Testen Sie die Funktion zuerst isoliert. Bevor Sie ein Tool mit einer Produktionsdatenquelle verbinden, sollten Sie es mit Beispiel- oder synthetischen Daten testen, um zu prüfen, ob der Agent es wie erwartet verwendet.

Menschliche Aufsicht

KI-Agenten können mehrstufige Workflows mit einem hohen Maß an Autonomie planen und ausführen. Das ist zwar leistungsstark, bedeutet aber auch, dass Sie eine angemessene Aufsicht ausüben sollten, insbesondere bei Aufgaben, die Daten ändern oder mit externen Systemen interagieren.

Prüfen Sie kritische Ausgaben wie generierten Code, Datentransformationen oder Konfigurationsänderungen immer, bevor Sie sie bereitstellen.

Support und Feedback

Senden Sie eine E-Mail an das öffentliche Diskussionsforum unter [e-mail], um Support und Feedback zur Managed Agents API auf der Agent Platform zu erhalten.

Nächste Schritte

Anleitung

Agenten erstellen und verwalten

Hier erfahren Sie, wie Sie mit der REST API Agenten erstellen, aktualisieren, auflisten, abrufen und löschen.

Referenz

Managed Agents API in der Sandbox-Umgebung der Agent Platform

Informationen zum isolierten Sandbox-Container, zu Berechtigungen und zu vorinstallierten Paketen/Tools

Anleitung

KI-Agenten bewerten

Hier erfahren Sie, wie Sie mit der Managed Agents API erstellte Agenten mithilfe des GenAI Evaluation Service bewerten.