Zum Hauptinhalt springen

Was suchen Sie?

Entdecken Sie unsere Dienstleistungen und erfahren Sie, wie wir Ihnen helfen können, Ihre Ziele zu erreichen

AI Agent Change Management und Versionierung: Wie Sie einen laufenden Agent sicher aktualisieren

Jede Änderung an einem laufenden AI Agent – ein neuer Prompt, eine Modellversion, ein aktualisiertes Tool oder eine erweiterte Berechtigung – ist ein Release: Vergeben Sie einen Versionsbezeichner, prüfen Sie mit demselben Regressions-Set, das den Agent beim Launch freigegeben hat, führen Sie den Rollout stufenweise durch und halten Sie die Vorversion für eine Wiederherstellung bereit.

Solution Review buchen Zugehörige Lösung ansehen

Von Huy Nguyen (David), Founder & CEO · Aktualisiert · 11 Min. Lesezeit

star

Dieser Leitfaden richtet sich an den CTO oder Engineering Lead, der die nächste Prompt-, Modell- oder Tool-Änderung eines Agents freigeben muss, sowie an den Operations-Verantwortlichen, der einen gestuften Rollout beobachtet und entscheidet, ob er ausgeweitet werden soll. Unser Leitfaden zur KI-Automatisierung entscheidet, welcher Prozess einen Agent erhält, und der Service für agentische KI-Automatisierung beschreibt die Umsetzung; diese Seite ist der laufende Release-Prozess, der einen bereits funktionierenden Agent sicher veränderbar hält.

In diesem Leitfaden

Was gilt als Änderung an einem laufenden AI Agent, und braucht sie einen Release-Prozess?

Fünf Dinge verändern das Verhalten eines Agents, und jedes benötigt einen eigenen Versionsbezeichner: der Prompt oder die System-Instructions, die aufgerufene Modellversion, eine Tool- oder MCP-Server-Konfiguration, der gehaltene Berechtigungsumfang und die Workflow-Struktur darum (ein neuer Schritt, ein neuer Zweig in der Logik). Eine sechste Art von Änderung ist leicht zu übersehen, weil niemand im Team sie vorgenommen hat: Ein Modellanbieter aktualisiert das zugrundeliegende Modell hinter einem festen API-Endpunkt, was das Verhalten des Agents genauso verändert wie ein bewusster Modellversions-Bump – und dasselbe Gate erfordert, obwohl kein Pull Request geöffnet wurde. Behandeln Sie nichts hat sich in unserem Repo geaendert als falsches Signal; prüfen Sie die tatsächlich verwendete Modellversion, bevor Sie ein Release als Ursache einer Regression ausschließen. Unser Leitfaden zur Drift-Erkennung zeigt, wie Sie diese sechste Art von Änderung bemerken, bevor ein Nutzer sie bemerkt.

Eine Änderung ohne Versionsbezeichner kann nicht mit dem Vorherigen verglichen werden, lässt sich nicht sauber zurückrollen und macht eine Incident-Untersuchung zur Raterei darüber, welche von mehreren jüngsten Bearbeitungen sie verursacht hat. Versionierung ist keine Bürokratie, die einem funktionierenden Agent aufgesetzt wird; sie macht was hat sich geaendert zur beantwortbaren Frage, wenn beim nächsten Mal etwas anders aussieht – dieselbe Disziplin, die unser Leitfaden zu Incident Response und Rollback bereits voraussetzt, wenn er sagt, man solle zur letzten bekannten, versionsgebundenen Konfiguration zurueckrollen.

Das Gate an die Änderung anpassen: ein Vergleich

Nicht jede Änderung erfordert denselben Aufwand. Eine reine Formulierungsänderung im Prompt, die Umfang oder Tools nicht berührt, kann ein leichteres Gate passieren als ein Modellversions-Bump oder eine neue Berechtigung; passen Sie beides – nicht den Kalender – daran an, wie stark die Änderung das Verhalten verändern kann.

