View a markdown version of this page

Amazon Bedrock Agents Classic-Wartungsmodus - Amazon Bedrock
MigrationsplanFunktionen vergleichenMigrationsprozessHäufig gestellte FragenWeitere Ressourcen

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

Amazon Bedrock Agents Classic-Wartungsmodus

Amazon Bedrock Agents (eingeführt im November 2023) ist jetzt Amazon Bedrock Agents Classic und steht ab dem 30. Juli 2026 nicht mehr für Neukunden zur Verfügung. Erkunden Sie Amazon Bedrock, um Funktionen zu finden, die denen von Amazon Bedrock Agents Classic ähneln. AgentCore Amazon Bedrock ist weiterhin verfügbar, der Agents Classic-Service befindet sich jedoch im Wartungsmodus.

Dieses Handbuch enthält Informationen zu den Migrationsoptionen für Kunden von Amazon Bedrock Agents Classic.

Anmerkung

Amazon Bedrock wird weiterhin vollständig unterstützt. Nur der Amazon Bedrock Agents Classic-Service steht seit dem 30. Juli 2026 nicht mehr für Neukunden zur Verfügung. Ihre bestehenden Amazon Bedrock-Modelle, Wissensdatenbanken und Guardrails sind nicht betroffen.

Migrationsplan

Wir empfehlen Ihnen, Ihre Amazon Bedrock Agents Classic-Workloads zu Amazon Bedrock zu migrieren. AgentCore AgentCore ist die Plattform zum Erstellen, Verbinden und Optimieren von KI-Agenten. Das Managed Harness In AgentCore bietet einen konfigurationsbasierten Ausgangspunkt, an dem Entwickler das Modell, die Tools und Anweisungen des Agenten deklarieren können. AgentCore kümmert sich um Umgebung, Rechenleistung, Speicher, Identität und Beobachtbarkeit.

Die verwalteten Agenten greifen zu AgentCore (empfohlen)

Das Managed Harness in AgentCore bietet einen konfigurationsbasierten Ausgangspunkt, an dem Entwickler das Modell, die Tools und Anweisungen des Agenten deklarieren können. AgentCore kümmert sich um Rechenleistung, Umgebung, Speicher, Identität und Beobachtbarkeit. Das Gurtzeug unterstützt:

  • Verwaltete Orchestrierungsschleife mit integrierter Tool-Konnektivität

  • Aktionsgruppen, die über das AgentCore Gateway als MCP-Tools bereitgestellt werden (REST-APIs, Lambda-Funktionen oder Codelevel @tools)

  • Gateway-fronted Integration der Wissensdatenbank

  • Inline-Funktionstools für die Wiederherstellung der Kontrolle und für Muster, bei denen der Mensch in die Regelschleife eingreift

  • Code-Interpreter für die Ausführung von Code in der Sandbox

  • Short-term und Langzeitgedächtnis mit konfigurierbaren Strategien

  • Durchsetzung der Leitplanken durch das Gateway AgentCore

  • Persistentes, lückenloses Tracking aller Agentenaktionen

  • Konfiguration der Systemeingabeaufforderung für das allgemeine Verhalten der Agenten

Code-defined Agenten aktiviert AgentCore

Für Workloads, die Funktionen erfordern, die über das deklarative Modell des Harness hinausgehen, können Kunden codedefinierte Agenten direkt auf dem Gerät einsetzen. AgentCore Dieser Pfad unterstützt:

  • Sofortige Überschreibungen in bestimmten Orchestrierungsphasen

  • Multi-agent Muster der Zusammenarbeit und des Vorgesetzten

  • Benutzerdefinierte Orchestrierungslogik

  • Breitere Endpunkte OpenAI-compatible

  • Jedes Framework (Strands LangChain, OpenAI Agents SDK, Claude Agent SDK oder benutzerdefiniert)

