Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.
Administrar las indicaciones
La CLI para desarrolladores de Amazon Q proporciona capacidades integrales de administración de solicitudes tanto para las solicitudes locales como para las solicitudes del Model Context Protocol (MCP). Este sistema le permite crear, editar, organizar y utilizar mensajes reutilizables en todo su flujo de trabajo de desarrollo.
Acerca de los tipos de solicitudes
El sistema de solicitudes admite tres tipos de solicitudes:
Mensajes locales: mensajes específicos del proyecto almacenados en su espacio de trabajo
Mensajes globales: los mensajes para todos los usuarios están disponibles en todos los proyectos
Mensajes MCP: mensajes proporcionados por los servidores MCP con una funcionalidad mejorada
Comandos
Se accede a toda la administración de solicitudes mediante el /prompts comando con varios subcomandos.
Enumere las solicitudes
/prompts list
Muestra todas las solicitudes disponibles en un diseño de tres columnas con nombres, descripciones y fuentes. Muestra el número de solicitudes e indica qué solicitudes provienen del almacenamiento local, el almacenamiento global o los servidores MCP.
Crear avisos
/prompts create --namename[--contentcontent]
Crea un nuevo mensaje local en el espacio de trabajo actual.
Parámetros
name-
Nombre del mensaje (máximo 50 caracteres)
--content(opcional)content-
Especificación de contenido directa
Comportamiento:
Si
--contentse proporciona, crea un mensaje con el contenido especificadoSi no se proporciona ningún contenido, abre el editor predeterminado para la creación de contenido
Las solicitudes se guardan
.amazonq/prompts/en el espacio de trabajo actual
Edite las solicitudes
/prompts edit name
Abre una solicitud existente en el editor predeterminado para modificarla.
Indicaciones compatibles:
Indicaciones en el espacio de trabajo local
Indicaciones globales para el usuario
Indicaciones MCP (cuando el servidor las admita)
Vea los detalles del mensaje
/prompts details name
Muestra información completa sobre un mensaje, que incluye:
Detalles de los metadatos y los argumentos
Complete el contenido del mensaje antes del procesamiento por IA
Requisitos y ejemplos de parámetros
Información de origen (servidor local, global o MCP)
Uso de indicaciones
Una vez que hayas creado los mensajes, invócalos en el chat con el prefijo @:
@prompt-name
Ejemplos
@code-review # Uses your local code-review prompt
@team-standup # Uses your team-standup prompt
Pasar argumentos a las solicitudes de MCP
Las solicitudes del servidor MCP pueden aceptar argumentos para personalizar su comportamiento. Las solicitudes basadas en archivos (locales y globales) no admiten argumentos.
Sintaxis de argumentos de solicitud MCP
@server-name/prompt-name<required-arg> [optional-arg]
Se usa /prompts details para descubrir qué argumentos acepta una línea de comandos MCP.prompt-name
# Example: Using MCP prompt with arguments @dev-tools/analyze "performance issue" "detailed" @security-tools/scan "web-app" "high-severity"
Ubicaciones de almacenamiento
Indicaciones locales (específicas del espacio de trabajo)
Ubicación:
project/.amazonq/prompts/Alcance: disponible solo en el proyecto actual
Prioridad: la más alta (anula las solicitudes globales y de MCP con el mismo nombre)
Indicaciones globales (para todo el usuario)
Ubicación:
~/.aws/amazonq/prompts/Alcance: disponible en todos los proyectos
Prioridad: media (anula las solicitudes de MCP con el mismo nombre)
Indicaciones de MCP
Fuente: proporcionada por servidores MCP configurados
Alcance: depende de la configuración del servidor
Prioridad: la más baja (anulada por las solicitudes locales y globales)
Sistema de prioridad
Cuando varias solicitudes tienen el mismo nombre, el sistema utiliza este orden de prioridad:
Mensajes locales (prioridad más alta)
Indicaciones globales
Mensajes MCP (prioridad más baja)
Esto le permite anular las solicitudes MCP o globales con versiones específicas del proyecto cuando sea necesario.
Funciones mejoradas
Vista previa del contenido
El sistema muestra el contenido completo del mensaje antes de enviarlo al modelo de IA, lo que elimina la confusión sobre qué información se procesó realmente.
Gestión de errores mejorada
Los errores del servidor MCP se convierten en mensajes fáciles de usar
Se generan ejemplos de uso útiles a partir de metadatos rápidos
Una guía clara sobre los parámetros no válidos o los requisitos incumplidos
Formato visual
Estilo de terminal uniforme en todas las operaciones rápidas
Visualización adecuada del contenido para todos los tipos de mensajes rápidos
Diseño de tres columnas para mejorar la legibilidad de los anuncios
Integración de MCP
El sistema Prompt se integra perfectamente con los servidores MCP:
Detección automática: las solicitudes MCP se detectan automáticamente desde los servidores configurados
Experiencia de usuario mejorada: experiencia de usuario mejorada para la gestión rápida de MCP
Traducción de errores: los errores JSON sin procesar se convierten en mensajes procesables
Vista previa del contenido: vista previa completa del contenido para las solicitudes de MCP antes de la ejecución
Ejemplos
Estos ejemplos muestran la creación de solicitudes basadas en archivos y el uso de las solicitudes MCP.
Creación y uso básicos de solicitudes basadas en archivos
# 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
Uso de mensajes MCP con argumentos
# 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"
