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 Agenten-Web-App oder durch eine geführte Konversation im Chat. Beide Methoden führen zu derselben benutzerdefinierten Agentenkonfiguration, die in Ihrem Agentenbereich gespeichert ist. Bevor Sie einen benutzerdefinierten Agenten erstellen, benötigen Sie einen Agentenbereich mit mindestens einer verbundenen Integration. Weitere Informationen finden Sie unter [Einen Agentenbereich erstellen](getting-started-with-aws-devops-agent-creating-an-agent-space.md). ## 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. **So erstellen Sie einen benutzerdefinierten Agenten mithilfe des Formulars: ** 1. Navigieren Sie in Ihrer DevOps Agenten-Web-App zur ** Agenten-Seite. ** 1. Wählen Sie im ** Abschnitt ** Benutzerdefinierte Agenten die Option Agent ** erstellen aus**. 1. Wählen Sie im Dialogfeld ** Formular aus**. 1. 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). Eine Anleitung zum Schreiben effektiver Eingabeaufforderungen finden Sie unter Eine Systemaufforderung [ schreiben. ](#writing-a-system-prompt) + **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. 1. Wählen Sie **Create agent (Agent erstellen)** aus. Nach der Erstellung werden Sie zur Detailseite des Agenten weitergeleitet, auf der Sie die Konfiguration einsehen, 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. ** 1. Wählen Sie im ** Abschnitt ** Benutzerdefinierte Agenten die Option Agent ** erstellen aus**. 1. Wählen Sie im Dialogfeld ** Chat aus**. Das Dialogfeld wird geschlossen und im Chat-Bereich wird eine neue Konversation mit einer vorab verfassten Nachricht geöffnet. 1. Der Chat führt Sie durch einen kollaborativen Prozess: + **Klärung der Absicht ** — Bestätigt den Zweck und den Umfang Ihres Agenten. + **Doppelte Überprüfung ** — Stellt sicher, dass es in Ihrem Agentenbereich noch keinen ähnlichen Agenten gibt. + **Auswahl von Tools und Fähigkeiten ** — Schlägt vor, welche MCP-Tools und Fähigkeiten der Agent benötigt, und bittet Sie, dies zu bestätigen. + **Ausgabetyp ** — Legt fest, ob der Agent Textantworten, Artefakte oder Empfehlungen erstellen soll. + **Entwurf einer Systemaufforderung ** — Verfasst 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 einen benutzerdefinierten Agenten erstellen, indem Sie Chat jederzeit 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. ``` ## Einen benutzerdefinierten Agenten aus einem Repository importieren Sie können die Systemaufforderung eines benutzerdefinierten Agenten direkt aus einer Markdown-Datei in einem GitHub Repository importieren. Der Dateiinhalt wird zur Systemaufforderung des Agenten. Sie können die Eingabeaufforderungen des Agenten in der Versionskontrolle verwalten und sie mit einer einzigen Aktion importieren. **Voraussetzungen:** + Ein GitHub Konto, das Ihrem Agent Space zugeordnet ist. Informationen zum Verbinden eines GitHub Kontos finden Sie unter[Verbindung herstellen GitHub](connecting-to-cicd-pipelines-connecting-github.md). Jede GitHub Kontoverbindung ermöglicht den Import aus öffentlichen Repositorys. Bei privaten Repositorys muss das zugehörige Konto Lesezugriff auf das Repository haben. GitHub Enterprise Server und GitHub Enterprise Cloud mit Verbindungen zur Datenresidenz werden ebenfalls unterstützt. + Eine Markdown-Datei (`.md`) in einem GitHub Repository, die die Systemaufforderung enthält. **Um einen benutzerdefinierten Agenten aus einem Repository zu importieren: ** 1. Navigieren Sie in Ihrer DevOps Agenten-Web-App zur ** Agenten-Seite. ** 1. Wählen Sie im ** Abschnitt ** Benutzerdefinierte Agenten die Option Agent ** erstellen aus**. 1. Wählen Sie im Dialogfeld ** Importieren aus**. Das Dialogfeld wechselt zur GitHub ** Ansicht Aus ** importieren. 1. 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. + **Repository-URL ** — Ein Link zu einer einzelnen Markdown (`.md`) -Datei, die die Systemaufforderung des Agenten enthält. Beispiel: `https://github.com/my-org/my-repo/blob/main/my-agent.md`. Verwenden Sie für GitHub Enterprise Server oder GitHub Enterprise Cloud mit Datenresidenz stattdessen Ihre Instanz-URL. Beispiel: `https://github.example.com/my-org/my-repo/blob/main/my-agent.md`. Wenn die URL nicht mit endet`.md`, wird eine Warnung angezeigt. Der Import schlägt fehl, wenn es sich bei der Datei nicht um Markdown handelt. + **Fähigkeiten ** (optional) — Wählen Sie Fähigkeiten aus Ihrem Agentenbereich aus, um dem Agenten zusätzliche Fachkenntnisse oder Fähigkeiten zu vermitteln. 1. Wählen Sie Agent ** importieren aus**. Die Repository-Datei liefert nur die Systemaufforderung. Der Name und die Fähigkeiten stammen aus dem Formular. Nach der Erstellung werden Sie zur Detailseite des Agenten weitergeleitet, auf der Sie die Konfiguration einsehen, den Agenten ausführen oder Trigger einrichten können. **Importierte Agenten anzeigen: ** Ein importierter Agent zeigt auf der GitHub ** Agentendetailseite neben seinem Namen das Symbol „**Synchronisiert von“ an, zusammen mit einem ** Zeitstempel der ** letzten Synchronisierung und einem Link zur Quelldatei. GitHub In der ** Liste der ** benutzerdefinierten Agenten enthalten importierte Agenten einen Link zu ihrer Quelldatei. Wenn Sie einen importierten Agenten bearbeiten, zeigt die Systemaufforderung eine ** Read-only ** Bezeichnung mit einem Hinweis an, der auf die Quelldatei verweist. Der Name und die Fähigkeiten können weiterhin bearbeitet werden. **Importierte Agenten synchronisieren: ** Wenn Sie die Markdown-Datei in Ihrem Repository aktualisieren, öffnen Sie die Detailseite des importierten Agenten und wählen Sie ** Synchronisieren, ** um die neueste Systemaufforderung abzurufen. **Hinweis: Bei der ** Synchronisierung wird die Systemaufforderung vollständig durch den aktuellen Inhalt der Quelldatei ersetzt. Um die Systemaufforderung eines importierten Agenten zu ändern, bearbeiten Sie die Quelldatei in Ihrem Repository und synchronisieren Sie sie. **Einschränkungen**: + **URL-Format ** — Es werden nur GitHub URLs akzeptiert, einschließlich GitHub Enterprise Server und GitHub Enterprise Cloud mit Datenresidenz. Das verbundene GitHub Konto muss mit dem URL-Host übereinstimmen. Beispielsweise kann eine `github.example.com` Verbindung nur von `github.example.com` URLs importiert werden, nicht von `github.com` URLs. + **Markdown-Datei erforderlich ** — Die URL muss auf eine einzelne `.md` Datei verweisen. + **Maximale Dateigröße ** — Die Datei darf 1 MB nicht überschreiten (GitHub API-Limit). + **GitHub Konto erforderlich ** — Ihr Agent Space muss über ein zugeordnetes GitHub Konto verfügen, um Agenten importieren zu können. Für private Repositorys muss das Konto Lesezugriff haben. ## Zollagenten der Gemeinschaft Das [AWS DevOps Agent Tools-Repository ](https://github.com/aws/tools-for-devops-agent) enthält vorgefertigte benutzerdefinierte Agentenkonfigurationen für wiederkehrende Betriebsaufgaben wie Statusberichte, Betriebsüberprüfungen und die Überwachung der Servicequoten. Das Repository wird vom AWS DevOps Agent-Serviceteam verwaltet, und alle Beiträge durchlaufen dieselbe Sicherheitsüberprüfungsleiste, bevor sie hinzugefügt werden. Informationen zum Angebot finden Sie im Katalog für [ benutzerdefinierte Agenten ](https://aws.github.io/tools-for-devops-agent/custom-agents/) auf der GitHub Website. Um einen benutzerdefinierten Community-Agenten zu verwenden, importieren Sie ihn mithilfe des ** Ablaufs Aus dem Repository ** importieren auf der ** Seite ** Agenten aus dem Repository. Kopieren Sie die URL der Markdown-Datei des Agenten und fügen Sie sie als Repository-URL ein. Einzelheiten finden Sie unter [ Einen benutzerdefinierten Agenten aus einem Repository ](#importing-a-custom-agent-from-a-repository) importieren. ## Eine Systemaufforderung schreiben Die Systemaufforderung ist der wichtigste Teil Ihres Custom 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 mit diesen Abschnitten: ** + **Ziel ** — Was der Agent in einem einzigen Satz oder kurzen Absatz erreichen sollte. + **Vorgehensweise ** — Step-by-step Verfahren, die der Agent befolgen sollte, wobei auf bestimmte Toolnamen verwiesen wird, die er aufrufen sollte, und in welcher Reihenfolge. + **Einschränkungen ** — Grenzen dessen, was der Agent tun sollte und was nicht. Zum Beispiel schreibgeschützter Zugriff, zu berücksichtigende Zeiträume oder auszuschließende Dienste. + **Ausgabe ** — Was der Agent produzieren soll und in welchem Format. Geben Sie an, ob Text generiert, ein Artefakt erstellt oder eine Empfehlung erstellt werden 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: ** + **Seien Sie spezifisch in Bezug auf Tools ** — Verweisen Sie direkt auf Toolnamen (z. B.`list_investigations`,`use_aws`,`query_cloudwatch_logs`), damit der Agent weiß, welche Tools er aufrufen muss. + **Definieren Sie Erfolgskriterien ** — Beschreiben Sie, wie ein guter Output aussieht, damit der Agent weiß, wann er fertig ist. + **Grenzen setzen ** — Geben Sie explizit an, was der Agent nicht tun sollte, um unbeabsichtigte Aktionen zu verhindern. + **Verwenden Sie die Markdown-Formatierung ** — Header, Listen und Codeblöcke erleichtern es dem Agenten, die Aufforderung zu analysieren und ihnen zu folgen. ## 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 für verbundene AWS Konten, Observability-Plattformen, CI/CD Pipelines, Ticketing-Systeme und benutzerdefinierte MCP-Server. Tools können nur über Chat konfiguriert werden. Um beim Erstellen eines Agenten Tools zuzuweisen, verwenden Sie die Chat-Erstellungsmethode. 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. ``` Folgen Sie bei der Auswahl der Tools dem Prinzip der geringsten Zugriffsrechte — weisen Sie dem Agenten nur die Tools zu, die er zur Erfüllung seiner Aufgabe benötigt. Dadurch wird das Risiko unbeabsichtigter Aktionen reduziert und der Agent kann sich voll und ganz darauf konzentrieren. ## Tools für den Release Manager Benutzerdefinierte Agenten haben Zugriff auf die Release Manager-Tools. Mit diesen Tools kann Ihr Agent Release Manager-Aufgaben erstellen, auflisten, abrufen und stornieren. Ihr Agent kann auch einen Bericht zur Überprüfung der Veröffentlichungsbereitschaft analysieren, um die Ergebnisse und Handlungsempfehlungen zu ermitteln. Um die Release Manager-Tools zu verwenden, weisen Sie sie Ihrem individuellen Agenten über Chat zu. Beispiel: ``` Add the release manager tools to my release-pipeline-agent. ``` Weitere Informationen zu den Funktionen des Release-Managements finden Sie unter[Verwaltung von Veröffentlichungen](working-with-devops-agent-release-management-index.md). ## Fähigkeiten konfigurieren Fähigkeiten bieten Ihrem maßgeschneiderten 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 während des Aufrufs auf deren Anweisungen zurückgreifen. Sie können Fähigkeiten 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 Fähigkeiten finden Sie unter[DevOps Fähigkeiten von Agenten](about-aws-devops-agent-devops-agent-skills.md). Benutzerdefinierte Agenten verfügen außerdem über integrierte Funktionen zum Erstellen von Artefakten und Empfehlungen, für die keine Fertigkeiten zugewiesen werden müssen. Weitere Informationen finden Sie unter [Benutzerdefinierte Agentenausgaben](custom-agents-custom-agent-outputs.md). 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 die Konzentration der Agenten zu verbessern.