Code-defined Agenten profitieren weiterhin von AgentCore der verwalteten Infrastruktur und geben Entwicklern gleichzeitig die volle Kontrolle über den Agentenkreislauf.

Verwenden Sie den Harness, es sei denn, Sie haben einen bestimmten Grund, warum Sie selbst für den Loop verantwortlich sind (z. B. eine vorhandene Agenten-Codebasis, die migriert werden muss, oder eine erweiterte Orchestrierung, die der Harness noch nicht bietet). Kunden können die AgentCore CLI auch verwenden, um bestehende Bedrock Agents Classic-Konfigurationen als Ausgangspunkt für beide Pfade zu importieren.

Funktionen vergleichen

Bedrock Agents Classic AgentCore Gleichwertig
Verwaltete Orchestrierungsschleife Wird sofort mit einem Gurtzeug unterstützt AgentCore
Aktionsgruppen, die über OpenAPI definiert wurden/Funktionsschema und optionaler Lambda-Executor, der vom verwalteten Agenten aufgerufen wird Tools, die über das AgentCore Gateway als MCP-Tools bereitgestellt werden und REST-APIs und Lambda-Funktionen oder @tools auf Codeebene umschließen.
Verknüpfung der Bedrock Knowledge Bases direkt in der Agentenkonfiguration für RAG Gateway-fronted Integration der Wissensdatenbank in AgentCore. Wissensdatenbank, auf die über ein Tool zum Abrufen auf Codeebene zugegriffen werden kann.
Trace-Benutzeroberfläche und APIs, die Vorverarbeitung, Orchestrierung, Aktionsgruppenaufrufen, KB-Abfragen und Beobachtungen von Anfang bis Ende anzeigen AgentCore bietet eine persistente, durchgängige Nachverfolgung aller Agentenaktionen.
Sofortiges Überschreiben der Konfiguration in bestimmten Phasen (Vorverarbeitung, Orchestrierung, Generierung von KB-Antworten, Nachbearbeitung) Die Systemaufforderung auf dem Harness (--system-prompt) deckt das gesamte Verhalten des Agenten ab. Stage-specific Eingabeaufforderungen (Vorverarbeitung, Generierung von KB-Antworten, Nachbearbeitung) werden nicht direkt repliziert. Um ein gleichwertiges Verhalten zu erreichen, müssen Sie die Systemaufforderung mit der Befehlsausführung und selbstverwalteten Skripten kombinieren.
Built-in AMAZON.UserInput Tool für automatische Benutzeraufforderungen und Parameterauswertung während der Orchestrierung Inline-Funktionstools im Kabelbaum. Der Agent ruft das Tool auf, macht eine Pause und gibt tool_use an den Client-Code zurück, der die Benutzerinteraktion verarbeitet und das Ergebnis zurücksendet. Entspricht Return-of-Control. Erfordert eine explizite Werkzeugdefinition und keine automatische Erfassung.
Built-in AMAZON.CodeInterpreter Aktionsgruppe für die Ausführung von Sandbox-Code AgentCore Code-Interpreter
Sitzungs- und Speicherkonfiguration auf dem Agenten (TTL im Leerlauf, Speichertypen, sitzungsübergreifender Speicher) AgentCore Kurz- und Langzeitspeicher (mit unterschiedlichen Speicherstrategien)
Leitplanken und Agentenrichtlinien, die dem Agenten deklarativ zugeordnet sind und bei der Orchestrierung durchgesetzt werden Konfiguration der Leitplanken in Bedrock mit Durchsetzung der Richtlinien am Gateway AgentCore
Multi-agent Rollen für Zusammenarbeit und Routing (z. B. Supervisor-Agenten und Orchestrierungsrollen) Begrenzt. Das Supervisor-Muster ist möglich, indem Agenten als MCP-Tools (Agent-al-Tool) zur Verfügung gestellt werden. Der Routing-Modus mit mehreren Agenten ist heute nicht einfach. Für die vollständige Zusammenarbeit mit mehreren Agenten ist ein benutzerdefinierter Framework-Code erforderlich.
Benutzerdefinierter Orchestrator Wird während der AgentCore Laufzeit unterstützt (stellen Sie benutzerdefinierten Orchestrierungscode direkt bereit). Nicht über Harness verfügbar.
Rückkehr der Steuerung (Agent pausiert für externe Eingaben) Inline-Funktionswerkzeuge im Gurtzeug. Der Agent hält an und gibt tool_use an den Client zurück.

