Anweisungen für Agenten

Verwenden Sie die Anweisungen des Agenten, um stets aktuelle Anweisungen zu geben, die der AWS DevOps Agent bei jeder Sitzung anwendet. Eine Sitzung ist eine einzelne Konversation oder Untersuchung mit einem Agenten. Auf der Agenten-Seite in Ihrer Agent Space Operator-Web-App können Sie globale Anweisungen festlegen, die für alle Agenten gelten, oder Anweisungen für einen bestimmten verwalteten Agenten festlegen, z. B. Chat oder Incident-Triage. Diese Anweisungen werden als AGENTS.md Datei gespeichert. Im Gegensatz zu ProgrammenDevOps Fähigkeiten der Agenten, die bei Bedarf geladen werden, wenn der Agent der aktuellen Aufgabe eine Skillbeschreibung zuordnet, sind die Anweisungen des Agenten immer von Beginn jeder Sitzung an vorhanden, unabhängig davon, woran der Agent gerade arbeitet.

Was sind Anweisungen für Agenten

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 Agent Space 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.

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

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

Anweisungen für Agenten haben kein Namens- oder Beschreibungsfeld. Die zugrunde liegende AGENTS.md Datei enthält nur Markdown ohne Frontmatter, ohne Unterstützung für ZIP-Pakete und ohne Ressourcendateien.

Warum sollten Sie Anweisungen für Agenten verwenden

Mit Anweisungen für Agenten können Sie auf zuverlässige Weise sicherstellen, dass bestimmte Anleitungen immer im richtigen Kontext stehen, ohne von den Entscheidungen des Agenten abhängig zu sein, die Fähigkeiten zu erweitern.

Die wichtigsten Vorteile:

• Vorhersehbarkeit: 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 Schutz: Im Gegensatz zu Fähigkeiten, die der Agent je nach Relevanz der Aufgabe laden kann oder auch nicht, werden die Anweisungen des Agenten immer zu Beginn jeder Sitzung eingegeben.

• Ständige Richtlinien: Verwenden Sie die Anweisungen der Agenten für dauerhafte Betriebsrichtlinien, Sicherheitsrichtlinien, Codierungsstandards oder andere Richtlinien, die ausnahmslos für jede Sitzung gelten müssen.

• Gezielter Geltungsbereich: Sie können mithilfe globaler Anweisungen Anweisungen auf alle Agententypen gleichzeitig anwenden oder Anweisungen auf einen bestimmten Agententyp beschränken, wenn die Anweisungen nur für die Arbeit dieses Agenten relevant sind.

So funktionieren Anweisungen für Agenten

Wenn eine Sitzung gestartet wird, ruft der Agentendienst die für Ihren Agent Space konfigurierten Anweisungen ab und fügt deren 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. Sitzungen, die bereits laufen, 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 in 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.

Geltungsbereich des Agententyps

Das Scoping steuert, welche Agentensitzungen einen bestimmten Befehlssatz erhalten. Es gibt zwei Optionen für die Festlegung des Geltungsbereichs:

• 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.

Folgende verwaltete Agenten stehen für agentenspezifische Anweisungen zur Verfügung:

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

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

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

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

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

Hinweise zur Größe von Inhalten

Jedes Mal, wenn Sie ein Gespräch oder eine Untersuchung beginnen, liest der Agent Ihre gesamten Anweisungen, bevor er etwas anderes tut. Der Agent verfügt über 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 vom Agenten gelesenen Protokolle und seine eigenen Überlegungen. Kürzere, zielgerichtete Anweisungen geben dem Agenten mehr Möglichkeiten, Ihr Problem zu lösen.

• Festes Limit: 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 enthalten sein müssen. Für spezielle Ermittlungsverfahren, die nur für bestimmte Aufgaben gelten, sollten Sie DevOps Fähigkeiten der Agenten stattdessen die Verwendung von.

Beispiel

Das folgende Beispiel zeigt gut formulierte Anweisungen für Agenten mit Hinweisen zur Untersuchung, Formatierungsstandards für 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 einrichten

Bevor Sie Agentenanweisungen festlegen können, benötigen Sie einen Agent Space. Weitere Informationen finden Sie unter Einen Agentenbereich erstellen.

Jeder Agent hat genau einen Befehlssatz. Wenn Sie neuen Inhalt speichern, überschreibt er den vorhandenen Inhalt für diesen Agenten.

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

1. Navigieren Sie in Ihrer Agent Space Operator-Web-App zur Seite „Agenten“.

2. Wählen Sie neben „Allgemeine Anweisungen“ die Option „Anzeigen“.

3. Geben Sie Ihre Markdown-Anweisungen im Editor ein.

4. Wählen Sie Speichern.

So legen Sie Anweisungen für einen bestimmten Agenten fest:

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

2. Wählen Sie unter Verwaltete Agenten neben dem Agenten, den Sie konfigurieren möchten, die Option Ansicht aus: Chat, Incident Triage, Incident RCA, Incident Mitigation oder Evaluation.

3. Geben Sie Ihre Markdown-Anweisungen im Editor ein.

4. Wählen Sie Speichern.

Anweisungen für Agenten verwalten

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

Anweisungen anzeigen: Navigieren Sie zur Seite „Agenten“ und wählen Sie neben „Allgemeine Anweisungen“ oder dem jeweiligen verwalteten Agenten die Option „Anzeigen“. Der Editor zeigt den aktuellen Inhalt an. Verwenden Sie die Registerkarte Vorschau, um den gerenderten Markdown zu sehen, oder die Registerkarte Code, um den unformatierten Markdown zu sehen.

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 wählen Sie dann im Editor die Schaltfläche Hochladen, um eine Markdown-Datei von Ihrem Computer hochzuladen.

Anweisungen zum Herunterladen: Öffnen Sie den Agenten und wählen Sie dann im Editor 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 erneut benötigen.