View a markdown version of this page

Ausführen benutzerdefinierter Agenten - AWS DevOps Agentin
Einen benutzerdefinierten Agenten bei Bedarf ausführenPlanung benutzerdefinierter AgentenTrigger verwaltenEinen Aufruf abbrechenErgebnisse der Tool-Aufrufe

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.

Ausführen benutzerdefinierter Agenten

Sie können einen benutzerdefinierten Agenten bei Bedarf ausführen oder Trigger so konfigurieren, dass er automatisch ausgeführt wird.

Einen benutzerdefinierten Agenten bei Bedarf ausführen

Sie können einen benutzerdefinierten Agenten sofort von der Agentendetailseite oder über Chat ausführen.

So führen Sie einen benutzerdefinierten Agenten von der Detailseite aus:

  1. Navigieren Sie in Ihrer DevOps Agenten-Web-App zur Agenten-Seite.

  2. Wählen Sie den benutzerdefinierten Agenten aus, den Sie ausführen möchten.

  3. Wählen Sie Jetzt ausführen, um den Agenten mit seinen konfigurierten Anweisungen auszuführen.

Um zusätzlichen Kontext für einen bestimmten Lauf bereitzustellen, wählen Sie den Dropdown-Pfeil neben Jetzt ausführen aus, geben Sie eine Aufforderung ein, in der beschrieben wird, worauf sich der Agent bei diesem Aufruf konzentrieren soll, und wählen Sie Mit Aufforderung ausführen aus. Die Aufforderung wird als zusätzlicher Kontext neben der Systemaufforderung an den Agenten übergeben.

Nach dem Start der Ausführung wird der neue Aufruf auf der Registerkarte Verlauf mit dem Status „Ausstehender Start“ angezeigt. Wählen Sie den Aufruf aus, um seinen Verlauf in Echtzeit zu sehen.

So führen Sie einen benutzerdefinierten Agenten mithilfe von Chat aus:

Bitten Sie Chat, den Agenten namentlich auszuführen. Beispiel:

Run my weekly-investigation-report agent.
Run certificate-checker and focus on certificates expiring in the next 7 days.

Wenn Sie in der Chat-Nachricht zusätzlichen Kontext angeben, leitet Chat ihn als Aufforderung für die Ausführung weiter. Wenn Sie keinen zusätzlichen Kontext angeben, wird der Agent nur mit der konfigurierten Systemaufforderung ausgeführt.

Ein benutzerdefinierter Agent kann jeweils nur einen Aufruf ausführen. Wenn der Agent bereits läuft, müssen Sie warten, bis der aktuelle Aufruf abgeschlossen ist, eine Zeitüberschreitung eintritt oder abgebrochen wurde, bevor Sie einen anderen starten.

Planung benutzerdefinierter Agenten

Mit Triggern können Sie einen benutzerdefinierten Agenten automatisch auf der Grundlage definierter Bedingungen ausführen. AWS DevOps Der Agent unterstützt derzeit zeitplanbasierte Trigger, die den Agenten in wiederkehrenden Intervallen mithilfe von EventBridge-compatible Cron- oder Rate-Ausdrücken ausführen.

So erstellen Sie einen Zeitplan-Trigger:

  1. Navigieren Sie in Ihrer DevOps Agenten-Web-App zur Agenten-Seite.

  2. Wählen Sie den benutzerdefinierten Agenten aus, den Sie planen möchten.

  3. Wählen Sie die Registerkarte Triggers.

  4. Wählen Sie die Schaltfläche + (Erstellen).

  5. Geben Sie im Dialogfeld einen Zeitplanausdruck in das Eingabefeld ein. Der Ausdruck muss eines der folgenden Formate haben:

    • Ausdruck „Rate“ — Wird in einem festen Intervall ausgeführt. Format:rate(value unit). Beispiele:

      • rate(1 hour)— Jede Stunde

      • rate(30 minutes)— Alle 30 Minuten

      • rate(7 days)— Alle 7 Tage

    • Cron-Ausdruck — Läuft nach einem bestimmten Zeitplan. Format:cron(minutes hours day-of-month month day-of-week year). Beispiele:

      • cron(0 9 ? * MON-FRI *)— Jeden Wochentag um 9:00 Uhr UTC

      • cron(0 0 1 * ? *)— Erster Tag eines jeden Monats um Mitternacht UTC

      • cron(0 */6 ? * * *)— Alle 6 Stunden

