View a markdown version of this page

Konfigurationspakete - Amazon Grundgestein AgentCore

Konfigurationspakete

Ein Konfigurationspaket ist ein versionierter, unveränderlicher Snapshot der dynamischen Konfiguration Ihres Agenten — Systemaufforderungen, Modell-IDs, Toolbeschreibungen und alle anderen Schlüssel-Wert-Paare, die Ihr Agent zur Laufzeit liest. Bundles entkoppeln das Verhalten von Agenten vom Code, sodass Sie ändern können, wie Ihr Agent reagiert, ohne Code erneut bereitstellen zu müssen.

Die wichtigsten Konzepte

  • Komponenten werden durch den ARN der AgentCore Ressource, die sie konfigurieren, verschlüsselt (z. B. ein Laufzeit-ARN). Jede Komponente enthält ein configuration Objekt mit beliebigen Schlüssel-Wert-Paaren.

  • Versionen sind unveränderlich. Jedes Update erstellt eine neue Version mit einer eindeutigen UUID. Versionen bilden eine KetteparentVersionIds, ähnlich wie bei Git-Commits.

  • Zweige organisieren die Herkunft der Versionen (zum Beispielmainline,experiment-1).

  • Bundle-Namen müssen mit einem Buchstaben beginnen und können Buchstaben, Ziffern und Unterstriche (keine Bindestriche) enthalten. Muster:. [a-zA-Z][a-zA-Z0-9_]{0,99}

Wann sollten Konfigurationspakete verwendet werden

  • A/B testen. Jede Variante in einem A/B Test verweist auf eine bestimmte Bundle-Version. Das Gateway fügt die Bundle-Referenz in jede Anfrage ein.

  • Empfehlungen. Die Recommendations API kann die aktuelle Konfiguration aus einem Bundle lesen und die optimierte Konfiguration als neue Bundle-Version schreiben.

  • Rollback. Da Versionen unveränderlich sind, können Sie zu jeder vorherigen Version zurückkehren, indem Sie auf deren Versions-ID verweisen.

  • Prüfpfad. Die Versionskette bietet einen vollständigen Verlauf der Konfigurationsänderungen.

Themen