Eingabeaufforderungen verwalten - Amazon Q Developer

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.

Eingabeaufforderungen verwalten

Die Amazon Q Developer CLI bietet umfassende Funktionen zur Verwaltung von Eingabeaufforderungen sowohl für lokale Eingabeaufforderungen als auch für Model Context Protocol (MCP) -Eingabeaufforderungen. Dieses System ermöglicht es Ihnen, wiederverwendbare Eingabeaufforderungen in Ihrem gesamten Entwicklungsablauf zu erstellen, zu bearbeiten, zu organisieren und zu verwenden.

Über Aufforderungstypen

Das Eingabeaufforderungssystem unterstützt drei Arten von Eingabeaufforderungen:

  • Lokale Eingabeaufforderungen: Projektspezifische Eingabeaufforderungen, die in Ihrem Workspace gespeichert sind

  • Globale Eingabeaufforderungen: Benutzerübergreifende Eingabeaufforderungen sind für alle Projekte verfügbar

  • MCP-Eingabeaufforderungen: Eingabeaufforderungen, die von MCP-Servern mit erweiterter Funktionalität bereitgestellt werden

Befehle

Der Zugriff auf die gesamte Eingabeaufforderungsverwaltung erfolgt über den /prompts Befehl mit verschiedenen Unterbefehlen.

Aufforderungen auflisten

/prompts list

Zeigt alle verfügbaren Eingabeaufforderungen in einem dreispaltigen Layout mit Namen, Beschreibungen und Quellen an. Zeigt die Anzahl der Eingabeaufforderungen an und gibt an, welche Eingabeaufforderungen von lokalem Speicher, globalem Speicher oder MCP-Servern stammen.

Erstellen von Ansagen

/prompts create --name name [--content content]

Erstellt eine neue lokale Eingabeaufforderung im aktuellen Arbeitsbereich.

Parameter
name (Erforderlich)

Name der Aufforderung (maximal 50 Zeichen)

--content content (optional)

Direkte Inhaltsspezifikation

Verhalten:

  • Wenn angegeben, --content wird eine Eingabeaufforderung mit dem angegebenen Inhalt erstellt

  • Wenn kein Inhalt bereitgestellt wird, wird Ihr Standardeditor für die Inhaltserstellung geöffnet

  • Eingabeaufforderungen werden .amazonq/prompts/ im aktuellen Workspace gespeichert

Eingabeaufforderungen bearbeiten

/prompts edit name

Öffnet eine bestehende Eingabeaufforderung in Ihrem Standardeditor zur Änderung.

Unterstützte Eingabeaufforderungen:

  • Lokale Workspace-Eingabeaufforderungen

  • Globale Benutzeraufforderungen

  • MCP-Eingabeaufforderungen (sofern vom Server unterstützt)

Details zur Aufforderung anzeigen

/prompts details name

Zeigt umfassende Informationen zu einer Aufforderung an, darunter:

  • Metadaten und Argumentdetails

  • Vollständiger Inhalt der Eingabeaufforderung vor der KI-Verarbeitung

  • Parameteranforderungen und Beispiele

  • Quellinformationen (lokaler, globaler oder MCP-Server)

Eingabeaufforderungen verwenden

Sobald Sie Eingabeaufforderungen erstellt haben, rufen Sie sie im Chat mit dem Präfix @ auf:

@prompt-name

Beispiele

@code-review
# Uses your local code-review prompt
@team-standup
# Uses your team-standup prompt

Übergabe von Argumenten an MCP-Eingabeaufforderungen

MCP-Serveransagen können Argumente akzeptieren, um ihr Verhalten anzupassen. Dateibasierte Eingabeaufforderungen (lokal und global) unterstützen keine Argumente.

Syntax der MCP-Prompt-Argumente

@server-name/prompt-name <required-arg> [optional-arg]

Wird verwendet/prompts details prompt-name, um herauszufinden, welche Argumente eine MCP-Eingabeaufforderung akzeptiert.

