Création d'agents avec l'assistance de l'IA (/agent generate) - Amazon Q Developer
PrérequisUtilisationComment ça marcheEmplacements de stockageExemple de flux de travailConfiguration de l'éditeurGestion des erreursCommandes connexesBonnes pratiques

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

Création d'agents avec l'assistance de l'IA (/agent generate)

La /agent generate commande utilise l'IA pour créer intelligemment des configurations d'agents personnalisées. Il s'agit de l'approche recommandée pour créer de nouveaux agents, car elle tire parti de la compréhension qu'a Amazon Q Developer de vos besoins pour générer des configurations appropriées.

Prérequis

  • Amazon Q Developer CLI installé et configuré

  • Éditeur de texte par défaut configuré (définissez la variable d'EDITORenvironnement ou assurez-vous qu'vielle est disponible)

  • Écrire des autorisations dans le répertoire de l'espace de travail (pour les agents locaux) ou dans le répertoire personnel (pour les agents globaux)

Utilisation

/agent generate

Comment ça marche

  1. Invites interactives : après avoir exécuté la commande, Q Developer demande le nom de l'agent, sa description, son champ d'application (local/global) et la sélection du serveur MCP

  2. Génération d'IA : Q Developer analyse vos besoins et génère une configuration JSON appropriée

  3. L'éditeur s'ouvre : la configuration générée s'ouvre dans votre éditeur par défaut pour être revue et affinée

  4. Validation : Q Developer valide le schéma JSON lorsque vous enregistrez et fermez l'éditeur

  5. Création de l'agent : l'agent validé est enregistré et prêt à être utilisé

Emplacements de stockage

Agents locaux (par défaut)

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

Agents mondiaux (sélectionnés par invite)

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

Exemple de flux de travail

# Start agent generation
/agent generate

# Q Developer prompts for agent name
Enter agent name: my-dev-agent

# Q Developer prompts for description
Enter agent description: I need an agent that helps with Python development, includes linting tools, and can access my project documentation

# Q Developer prompts for scope selection
Agent scope
> Local (current workspace)
  Global (all workspaces)

# Q Developer generates configuration and opens editor
Generating agent configuration...
Opening editor for review...

# After saving and closing editor
Agent 'my-dev-agent' created successfully at .amazonq/cli-agents/my-dev-agent.json

Configuration de l'éditeur

La commande utilise l'éditeur par défaut de votre système :

  • Utilise la variable d'EDITORenvironnement si elle est définie

  • Retourne à vi si aucun éditeur n'est configuré

Gestion des erreurs

JSON non valide

La configuration est rejetée avec des messages d'erreur clairs

Pannes de l'éditeur

Manipulation élégante avec messages d'erreur informatifs

Erreurs du système de fichiers

Signalement clair des problèmes d'autorisation ou de chemin

  • /agent create- Approche de création manuelle d'agents

  • /agent list- Afficher les agents disponibles

  • /agent schema- Afficher le schéma de configuration de l'agent

Bonnes pratiques

  • Fournissez des exigences détaillées et spécifiques lorsque vous décrivez les besoins de votre agent

  • Vérifiez et personnalisez la configuration générée avant de l'enregistrer

  • Testez votre nouvel agent avec des tâches simples avant des flux de travail complexes

  • Utilisez des noms d'agents descriptifs qui reflètent leur objectif