Migrationsprozess

Voraussetzungen für die Migration zu Harness AgentCore

  • Node.js 20+ und AgentCore CLI oder Python 3.10+ mit boto3

  • AWS Anmeldeinformationen in einer Region, in der Harness verfügbar ist. AgentCore Weitere Informationen finden Sie unter Unterstützte AWS Regionen für AgentCore.

  • IAM-Ausführungsrolle mit den erforderlichen Berechtigungen

  • (Optional) Das Agenten-Toolkit für AWS auf der GitHub Website bietet spezielle Fähigkeiten, um Ihre KI-Agenten durch die Migration zu führen.

Migrieren Sie mit dem Agenten-Toolkit für AWS (empfohlen)

Das Agenten-Toolkit für AWS auf der GitHub Website enthält einen amazon-bedrock Skill, der Ihren KI-Agenten (oder Programmierassistenten) durch die gesamte Migration führt. Es inspiziert Ihren vorhandenen Bedrock Agent, prüft die Eignung für die Migration und ordnet jede Komponente ihrem Harness-Äquivalent zu. AgentCore Der Skill fährt dann die AgentCore CLI zum Gerüst und bringt den Kabelbaum zum Einsatz. Es ändert niemals Ihren Quellagenten.

Um den Skill zu verwenden:

  1. Installieren Sie das Agent-Toolkit für AWS. Anweisungen zur Installation des Agent-Toolkits und zur Aktivierung des Skills finden Sie im Agenten-Toolkit für AWS README auf der Website. GitHub

  2. Aktivieren Sie den amazon-bedrock Skill für Ihren Agenten.

  3. (Optional) Für einen optimierten AWS-Zugriff konfigurieren Sie den AWS MCP-Server. Der Skill funktioniert auch mit der AWS CLI und Boto3.

  4. Installieren Sie die neueste Version der AgentCore CLI. Der Skill verwendet die AgentCore CLI, um das Gerüst aufzubauen und den Kabelbaum einzusetzen.

  5. Bitten Sie Ihren Agenten um „Helfen Sie mir, meinen Bedrock Agent auf Harness zu AgentCore migrieren“. Geben Sie die Agenten-ID, den Namen oder die ARN sowie die AWS Region und das Profil an, wenn der Skill dazu auffordert.

  6. Bestätigen Sie das Konto, die Region und den Quellagenten an jedem Checkpoint. Der Skill umfasst ein Komponenteninventar, eine Eignungsprüfung und einen schriftlichen Migrationsplan. Vor der Bereitstellung wird eine Pause eingelegt, bis Sie ihn genehmigen.

Sie können den Skill auch verwenden, um Migrationsfragen zu beantworten, ohne eine Migration durchzuführen. Wenn Ihr Agent eine Funktion ohne validierten Harness-Pfad verwendet, stoppt der Skill und schlägt Alternativen vor.

Manuell migrieren

Wenn Sie es vorziehen, ohne den entsprechenden Skill zu migrieren, oder Ihr Agent nicht für den kompetenzorientierten Pfad in Frage kommt, gehen Sie wie folgt vor, um das System mit der AgentCore CLI zu erstellen. Verwenden Sie die neueste Version der AgentCore CLI.

Schritt 1: Erstellen und konfigurieren

agentcore create --name my-research-agent

