View a markdown version of this page

Einen benutzerdefinierten Agenten erstellen - 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.

Einen benutzerdefinierten Agenten erstellen

Sie können einen benutzerdefinierten Agenten auf zwei Arten erstellen: mithilfe des Formulars in der DevOps Agent-Web-App oder mithilfe einer geführten Konversation im Chat. Beide Methoden führen zu derselben benutzerdefinierten Agentenkonfiguration, die in Ihrem Agent Space gespeichert ist.

Bevor Sie einen benutzerdefinierten Agenten erstellen können, benötigen Sie einen Agent Space mit mindestens einer verbundenen Integration. Weitere Informationen finden Sie unter Einen Agentenbereich erstellen.

Einen benutzerdefinierten Agenten mithilfe des Formulars erstellen

Mit dem Formular können Sie schnell einen benutzerdefinierten Agenten erstellen, indem Sie einen Namen, eine Systemaufforderung und optionale Fähigkeiten angeben. Um dem Agenten MCP-Tools zuzuweisen, verwenden Sie Chat, nachdem Sie den Agenten erstellt haben.

Um einen benutzerdefinierten Agenten mithilfe des Formulars zu erstellen:

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

  2. Wählen Sie im Abschnitt Benutzerdefinierte Agenten die Option Create Agent aus.

  3. Wählen Sie im Dialogfeld Formular aus.

  4. Füllen Sie das Formular aus:

    • Name — Eine eindeutige Kennung für Ihren Agenten. Verwenden Sie nur Kleinbuchstaben, Zahlen und Bindestriche (maximal 64 Zeichen). Darf nicht mit einem Bindestrich beginnen oder enden. Beispiel: weekly-health-report

    • Systemaufforderung — In Markdown geschriebene Anweisungen, die definieren, was der Agent tut und wie er arbeitet (mindestens 10 Zeichen, maximal 50.000 Zeichen). Anleitungen zum Schreiben effektiver Eingabeaufforderungen finden Sie unter Eine Systemaufforderung schreiben.

    • Fähigkeiten (optional) — Wählen Sie Fähigkeiten aus Ihrem Agentenbereich aus, die dem Agenten zusätzliche Fachkenntnisse oder Fähigkeiten vermitteln. Verwenden Sie das Suchfeld, um Fähigkeiten anhand des Namens zu finden.

  5. Wählen Sie Create agent (Agent erstellen) aus.

Nach der Erstellung werden Sie zur Detailseite des Agenten weitergeleitet, auf der Sie die Konfiguration anzeigen, den Agenten ausführen oder Trigger einrichten können.

Einen benutzerdefinierten Agenten mithilfe von Chat erstellen

Chat bietet eine geführte Konversationserfahrung für die Erstellung benutzerdefinierter Agenten. Diese Methode wird empfohlen, wenn Sie dem Agenten MCP-Tools zuweisen möchten oder wenn Sie Unterstützung beim Schreiben der Systemaufforderung benötigen.

So erstellen Sie einen benutzerdefinierten Agenten mithilfe von Chat:

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

  2. Wählen Sie im Abschnitt Benutzerdefinierte Agenten die Option Create Agent aus.

  3. Wählen Sie im Dialogfeld Chat aus. Das Dialogfeld wird geschlossen und im Chat-Bereich wird eine neue Konversation mit einer vorverfassten Nachricht geöffnet.

  4. Der Chat führt Sie durch einen kollaborativen Prozess:

    • Klärung der Absicht — Bestätigt den Zweck und den Umfang Ihres Agenten.

    • Doppelte Prüfung — Stellt sicher, dass in Ihrem Agentenbereich noch kein ähnlicher Agent vorhanden ist.

    • Auswahl von Tools und Fähigkeiten — Schlägt vor, welche MCP-Tools und Fähigkeiten der Agent benötigt, und fordert Sie zur Bestätigung auf.

    • Ausgabetyp — Legt fest, ob der Agent Textantworten, Artefakte oder Empfehlungen erstellen soll.

    • Entwurf der Systemaufforderung — Schreibt eine Systemaufforderung und legt sie Ihnen zur Überprüfung vor. Sie können so lange wiederholen, bis Sie zufrieden sind.

    • Bestätigung — Schlägt einen Namen vor und bestätigt alle Einstellungen, bevor der Agent erstellt wird.

Sie können auch jederzeit einen benutzerdefinierten Agenten erstellen, indem Sie Chat direkt fragen. Beispiel:

Create an agent that generates a weekly report of all investigations from the past week.
Create a custom agent for checking certificate expiration across all accounts.
Make me an agent that audits DynamoDB table configurations daily.

Eine Systemaufforderung schreiben

Die Systemaufforderung ist der wichtigste Teil Ihres benutzerdefinierten Agents. Sie definiert den Zweck, die Vorgehensweise, die Einschränkungen und die erwartete Leistung des Agenten. Eine gut geschriebene Aufforderung führt zu konsistenten, zuverlässigen Ergebnissen.