Änderungsklasse Beispiel Mindest-Gate vor jeglichem Live-Traffic Rollout-Pfad
Reine Formulierungsänderung im Prompt Präzisierung einer Anweisung, Korrektur eines Tippfehlers, Umformulierung einer Antwortvorlage Vollständiger Durchlauf gegen das bestehende Regressions-Set (keine neuen Fälle erforderlich) Canary (kleiner Traffic-Anteil), dann vollständige Promotion innerhalb von Stunden bei Stabilität
Prompt-Änderung, die Umfang oder Verhalten verändert Hinzufügen einer neuen Anweisung, Änderung dessen, was der Agent sagen oder tun darf Regressions-Set plus neue Testfälle für das geänderte Verhalten Zuerst Shadow-Modus, dann Canary, dann vollständige Promotion
Modellversionsänderung (einschließlich eines stillen anbieterseitigen Updates) Upgrade auf ein neues Modell-Release oder Feststellung, dass der Anbieter dies bereits durchgeführt hat Vollständiger Neustart von Regressions- und Adversarial-Set, verglichen mit dem eingefrorenen Baseline Shadow-Modus erforderlich; Canary mit einem namentlich genannten Reviewer vor der Promotion
Tool- oder MCP-Konfigurationsänderung Ein neues Tool, ein geänderter API-Vertrag, eine andere Retrieval-Quelle Regressions-Set plus tool-spezifische Testfälle; Zugriffsumfang des Tools separat prüfen Shadow-Modus, dann Canary, dann Promotion mit Freigabe des Tool-Owners
Änderung des Berechtigungsumfangs Erweiterung dessen, worauf der Agent schreiben darf, oder welche Systeme er erreichen kann Regressions-Set plus alle Testfälle, die mit der neu erreichbaren Aktion verknüpft sind Canary unter engem Monitoring; niemals eine Vollpromotion am selben Tag

Eine Änderung, die ihr Gate nicht besteht, erreicht keinen Live-Traffic; sie kehrt in die Entwurfsphase zurück – dieselbe Trennung, die unser Leitfaden zur Evaluierungs-Harness für einen brandneuen Agent verwendet und die nun bei jeder Änderung an einem bereits laufenden Agent wiederverwendet wird.

Die Release-Leiter für einen laufenden Agent

  1. Versionieren Sie, bevor Sie anfassen

    Geben Sie dem Prompt, der Modellreferenz, der Tool-Konfiguration oder dem Berechtigungs-Set einen eigenen Bezeichner, sobald eine Änderung vorgeschlagen wird, gespeichert getrennt von der aktuell laufenden Version. Ein bearbeitbarer Entwurf überschreibt niemals die laufende Konfiguration.

  2. Führen Sie ihn im Shadow-Modus aus

    Senden Sie der neuen Version eine Kopie des echten Traffics, ohne dass ihre Ausgabe jemanden erreicht, und vergleichen Sie ihr Verhalten mit der aktuellen Live-Version bei denselben Eingaben. Hier wird ein stilles Modellanbieter-Update erstmals sichtbar, bevor es einen einzigen echten Nutzer erreicht.

  3. Prüfen Sie ihn gegen das Regressions- und Adversarial-Set

    Die neue Version muss dieselbe Evaluierungs-Suite bestehen, die den ursprünglichen Launch des Agents freigegeben hat, plus alle Fälle, die aus einem früheren Incident hinzugefügt wurden. Eine Version, die nicht besteht, bleibt im Shadow-Modus, unabhängig davon, wie vielversprechend sie informell wirkte.

  4. Promoten Sie sie auf einen Canary-Anteil des Traffics

    Leiten Sie einen kleinen, definierten Prozentsatz zur neuen Version weiter, während der Operations-Verantwortliche die Traces und Kostensignale beobachtet, die unser Observability-Leitfaden entwirft, bevor er weiter ausgeweitet wird.

  5. Ausweiten oder stoppen, bewusst

    Die Promotion auf den vollen Traffic ist eine Entscheidung, die eine namentlich genannte Person auf Basis von Canary-Evidenz trifft, kein Standard nach einer festen Anzahl von Stunden; ein Canary ohne Regression benötigt trotzdem diese explizite Freigabe.

  6. Halten Sie die Vorversion gepinnt, nicht gelöscht

    Die Version, die ein neues Release ablöst, bleibt für ein definiertes Zeitfenster verfügbar und wiederherstellbar, sodass ein Rollback ein Konfigurationsswitch ist, kein Wiederaufbau aus dem Gedächtnis.

  7. Protokollieren Sie das Release

    Halten Sie fest, was sich geändert hat, wer es genehmigt hat, welche Regressionsergebnisse es bestanden hat und wann es den vollen Traffic erreichte – die Versionshistorie, die sowohl die Evaluierungs-Harness als auch ein Incident-Runbook bereits benötigen, wenn sie eingesetzt werden.

Wo KI passt

Netbase JSC arbeitet mit den wichtigsten kommerziellen und Open-Source-KI-Tools und -Modellen, projektspezifisch ausgewählt, und betrachtet einen versionierten Release-Prozess – nicht eine direkte Bearbeitung der Konfiguration eines laufenden Agents – als Teil dessen, was einen Agent sicher veränderbar hält; dieselbe Disziplin, die unser Observability-Leitfaden auf das Beobachten eines laufenden Agents und unser Leitfaden zu Incident Response auf die Wiederherstellung nach einem Incident anwendet.

Welche Liefernachweise existieren und welche nicht

