View a markdown version of this page

Anweisungen des Agenten - AWS DevOps Agentin

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.

Anweisungen des Agenten

Verwenden Sie die Anweisungen des Agenten, um stets verfügbare Anleitungen bereitzustellen, die der AWS DevOps Agent bei jeder Sitzung anwendet. Eine Sitzung ist eine einzelne Konversation oder Untersuchung mit einem Agenten. Wählen Sie auf der Wissensseite in Ihrer Agent Space Operator-Web-App den Tab Anweisungen, um Anweisungen festzulegen, die für alle Agenten gelten, oder legen Sie Anweisungen für einen bestimmten verwalteten Agenten fest, wie z. B. Chat oder Vorfallanalyse. Diese Anweisungen werden als AGENTS.md Datei gespeichert. Im Gegensatz zu solchenDevOps Fähigkeiten von Agenten, die bei Bedarf geladen werden, wenn der Agent der aktuellen Aufgabe eine Skillbeschreibung zuordnet, sind Anweisungen für Agenten immer zu Beginn jeder Sitzung verfügbar, unabhängig davon, woran der Agent gerade arbeitet.

Was sind Agentenanweisungen

Anweisungen für Agenten bieten eine bedingungslose, stets verfügbare Anleitung für Ihre Agenten. Zu Beginn jeder Sitzung ruft der Agentendienst die für Ihren Agentenbereich konfigurierten Anweisungen ab und fügt deren Inhalt direkt in die Eingabeaufforderung des Agentensystems ein. Der Agent entscheidet nicht, ob sie geladen werden sollen; sie sind immer vorhanden.

Jede Agentensitzung erhält Anweisungen sowohl aus den globalen Anweisungen als auch aus den entsprechenden agentenspezifischen Anweisungen, z. B. Chat.

Die Anweisungen des Agenten werden als AGENTS.md Dateien gespeichert und unterscheiden sich DevOps Fähigkeiten von Agenten in mehreren wichtigen Punkten von:

Aspekt Fähigkeit Anweisungen des Agenten (AGENTS.md)
Name und Beschreibung Erforderlich Nicht zutreffend
Format des Inhalts Markdown- oder ZIP-Paket Nur Markdown
Ressourcendateien Unterstützt Nicht unterstützt
Kontextinjektion Auf Abruf (der Agent entscheidet anhand des Abgleichs der Qualifikationsbeschreibungen) Immer (bedingungslos, in jeder Sitzung)
Eindeutigkeit Mehrfach pro Agentenbereich Eine pro Agent (eine für globale Anweisungen, eine pro verwaltetem Agenten)

Anweisungen für Agenten haben weder einen Namen noch ein Beschreibungsfeld. Die zugrundeliegende AGENTS.md Datei enthält nur Markdown ohne Titelthema, keine ZIP-Bundle-Unterstützung und keine Ressourcendateien.

Warum sollten Sie die Anweisungen des Agenten verwenden

Mithilfe von Anweisungen für Agenten können Sie zuverlässig sicherstellen, dass bestimmte Anleitungen immer im Kontext stehen, ohne von den Entscheidungen des Agenten abhängig zu sein, die seine Fähigkeiten beanspruchen.

Die wichtigsten Vorteile:

  • Vorhersagbarkeit: Anweisungen sind immer vorhanden, unabhängig davon, an welcher Aufgabe der Agent gerade arbeitet. Es ist kein Abgleich der Beschreibung erforderlich, und der Agent kann den Inhalt nicht überspringen.

  • Garantierter Umfang: Im Gegensatz zu Skills, die der Agent je nach Aufgabenrelevanz laden kann oder auch nicht, werden die Anweisungen des Agenten immer zu Beginn jeder Sitzung eingegeben.

  • Dauerhafte Richtlinien: Verwenden Sie die Anweisungen des Agenten für ständige Betriebsrichtlinien, Sicherheitsrichtlinien, Programmierstandards oder andere Anleitungen, die ausnahmslos für jede Sitzung gelten müssen.

  • Zielgerichteter Umfang: Sie können Anweisungen auf alle Agententypen gleichzeitig anwenden, indem Sie globale Anweisungen verwenden, oder Anweisungen auf einen bestimmten Agententyp beschränken, wenn die Anleitung nur für die Arbeit dieses Agenten relevant ist.