Wenn Sie bereits einen Bedrock Agent haben, den Sie replizieren möchten, überprüfen Sie dessen Konfiguration (Modell, Aktionsgruppen, KBs, Prompt-Overrides) und ordnen Sie jeden dem entsprechenden Harness-Parameter zu:

  • model — --model-id

  • action groups— Gateway-Tools

  • KBs— Gateway oder Abruftool

  • prompt — --system-prompt

Tools hinzufügen:

agentcore add tool --harness my-research-agent \
  --type agentcore_browser --name browser
agentcore add tool --harness my-research-agent \
  --type agentcore_code_interpreter --name code-interpreter

Um bestehende Aktionsgruppen über das Gateway zu verbinden:

agentcore add tool --harness my-research-agent \
  --type agentcore_gateway --name my-gateway \
  --gateway-arn arn:aws:bedrock-agentcore:us-west-2:123456789012:gateway/my-gw

Schritt 2: Modell und Systemaufforderung konfigurieren

agentcore add harness \
  --name my-research-agent \
  --model-id us.anthropic.claude-sonnet-4-6-20250514-v1:0 \
  --system-prompt "You are a research assistant." \
  --tools agentcore-browser,code-interpreter

Schritt 3: Bereitstellen und Aufrufen

agentcore deploy
agentcore invoke --harness my-research-agent \
  --session-id "$(uuidgen)" \
  "Research tropical vacation options under $3k"

Überschreiben Sie das Modell bei jedem Aufruf, ohne es erneut bereitzustellen:

agentcore invoke --harness my-research-agent \
  --model-id us.anthropic.claude-opus-4-5-20251101-v1:0 \
  "Summarize this research paper"
Arbeitsspeicher

Standardmäßig aktiviert. Um den Speicherplatz einzelnen Benutzern zuzuweisen, geben Sie Folgendes ein: --actor-id

agentcore invoke --harness my-research-agent \
  --session-id "$(uuidgen)" --actor-id alice \
  "What did we discuss about the Portugal trip?"

Jeder Akteur erhält einen isolierten Speicher. Long-term Strategien, Umfang, extrahiertes Wissen nach Akteurs-ID.

Häufig gestellte Fragen

Auswirkung

Werden meine bestehenden Agenten aufhören zu arbeiten?

Nein. Bestehende Agenten funktionieren weiterhin normal. Alle APIs (UpdateAgent, GetAgent,, ListAgents, DeleteAgent, PrepareAgent, InvokeAgent,, Aktionsgruppen-APIs, Wissensbase-APIs, Alias-APIs usw.) bleiben für alle Kunden verfügbar. Nur CreateAgent und InvokeInlineAgent sind auf Konten ohne vorherige Nutzung beschränkt.

Woher weiß ich, ob mein Konto betroffen ist?

Wenn Ihr Konto in den letzten 12 Monaten Aktivitäten von Bedrock Agents verzeichnet hat, sind Sie auf der Zulassungsliste und nicht betroffen. Dies gilt pro Konto. Wenn Sie mehrere AWS Konten haben, werden nur Konten zugelassen, die Bedrock Agents bereits verwendet haben. Konten ohne vorherige Nutzung erhalten eine AccessDeniedException (HTTP 403), wenn Sie anrufen CreateAgent oder. InvokeInlineAgent

Welchen Fehler erhalte ich, wenn mein Konto nicht auf der Zulassungsliste steht?

Fehlercode: AccessDeniedException (HTTP 403)

Meldung: „Bedrock Agents befindet sich im Wartungsmodus. Die Erstellung neuer Agenten ist für Konten ohne vorherige Nutzung des Dienstes nicht möglich. Weitere Informationen finden Sie unter Amazon Bedrock Agents Classic-Wartungsmodus.“

Muss ich Maßnahmen ergreifen?

Nicht sofort. Ihre bestehenden Workloads sind nicht betroffen. Wir empfehlen jedoch, die Entwicklung neuer Agenten und zukünftige Migrationen zu prüfen AgentCore , da Bedrock Agents Classic keine neuen Funktionen hinzugefügt werden.

