Verwalten benutzerdefinierter Agenten - Amazon Q Developer
Speicherorte von benutzerdefinierten AgentendateienBewährte Methoden für die Organisation benutzerdefinierter AgentenGemeinsame Nutzung benutzerdefinierter Agenten in Teams

Verwalten benutzerdefinierter Agenten

In diesem Abschnitt erfahren Sie, wie Sie benutzerdefinierte Agenten in Ihrem Entwicklungsworkflow effektiv organisieren, verwalten und verwenden können.

Speicherorte von benutzerdefinierten Agentendateien

Benutzerdefinierte Agentenkonfigurationsdateien werden als JSON-Dateien in bestimmten Verzeichnissen gespeichert:

Globale benutzerdefinierte Agenten

~/.aws/amazonq/cli-agents/{agent-name}.json

Diese sind für alle Projekte und Verzeichnisse in Ihrem System verfügbar.

Benutzerdefinierte Agenten auf Projektebene

.amazonq/cli-agents/{agent-name}.json

Diese sind nur innerhalb des jeweiligen Projektverzeichnisses und seiner Unterverzeichnisse verfügbar.

Wichtig: Der Name {agent-name} im Dateinamen dient nur als Referenz. Der tatsächliche Agentenname wird durch das Feld name in der JSON-Konfigurationsdatei selbst bestimmt, das erforderlich ist.

Priorität und Konfliktlösung für benutzerdefinierte Agenten

Wenn die CLI von Amazon Q Developer nach einem benutzerdefinierten Agenten sucht, wird eine bestimmte Rangfolge eingehalten:

  1. Zuerst lokale benutzerdefinierte Agenten – sucht nach benutzerdefinierten Agenten im aktuellen Arbeitsverzeichnis

  2. Zweitens globale benutzerdefinierte Agenten – geht auf benutzerdefinierte Agenten in Ihrem Stammverzeichnis zurück

  3. Integrierter Standard – verwendet den Standardagenten, wenn kein benutzerdefinierter Agent gefunden wird

Wenn sowohl lokale als auch globale Verzeichnisse benutzerdefinierte Agenten mit demselben Namen enthalten, hat der lokale benutzerdefinierte Agent Vorrang. Die CLI von Amazon Q Developer zeigt in diesem Fall eine Warnmeldung an:

WARNING: Agent conflict for my-agent. Using workspace version.

Dieses Prioritätssystem ermöglicht Ihnen Folgendes:

  • Überschreiben globaler benutzerdefinierter Agenten mit projektspezifischen Versionen

  • Lokales Testen von Änderungen an benutzerdefinierten Agenten, bevor sie global eingestellt werden

  • Pflegen unterschiedlicher benutzerdefinierter Agentenkonfigurationen für verschiedene Projekte

Bewährte Methoden für die Organisation benutzerdefinierter Agenten

Wann globale benutzerdefinierte Agenten verwendet werden sollten

Verwenden Sie globale benutzerdefinierte Agenten für folgende Zwecke:

  • Workflows für allgemeine Zwecke – benutzerdefinierte Agenten, die in mehreren Projekten verwendet werden

  • Persönliche Produktivität – benutzerdefinierte Agenten, die auf Ihren individuellen Arbeitsstil zugeschnitten sind

  • Allgemeine Entwicklungsaufgaben – Codeüberprüfung, Debugging, Generierung von Dokumentation

  • Toolspezifische Workflows – AWS-Management, Git-Operationen, Docker-Workflows

Wann lokale benutzerdefinierte Agenten verwendet werden sollten

Verwenden Sie lokale benutzerdefinierte Agenten für folgende Zwecke:

  • Projektspezifische Konfigurationen – benutzerdefinierte Agenten, die Zugriff auf bestimmte Projektdateien benötigen

  • Zusammenarbeit im Team – benutzerdefinierte Agenten, die über die Versionskontrolle gemeinsam genutzt werden

  • Entwicklungsumgebungen – benutzerdefinierte Agenten mit speziellen Anforderungen für bestimmte Projekte

  • Tests und Experimente – temporäre Änderungen an benutzerdefinierten Agenten, ohne die globalen Einstellungen zu beeinflussen

Namenskonventionen für benutzerdefinierte Agenten

Beachten Sie die folgenden Namenskonventionen für eine bessere Organisation benutzerdefinierter Agenten:

  • Zweckmäßige Namen – aws-specialist.json, code-reviewer.json, documentation-writer.json

  • Technologiespezifische Namen – python-dev.json, react-frontend.json, terraform-ops.json

  • Projektspezifische Namen – project-alpha.json, mobile-app.json, api-backend.json

  • Umgebungsspezifische Namen – development.json, staging.json, production.json

Gemeinsame Nutzung benutzerdefinierter Agenten in Teams

Lokale benutzerdefinierte Agenten können über Versionskontrollsysteme für Teammitglieder freigegeben werden. Dieser Ansatz bietet Teams folgende Möglichkeiten:

  • Standardisieren von Entwicklungsumgebungen – sicherstellen, dass alle Teammitglieder Zugriff auf dieselben Tools und Konfigurationen haben

  • Teilen von projektspezifischem Kontext – Projektdokumentation, Codierungsstandards und benutzerdefinierte Skripts hinzufügen

  • Wahren von Konsistenz – im gesamten Team dieselben Toolberechtigungen und Einstellungen verwenden

  • Gemeinsames Arbeiten an Verbesserungen – Pull-Anforderungen verwenden, um benutzerdefinierte Agentenkonfigurationen zu überprüfen und zu verbessern

Bewährte Methoden für die Versionskontrolle.

Wenn Sie benutzerdefinierte Agenten über die Versionskontrolle gemeinsam nutzen:

  • Einbeziehen von benutzerdefinierte Agentenverzeichnissen – .aws/amazonq/agents/ Ihrem Repository hinzufügen

  • Dokumentieren der Zwecke benutzerdefinierter Agenten – klare Beschreibungen in den Konfigurationsdateien für benutzerdefinierte Agenten verwenden

  • Überprüfen von Änderungen an benutzerdefinierten Agenten – Änderungen an der benutzerdefinierten Agentenkonfiguration wie Codeänderungen behandeln

  • Testen von benutzerdefinierten Agentenkonfigurationen – sicherstellen, dass gemeinsam genutzte benutzerdefinierte Agenten für alle Teammitglieder ordnungsgemäß funktionieren

  • Vermeiden vertraulicher Informationen – für gemeinsam genutzte benutzerdefinierte Agenten keine API-Schlüssel, Passwörter oder persönlichen Informationen angeben