So funktionieren die Anweisungen des Agenten

Wenn eine Sitzung beginnt, ruft der Agentendienst die für Ihren Agentenbereich konfigurierten Anweisungen ab und fügt ihren Inhalt vor Beginn der Sitzung in die Eingabeaufforderung des Agentensystems ein. Dies geschieht automatisch für jede Sitzung. Der Agent bewertet nicht, ob sie geladen werden sollen; er fügt den Inhalt immer ein.

Bei jeder neuen Sitzung werden die Anweisungen beim Start neu geladen. Wenn Sie Ihre Anweisungen aktualisieren, wird die Änderung sofort für Sitzungen wirksam, die nach dem Speichern beginnen. Bereits laufende Sitzungen verwenden weiterhin den Inhalt, der beim Start geladen wurde.

Der Geltungsbereich bestimmt, welche Anweisungen eine Sitzung erhält. Globale Anweisungen gelten für alle Agententypen in Ihrem Agentenbereich, sodass sie bei jeder Sitzung empfangen werden. Agent-specific Anweisungen gelten nur für Sitzungen dieses bestimmten Agententyps. Eine Sitzung erhält Anweisungen sowohl aus den globalen Anweisungen als auch aus den entsprechenden agentenspezifischen Anweisungen.

Festlegung des Gültigkeitsbereichs des Agententyps

Durch den Geltungsbereich wird gesteuert, welche Agentensitzungen bestimmte Anweisungen erhalten. Es gibt zwei Optionen für den Geltungsbereich:

  • Allgemeine Anweisungen: Gilt für alle Agententypen in Ihrem Agentenbereich. Jede Agentensitzung erhält diesen Inhalt.

  • Agent-specific: Gilt nur für Sitzungen des ausgewählten Agententyps.

Für agentenspezifische Anweisungen stehen folgende verwaltete Agenten zur Verfügung:

  • Chat — Ad-hoc Fragen und Anfragen während Chat-Sitzungen.

  • Vorfallanalyse — Filterung von Alarmen, Klassifizierung des Schweregrads und anfängliche Festlegung des Umfangs.

  • Incident RCA — Ursachenanalyse mit Erfassung und Validierung von Beweisen.

  • Minderung von Vorfällen — Short-term Problembehebung und Empfehlungen zur langfristigen Behebung.

  • Benutzeroberfläche für Vorfälle — Generierung der Ergebnisse einer Untersuchung, einschließlich der Ergebnisse, die auf anderen Plattformen veröffentlicht wurden.

  • Bewertung — Bewertung der Agentenleistung und Überprüfung der Einhaltung von Richtlinien.

  • Versionstests — Automatisierte Benutzeroberflächen- und API-Tests anhand bereitgestellter Webanwendungen und REST-APIs.

Anleitung zur Inhaltsgröße

Jedes Mal, wenn Sie ein Gespräch oder eine Untersuchung beginnen, liest der Agent Ihre gesamten Anweisungen, bevor er etwas anderes tut. Der Agent hat eine feste Menge an Arbeitsspeicher pro Sitzung, und Ihre Anweisungen verwenden einen Teil davon. Je größer die Datei, desto weniger Platz bleibt für Ihre Fragen, Untersuchungen, die Protokolle, die der Agent liest, und seine eigenen Überlegungen. Kürzere, zielgerichtete Anweisungen geben dem Agenten mehr Kapazität, Ihr Problem zu lösen.

  • Harte Grenze: 25 KB

  • Empfohlene Größe: 120 Zeilen (für die meisten Konfigurationen empfohlen)