Was existiert. Netbase JSC hat KI-Projekte für nicht namentlich genannte Kunden umgesetzt, strukturiert in Meilensteine, die eine dedizierte Test- und Optimierungsphase umfassen, bevor ein Build sein Review-Dashboard erreichte oder live ging: ein KI-Content-Moderationsmodell für einen Classifieds-Marketplace (F113) und ein WhatsApp-KI-Chatbot mit CRM-Integration, der durch Design, Integration, NLP-Tuning, Testing und Optimierung umgesetzt wurde (F115), zusammen mit anonymisierten RAG-, Document-AI- und MLOps-Engagements (F072). Die eigene Praxis von Netbase JSC umfasst sicheres Code-Review und Versionskontrolle sowie rollenbasierte Zugriffssteuerung (F021), die Grundlage, auf die die Versionshistorie und Zugriffsgrenzen eines Releases angewiesen sind; Netbase JSC hält die ISO-27001-Zertifizierung und eine SOC-2-Type-II-Attestierung für die eigenen Betriebsabläufe (F022, F051, F052). Netbase JSC arbeitet mit Modellen mehrerer kommerzieller und Open-Source-Anbieter, projektspezifisch ausgewählt (F070, F073).

Was nicht existiert. Kein veröffentlichter Netbase-Datensatz nennt einen Rollout-Prozentsatz, eine Release-Anzahl, eine Regressions-Bestehensrate oder eine Time-to-Promotion für irgendeinen Agent. Kein Datensatz beschreibt einen laufenden Agent, der diese exakte Version-Shadow-Canary-Promote-Sequenz in der Produktion durchlaufen hat. Die Zertifizierungen von Netbase JSC decken die eigenen Betriebsabläufe von Netbase JSC ab; sie erstrecken sich nicht auf den Agent eines Kunden, sein Versionierungssystem oder seine Release-Pipeline.

Alternativen: Wer führt den Release-Prozess für einen Agent durch

  • Wer den Agent gebaut hat, bearbeitet ihn direkt, wenn eine Änderung benötigt wird

    Stärke
    Schneller Start, kein neuer Prozess
    Schwäche
    Keine Versionshistorie, keine Shadow- oder Canary-Stufe; eine fehlerhafte Änderung erreicht alle Nutzer gleichzeitig
    Wählen Sie diesen, wenn
    Ein einzelner, risikoarmer, nur intern genutzter Pilot-Agent ohne Live-Nutzer
  • Ein schriftlicher Release-Prozess, der dem im Betriebsmodell des Agents namentlich genannten technischen Verantwortlichen gehört

    Stärke
    Wiederholbar, verwendet dasselbe Regressions-Set, mit dem der Agent gestartet wurde
    Schwäche
    Erfordert Vorabarbeit zur Definition der Änderungstaxonomie und zum Aufbau des Shadow-/Canary-Routings
    Wählen Sie diesen, wenn
    Jeder Agent, der in ein Live-System schreibt oder kundenseitig ist
  • Die integrierte Draft-/Published-Versionierungsfunktion einer Plattform

    Stärke
    Versionshistorie und Umgebungs-Tags sind im Tool enthalten
    Schwäche
    Versionierung ist auf diese Plattform beschränkt; der spätere Wechsel von Agents oder Anbietern erfordert einen eigenen Exit-Plan
    Wählen Sie diesen, wenn
    Der Agent läuft bereits auf einer Plattform mit dieser Funktion, und die Bedingungen des Leitfadens zu Vendor Lock-in und Exit-Planung sind akzeptabel
  • Ein Delivery-Partner baut und pflegt den Release-Prozess

    Stärke
    Ein Team für den Agent, sein Evaluierungs-Set und seine Release-Pipeline
    Schwäche
    Erfordert dieselben Eigentümerschafts- und Freigabefragen wie jedes Delivery-Engagement
    Wählen Sie diesen, wenn
    Kein interner Verantwortlicher vorhanden, oder mehrere Agents benötigen eine einheitliche Release-Disziplin

In der Custom-Development-Praxis von Netbase JSC gehört dem Kunden das für ihn erstellte IP, und die meisten Projekte laufen auf Festpreisverträgen, die nach der Discovery vereinbart werden, wobei auch meilensteinbasierte, monatliche Team-Retainer- und KPI-verknüpfte Konditionen angeboten werden, wo sie besser passen (F067, F069).