Strukturieren Sie Ihre Systemaufforderung in folgende Abschnitte:

  • Ziel — Was der Agent in einem einzigen Satz oder einem kurzen Absatz erreichen soll.

  • Vorgehensweise — Step-by-step Verfahren, die der Agent befolgen sollte, wobei auf bestimmte Namen der Tools verwiesen wird, die er aufrufen soll, und in welcher Reihenfolge.

  • Einschränkungen — Grenzen dessen, was der Agent tun sollte und was nicht. Zum Beispiel schreibgeschützter Zugriff, zu berücksichtigende Zeitbereiche oder auszuschließende Dienste.

  • Ausgabe — Was der Agent produzieren soll und in welchem Format. Geben Sie an, ob er Text, ein Artefakt oder eine Empfehlung generieren soll.

Beispiel für eine Systemaufforderung:

You are a DevOps reporting agent specializing in summarizing investigation activity. ## Goal Generate a concise weekly report of all investigations from the past 7 days. ## Approach 1. Call `list_investigations` to fetch investigations from the last 7 days. 2. For each investigation, retrieve its title, status, root cause, and resolution time. 3. Group investigations by status and root cause category. 4. Identify trends: services most affected, average resolution time, recurring root causes. ## Constraints - Only include investigations from the past 7 days. - Read-only access — do not modify, close, or reassign investigations. ## Output Produce a single artifact titled "Weekly Investigation Report" containing: - A table listing each investigation with title, status, and resolution time. - A chart showing investigation counts by root cause category. - A summary paragraph with key trends and recommendations.

Tipps für effektive Systemaufforderungen:

  • Gehen Sie bei den Tools genau vor — Verweisen Sie direkt auf die Namen der Tools (z. B.list_investigations,use_aws,query_cloudwatch_logs), damit der Agent weiß, welche Tools er aufrufen muss.

  • Erfolgskriterien definieren — Beschreiben Sie, wie ein gutes Ergebnis aussieht, damit der Agent weiß, wann es fertig ist.

  • Grenzen setzen — Geben Sie ausdrücklich an, was der Agent nicht tun sollte, um unbeabsichtigte Aktionen zu verhindern.

  • Verwenden Sie die Markdown-Formatierung — Überschriften, Listen und Codeblöcke erleichtern es dem Agenten, die Eingabeaufforderung zu analysieren und zu befolgen.

Tools konfigurieren

MCP-Tools bestimmen, welche Aktionen Ihr benutzerdefinierter Agent während des Aufrufs ausführen kann. Sie wählen Tools aus der gesamten Palette aus, die in Ihrem Agent Space verfügbar ist, einschließlich Tools von verbundenen AWS Konten, Observability-Plattformen, CI/CD Pipelines, Ticketsystemen und benutzerdefinierten MCP-Servern.

Tools können nur über Chat konfiguriert werden. Verwenden Sie die Methode zur Chat-Erstellung, um beim Erstellen eines Agenten Tools zuzuweisen. Um Tools für einen vorhandenen Agenten hinzuzufügen oder zu ändern, bitten Sie Chat, den Agenten zu aktualisieren. Beispiel:

Add the query_cloudwatch_logs and use_aws tools to my weekly-health-report agent.
Update certificate-checker to also use the list_resources tool.
Remove the use_kubectl tool from cluster-audit-agent.

Beachten Sie bei der Auswahl der Tools das Prinzip der geringsten Rechte — weisen Sie dem Agenten nur die Tools zu, die er zur Ausführung seiner Aufgabe benötigt. Dadurch wird das Risiko unbeabsichtigter Aktionen reduziert und der Agent kann sich darauf konzentrieren.

Fähigkeiten konfigurieren

Fähigkeiten bieten Ihrem individuellen Agenten zusätzliche Fachkenntnisse, Ermittlungsverfahren oder spezielle Fähigkeiten. Wenn ein benutzerdefinierter Agent ausgeführt wird, lädt er die ihm zugewiesenen Fähigkeiten und kann beim Aufruf auf deren Anweisungen verweisen.

Sie können Fertigkeiten während der Erstellung zuweisen (entweder über das Formular oder den Chat) oder sie später hinzufügen, indem Sie den Agenten bearbeiten. Fähigkeiten, die einem benutzerdefinierten Agenten zugewiesen wurden, müssen bereits in Ihrem Agentenbereich vorhanden sein. Weitere Informationen zum Erstellen von Skills finden Sie unterDevOps Fähigkeiten der Agenten.

Benutzerdefinierte Agenten verfügen auch über integrierte Funktionen zum Erstellen von Artefakten und Empfehlungen, für die keine Zuweisung von Fähigkeiten erforderlich ist. Weitere Informationen finden Sie unter Benutzerdefinierte Agentenausgaben.

Sie können jedem benutzerdefinierten Agenten bis zu 200 Fähigkeiten zuweisen. Wählen Sie Fähigkeiten aus, die für den Zweck des Agenten relevant sind, um den Kontextverbrauch zu reduzieren und den Fokus der Agenten zu verbessern.