Konzentrieren Sie sich bei Ihren Anweisungen auf Anleitungen, die in jeder Sitzung vorhanden sein müssen. Für spezielle Ermittlungsverfahren, die nur für bestimmte Aufgaben gelten, sollten Sie DevOps Fähigkeiten von Agenten stattdessen die Anwendung in Betracht ziehen.

Beispiel

Das folgende Beispiel zeigt wohlformulierte Agentenanweisungen mit Hinweisen zur Untersuchung, Standards für die Formatierung von Antworten und Sicherheitsanforderungen, die für jede Agentensitzung gelten.

# Agent Instructions ## Investigation approach - Always check CloudWatch alarms and recent deployments before proposing a root cause. ## Response format - Lead with a one-sentence summary of findings before listing details. - Include the AWS region and resource identifier for any resource you reference. - Use bullet points for lists of findings or recommendations. ## Security - Never log, display, or suggest storing credentials or secrets in plaintext. - When recommending IAM changes, follow least-privilege principles.

Anweisungen für den Agenten festlegen

Bevor Sie die Anweisungen für Agenten festlegen können, müssen Sie über einen Agentenbereich verfügen. Weitere Informationen finden Sie unter Einen Agentenbereich erstellen.

Jeder Agent hat genau einen Befehlssatz. Wenn Sie neue Inhalte speichern, werden die vorhandenen Inhalte für diesen Agenten überschrieben.

So legen Sie globale Anweisungen fest (gilt für alle Agenten):

  1. Navigieren Sie in Ihrer Agent Space Operator-Web-App zur Wissensseite.

  2. Wählen Sie die Registerkarte „Anweisungen“.

  3. Wählen Sie neben „Alle Agenten“ die Option „Anzeigen“ aus.

  4. Geben Sie Ihre Markdown-Anweisungen in den Editor ein.

  5. Wählen Sie Speichern.

So legst du Anweisungen für einen bestimmten Agenten fest:

  1. Navigieren Sie in Ihrer Agent Space Operator-Web-App zur Wissensseite.

  2. Wählen Sie die Registerkarte „Anweisungen“.

  3. Wählen Sie neben dem Agenten, den Sie konfigurieren möchten, die Option „Anzeigen“ aus: Chat, Incident-Triage, Incident-RCA, Incident-Abwehr, Incident-UI , Evaluierung oder Release-Test.

  4. Geben Sie Ihre Markdown-Anweisungen in den Editor ein.

  5. Wählen Sie Speichern.

Anweisungen für den Agenten verwalten

AWS DevOps Agent bietet Verwaltungsfunktionen für Agentenanweisungen über die Operator Web App.

Anweisungen anzeigen: Navigieren Sie zur Wissensseite, wählen Sie die Registerkarte „Anweisungen“ und wählen Sie neben „Alle Agenten“ oder „Der bestimmte verwaltete Agent“ die Option „Anzeigen“. Der Editor zeigt den aktuellen Inhalt an. Verwenden Sie die Registerkarte „Vorschau“, um den gerenderten Markdown anzuzeigen, oder die Registerkarte „Code“, um den unformatierten Markdown anzuzeigen.

Anweisungen zur Bearbeitung: Öffnen Sie den Agenten wie oben beschrieben, ändern Sie den Inhalt im Editor und wählen Sie Speichern.

Anweisungen aus einer Datei hochladen: Öffnen Sie den Agenten und klicken Sie dann im Editor auf die Schaltfläche „Hochladen“, um eine Markdown-Datei von Ihrem Computer hochzuladen.

Anweisungen zum Herunterladen: Öffnen Sie den Agenten und klicken Sie dann im Editor auf die Schaltfläche Herunterladen, um den aktuellen Inhalt als Datei herunterzuladen.

Anweisungen zum Löschen: Öffnen Sie den Agenten, wählen Sie im Editor die Schaltfläche Löschen und bestätigen Sie den Löschvorgang. Diese Aktion kann nicht rückgängig gemacht werden. Erwägen Sie, den Inhalt zuerst herunterzuladen, falls Sie ihn möglicherweise erneut benötigen.