# Example: Using MCP prompt with arguments
@dev-tools/analyze "performance issue" "detailed"
@security-tools/scan "web-app" "high-severity"

Speicherorte

Lokale Eingabeaufforderungen (arbeitsbereichsspezifisch)

  • Standort: project/.amazonq/prompts/

  • Umfang: Nur innerhalb des aktuellen Projekts verfügbar

  • Priorität: Höchste Priorität (überschreibt globale und MCP-Eingabeaufforderungen mit demselben Namen)

Globale Eingabeaufforderungen (benutzerweit)

  • Standort: ~/.aws/amazonq/prompts/

  • Umfang: Für alle Projekte verfügbar

  • Priorität: Mittel (überschreibt MCP-Eingabeaufforderungen mit demselben Namen)

MCP-Eingabeaufforderungen

  • Quelle: Wird von konfigurierten MCP-Servern bereitgestellt

  • Umfang: Hängt von der Serverkonfiguration ab

  • Priorität: Niedrigste Priorität (wird durch lokale und globale Eingabeaufforderungen außer Kraft gesetzt)

Prioritätssystem

Wenn mehrere Eingabeaufforderungen denselben Namen haben, verwendet das System diese Prioritätsreihenfolge:

  1. Lokale Eingabeaufforderungen (höchste Priorität)

  2. Globale Eingabeaufforderungen

  3. MCP-Eingabeaufforderungen (niedrigste Priorität)

Auf diese Weise können Sie MCP- oder globale Eingabeaufforderungen bei Bedarf durch projektspezifische Versionen überschreiben.

Verbesserte Funktionen

Inhaltsvorschau

Das System zeigt den vollständigen Inhalt der Aufforderung an, bevor er an das KI-Modell gesendet wird, wodurch Unklarheiten darüber vermieden werden, welche Informationen tatsächlich verarbeitet wurden.

Verbesserte Fehlerbehandlung

  • MCP-Serverfehler werden in benutzerfreundliche Nachrichten umgewandelt

  • Hilfreiche Anwendungsbeispiele werden anhand von Eingabeaufforderungsmetadaten generiert

  • Klare Hinweise für ungültige Parameter oder fehlende Anforderungen

Visuelle Formatierung

  • Konsistentes Terminaldesign für alle Eingabeaufforderungen

  • Richtige Inhaltsanzeige für alle Arten von Eingabeaufforderungsnachrichten

  • Dreispaltiges Layout für bessere Lesbarkeit in Auflistungen

MCP-Integration

Das Prompt-System lässt sich nahtlos in MCP-Server integrieren:

  • Automatische Erkennung: MCP-Eingabeaufforderungen werden automatisch von konfigurierten Servern erkannt

  • Verbesserte Benutzererfahrung: Verbesserte Benutzererfahrung für die MCP-Eingabeaufforderungsverwaltung

  • Fehlerübersetzung: Unformatierte JSON-Fehler werden in umsetzbare Nachrichten umgewandelt

  • Inhaltsvorschau: Vollständige Inhaltsvorschau für MCP-Eingabeaufforderungen vor der Ausführung

Beispiele

Diese Beispiele veranschaulichen die dateibasierte Erstellung von Eingabeaufforderungen und die Verwendung von MCP-Eingabeaufforderungen.

Grundlegende Erstellung und Verwendung von dateibasierten Eingabeaufforderungen

# Create a simple prompt without arguments
/prompts create --name code-review --content "Please review this code for best practices, security issues, and potential improvements:"

# Use the prompt (no arguments supported for file-based prompts)
@code-review

Verwendung der MCP-Eingabeaufforderung mit Argumenten

# Using MCP prompts with arguments
@dev-tools/analyze "performance bottleneck" "cpu usage"
@security-tools/scan "web-app" "high-severity"
@aws-tools/deploy "my-service" "production" "us-west-2"