Kann ich nach dem 30. Juli in einem neuen Konto eine Ausnahme für Bedrock Agents beantragen?

Nein. Es gibt kein Ausnahmeverfahren. AWS bestimmt automatisch die Zulassungsliste, basierend darauf, ob Ihr Konto in den letzten 12 Monaten Aktivitäten von Bedrock Agents verzeichnet hat. Wenn Sie Agentenfunktionen für ein neues Konto benötigen, verwenden Sie Amazon Bedrock AgentCore, das gleichwertige und erweiterte Funktionen bietet.

Was ist mit der Namensänderung in „Bedrock Agents Classic“?

Dies ist nur ein Namensupdate. Von Ihrer Seite aus ist keine Aktion erforderlich. Bestehende API-Namespaces (Bedrock-Agent), SDK-Clients, CloudFormation Ressourcentypen und IAM-Aktionspräfixe bleiben unverändert.

Funktionieren meine, CDK CloudFormation - oder Terraform-Vorlagen weiterhin?

Ja. Bestehende IaC-Vorlagen, mit denen Bedrock-Agenten erstellt oder verwaltet werden, funktionieren auch weiterhin für Konten, die auf der Liste der zugelassenen Konten stehen. Wenn Sie neue Umgebungen in Konten bereitstellen, ohne dass Bedrock Agents zuvor verwendet wurden, verwenden Sie stattdessen Amazon AgentCore Bedrock-Ressourcen in Ihren Vorlagen.

Werden neue Modellversionen in Bedrock Agents Classic verfügbar sein?

Nein. Der in Bedrock Agents Classic verfügbare Modellkatalog ist ab dem Datum des Inkrafttretens des Wartungsmodus (30. Juli 2026) eingefroren. Neue Modelle, die nach diesem Datum veröffentlicht werden, werden unter verfügbar sein. AgentCore Amazon Bedrock selbst (Model Inference, Knowledge Bases, Guardrails) erhält weiterhin neue Modelle. Diese Einschränkung gilt nur für die Orchestrierungsebene Bedrock Agents Classic.

Wird sich die Preisgestaltung für Bedrock Agents Classic ändern?

Für Bedrock Agents Classic selbst fallen keine Gebühren an. Sie zahlen weiterhin wie bisher nur für die zugrunde liegende Modellinferenz und alle zugehörigen Ressourcen (Wissensdatenbanken, Lambda-Aufrufe usw.).

Migration

Was ist der empfohlene Migrationspfad?

AgentCore ist die empfohlene Plattform. Zwei Pfade sind verfügbar:

  • AgentCore harness — Ein konfigurationsbasiertes Erlebnis, das Bedrock Agents Classic ähnelt. Deklarieren Sie Ihr Modell, Ihre Tools und Anweisungen; AgentCore kümmert sich um Berechnung, Speicher, Identität und Beobachtbarkeit. Dies ist der verwalteten Erfahrung von Bedrock Agents am nächsten.

  • Code-defined Agenten aktiviert AgentCore — Für Workloads, die eine erweiterte Orchestrierung, Zusammenarbeit mit mehreren Agenten oder benutzerdefinierte Logik erfordern. Stellen Sie ein beliebiges Framework (Strands LangChain, OpenAI Agents SDK, Claude Agent SDK oder benutzerdefiniert) auf AgentCore der verwalteten Infrastruktur bereit.

Gibt es ein automatisiertes Migrationstool?

Ja. Ein Agenten-Skill, der Sie durch die direkte Migration von Bedrock Agents Classic zu AgentCore Harness führt, ist im Agenten-Toolkit für AWS auf der Website verfügbar. GitHub Der Skill ist auch über den AWS MCP-Server verfügbar. Anweisungen zur Installation und Verwendung des Skills finden Sie im Agenten-Toolkit für AWS README auf der Website. GitHub Beginnen Sie mit der Aufforderung „Helfen Sie mir, meinen Bedrock Agent auf Harness zu AgentCore migrieren“.