Grenzen dieses Leitfadens

  • Dies ist eine Engineering- und Operations-Praxis, keine rechtliche, regulatorische oder Compliance-Beratung; was eine bestimmte Änderung zu dokumentieren oder offenzulegen erfordert, hängt von den betroffenen Daten, dem Sektor und der Jurisdiktion ab.
  • Keine Zahl in diesem Leitfaden ist ein Benchmark: Kein Rollout-Prozentsatz, keine Promotionszeit und keine Regressions-Bestehensrate wird veröffentlicht, da keine als Netbase-Fakt registriert ist.
  • Die Änderungstaxonomie und Release-Leiter sind eine Ausgangsstruktur, kein zertifiziertes Framework; die eigenen Release-Notes und das API-Verhalten eines Anbieters sollten direkt geprüft werden, da Modell-Updates nicht immer nach einem festen Zeitplan angekündigt werden.

Den nächsten Schritt mit einem Netbase-Berater planen

Häufig gestellte Fragen

Nein. Eine reine Formulierungsänderung, die Umfang oder Verhalten nicht verändert, kann das bestehende Regressions-Set durchlaufen und schnell in den Canary gehen; eine Änderung, die verändert, was der Agent sagen oder tun darf, benötigt zuerst den Shadow-Modus, und eine Modell- oder Berechtigungsänderung benötigt die vollständige Leiter.

Ja. Wenn sich das Modell hinter einem festen API-Endpunkt ändert, kann sich das Verhalten des Agents ändern, obwohl niemand einen Prompt bearbeitet oder Code geschrieben hat; prüfen Sie, welche Modellversion tatsächlich in Verwendung ist, und führen Sie sie durch dasselbe Regressions-Set wie jede andere Modellversionsänderung.

Shadow-Modus lässt die neue Version parallel zur Live-Version laufen, ohne dass ihre Ausgabe einen echten Nutzer erreicht, rein zum Verhaltensvergleich; ein Canary-Rollout leitet einen kleinen, definierten Anteil des echten Traffics zur neuen Version und misst sie live, bevor entschieden wird, ob sie ausgeweitet wird.

Nächster Schritt

Teilen Sie uns mit, welcher Agent live ist und welche Prompt-, Modell- oder Tool-Änderung Sie als nächstes planen, und wir werden ein Solution Review buchen, um die Versionstaxonomie, das Regressions-Gate und den gestuften Rollout zu gestalten. Sie können sich auch die Lösung Enterprise AI Agent Platform ansehen oder weitere Netbase-Insights durchsuchen.

KI-Automatisierung und Agenten – Menschen behalten die Kontrolle KI-Automatisierung und Agenten – Menschen behalten die Kontrolle

Netbase bietet KI-Automatisierung und Agenten-Entwicklung für Operations-Teams, die repetitive, mehrstufige Arbeit durch Software erledigen lassen möchten, während Menschen die Freigabe über die wichtigen Entscheidungen behalten. Wir kombinieren regelbasierte Automatisierung mit KI, wo sie Mehrwert schafft, integrieren menschliche Freigaben und messen die Rendite anhand einer Ausgangsbasis.

Mehr erfahren
line
Enterprise-KI-Agenten-Plattform: KI-Agenten mit Freigaben, Audit-Logs und Kostenlimits betreiben Enterprise-KI-Agenten-Plattform: KI-Agenten mit Freigaben, Audit-Logs und Kostenlimits betreiben

Eine Enterprise-KI-Agenten-Plattform ist eine kontrollierte Laufzeitumgebung, in der KI-Agenten mehrstufige Aufgaben über freigegebene Tools planen und ausführen, während Freigaben, Audit-Logs, Zugriffsregeln und Kostenlimits jede Aktion nachvollziehbar halten. Netbase bietet sie als zukunftsorientierte Lösung an, die in Ihrer eigenen Umgebung aufgebaut und nicht als Produkt lizenziert wird.

Mehr erfahren
line

Remote mit Netbase arbeiten

Alle Projekte von Netbase JSC werden remote durchgeführt – Kunden aus jedem Land und jeder Branche können mit uns arbeiten. Netbase hat mit Kunden in 80 Ländern zusammengearbeitet. Verträge und Rechnungen werden von Netbase JSC ausgestellt; die Zahlung erfolgt per Banküberweisung auf das Firmenkonto oder via PayPal Business. Sprechen Sie direkt mit dem CEO, Huy Nguyen (David), per WhatsApp oder E-Mail.

Netbase kontaktieren

Projekt besprechen

Netbase JSC unterstützt Organisationen beim Design, Aufbau, der Modernisierung und dem Betrieb digitaler Produkte und KI-gestützter Geschäftssysteme.
Projektanfragen

project@netbasejsc.com

WhatsApp

+84 937 869 689

Büroadresse

91 Nguyen Chi Thanh, Dong Da, Hanoi, Vietnam

Kontakt

Schildern Sie uns, was Sie aufbauen, modernisieren oder betreiben möchten.

Schildern Sie uns, was Sie aufbauen, modernisieren oder betreiben möchten.

Netbase kontaktieren