Eine grüne Bestätigungsnachricht erscheint, wenn der Ausdruck gültig ist.

  1. Wählen Sie Erstellen aus.

Bei Cron-Ausdrücken muss genau eins von Tag des Monats oder Wochentag sein ? (Fragezeichen). Weitere Informationen zur Syntax von Zeitplanausdrücken finden Sie unter Zeitplantypen im Amazon EventBridge Scheduler-Benutzerhandbuch.

Nach der Erstellung erscheint der Trigger in der Liste mit seinem Ausdruck, seinem Erstellungsdatum und der nächsten geplanten Laufzeit.

Trigger verwalten

Auf der Registerkarte Trigger werden alle Trigger angezeigt, die für den benutzerdefinierten Agenten konfiguriert sind. Für jeden Trigger können Sie den Zeitplanausdruck sehen, wann er erstellt wurde und wann er das nächste Mal ausgeführt wird.

Einen Trigger pausieren:

Um vorübergehend zu verhindern, dass ein Trigger den Agenten aufruft, ohne ihn zu löschen, schalten Sie den Kippschalter neben dem Trigger aus. Der Status des Triggers ändert sich in „Angehalten“ und wird erst ausgelöst, wenn er wieder aktiviert wird. Schalten Sie den Schalter wieder ein, um den Zeitplan fortzusetzen.

Löschen eines Triggers:

Um einen Trigger dauerhaft zu entfernen, wählen Sie das Löschsymbol (Mülleimer) neben dem Trigger, den Sie entfernen möchten. Bestätigen Sie den Löschvorgang im daraufhin angezeigten Dialogfeld. Gelöschte Trigger können nicht wiederhergestellt werden.

Einen Aufruf abbrechen

Sie können einen laufenden Aufruf in der Aufruftrajektorienansicht oder über Chat abbrechen.

Um einen laufenden Aufruf in der Trajektorienansicht abzubrechen:

  1. Wählen Sie auf der Registerkarte „Verlauf“ den laufenden Aufruf aus.

  2. Wählen Sie oben in der Trajektorienansicht „Abbrechen“.

So brechen Sie einen laufenden Aufruf mithilfe von Chat ab:

Cancel the running invocation of weekly-health-report.

Der Status des Aufrufs ändert sich in „Abgebrochen“. Jede Arbeit, die vor dem Abbruch abgeschlossen wurde, wird in der Trajektorie beibehalten. Tool-Aufrufe, die zum Zeitpunkt des Abbruchs im Gange waren, können noch abgeschlossen werden.

Ergebnisse der Tool-Aufrufe

Während des Aufrufs ruft der benutzerdefinierte Agent MCP-Tools auf, um Daten zu sammeln, Aktionen auszuführen und Ausgaben zu erzeugen. Jeder Werkzeugaufruf und sein Ergebnis werden in der Aufruftrajektorie aufgezeichnet.

Die Ergebnisse der Tool-Aufrufe bieten Transparenz darüber, was der Agent während des Aufrufs getan hat:

  • Erfolgreiche Tool-Aufrufe — Das Tool hat Daten zurückgegeben, die der Agent verwendet, um seine Arbeit fortzusetzen. query_cloudwatch_logsGibt beispielsweise Protokolleinträge oder API-Antworten use_aws zurück.

  • Fehlgeschlagene Tool-Aufrufe — Das Tool hat einen Fehler zurückgegeben. Der Agent kann es erneut versuchen, eine alternative Methode ausprobieren oder den Fehler in seiner Ausgabe melden.

Sie können einzelne Tool-Aufrufe und ihre Ergebnisse im Aufrufverlauf überprüfen, um das Verhalten des Agenten zu verstehen, zu überprüfen, ob er auf die richtigen Ressourcen zugegriffen hat, und um unerwartete Ergebnisse zu beheben. Weitere Informationen zum Anzeigen von Trajektorien finden Sie unter Anzeigen einer Aufruftrajektorie.