Wie lange dauert die Migration?

Für einfache Agenten (Modell + Aktionsgruppen + Wissensdatenbank) dauert der CLI-Import oder die Einrichtung von Harness Stunden. Der Hauptaufwand besteht darin, den generierten Code zu überprüfen oder Aktionsgruppen hinter dem AgentCore Gateway neu einzusetzen. Komplexe Agenten mit benutzerdefinierten Orchestratoren oder die Zusammenarbeit mehrerer Agenten erfordern mehr Codearbeit.

Gibt es eine Frist für die Migration?

Es gibt keine Frist für die Migration. Bedrock Agents Classic steht Bestandskunden im Wartungsmodus ohne geplantes Enddatum weiterhin zur Verfügung. Da jedoch keine neuen Funktionen geplant sind, empfehlen wir, zu migrieren, um von den laufenden Innovationen AgentCore zu profitieren.

Was ist mit meinen Bedrock Knowledge Bases?

Die Wissensdatenbanken funktionieren weiterhin und sind vom Wartungsmodus nicht betroffen. Wenn Sie zu migrieren AgentCore, verbinden Sie sie über das AgentCore Gateway. Die zugrunde liegende Knowledge Base-Ressource ist unverändert.

Was ist mit meinen Bedrock Guardrails?

Die auf dem Bedrock-Modell konfigurierten Leitplanken gelten auch dann, wenn das Modell über aufgerufen wird. AgentCore Agent-level Die Durchsetzung der Leitplanken ist über Gateway-Richtlinien möglich. AgentCore

Kann ich immer noch dieselben Modelle verwenden?

Ja. AgentCore unterstützt den vollständigen Bedrock-Modellkatalog sowie zusätzliche Anbieter (OpenAI, Gemini und alle OpenAI-compatible Endpunkte). Sie können während der Sitzung zwischen den Modellanbietern wechseln, ohne eine erneute Bereitstellung vornehmen zu müssen.

Wie sieht es mit der Zusammenarbeit mehrerer Agenten aus?

Sie können mithilfe eines beliebigen unterstützten Frameworks Muster für mehrere Agenten zur AgentCore Laufzeit erstellen. Das Managed Harness unterstützt ein „Agent als Tool“ -Muster für einfachere Anwendungsfälle mit mehreren Agenten.

Was ist mit Inline-Agenten?

Konten, die InvokeInlineAgent in den letzten 12 Monaten genutzt wurden, können Inline-Agents weiterhin verwenden. Für neue Entwicklungen bietet das AgentCore Managed Harness gleichwertige Funktionen für kurzlebige Agenten mit zusätzlichen Funktionen (Speicher, statusbehaftete Sitzungen, Tool-Konnektivität über das Gateway). Eine Anleitung zur Migration für Inline-Agenten ist in Kürze verfügbar.

In welchen Regionen ist es AgentCore verfügbar?

AgentCore ist in diesen Regionen verfügbar. Wenn Ihre Bedrock Agents Classic-Workloads in einer Region ausgeführt werden, in der sie AgentCore noch nicht verfügbar sind, können Sie Bedrock Agents Classic in diesen Regionen weiter verwenden und gleichzeitig neue Entwicklungen AgentCore in eine unterstützte Region migrieren.

Preisgestaltung und Support

Wie viel AgentCore kostet das?

AgentCore verwendet für alle Funktionen (Laufzeit, Arbeitsspeicher, Gateway) eine verbrauchsabhängige Preisgestaltung. Es fallen keine gesonderten Gebühren für die Harness Orchestration an. AgentCoreDas Harness ist tokeneffizienter als die internen Eingabeaufforderungen von Bedrock Agents Classic, sodass Kunden möglicherweise vergleichbare oder niedrigere Kosten für die Modellinferenz erwarten. Einzelheiten finden Sie in der Preisgestaltung. AgentCore

Weitere Ressourcen