Résolution des problèmes

Messages d’erreur mentionnant « JSON non valide » ou « erreur de syntaxe »

L’agent personnalisé n’apparaît pas dans /agent list

Retour au comportement par défaut de l’agent

Validez votre JSON à l’aide d’un validateur JSON ou d’un linter

Vérifiez les erreurs JSON courantes :

Utilisez /agent schema pour vérifier la structure de votre configuration

Avertissements concernant des champs de configuration inconnus

Le comportement de l’agent personnalisé ne correspond pas à la configuration

Erreurs liées à des champs obligatoires manquants

Comparez votre configuration au schéma en utilisant /agent schema

Vérifiez les noms des champs pour vous assurer qu’ils ne contiennent pas de fautes de frappe (par exemple, allowedTools vs allowedTool)

Vérifiez que les types de données correspondent aux exigences du schéma (tableaux vs chaînes, booléens vs chaînes)

Consultez la documentation relative au format des agents dans la documentation complémentaire de l’interface de ligne de commande d’Amazon Q Developer pour connaître la syntaxe correcte.

/agent list n’affiche pas votre agent personnalisé

/agent use [name] renvoie le message « agent introuvable »

Retour à l’agent par défaut sans avertissement

Vérifiez que le fichier de l’agent personnalisé se trouve au bon emplacement :

Vérifiez les autorisations d’accès au fichier. Assurez-vous que le fichier peut être lu

Vérifiez que le nom du fichier correspond au nom de l’agent personnalisé que vous essayez d’utiliser

Assurez-vous que le fichier possède une extension .json

Le comportement de l’agent personnalisé ne correspond pas aux récentes modifications apportées à votre configuration

Message d’avertissement de conflit entre agents personnalisés

Disponibilité ou autorisations inattendues des outils

Vérifiez les conflits de dénomination des agents personnalisés entre le répertoire local et le répertoire global

N’oubliez pas que les agents personnalisés locaux ont la priorité sur les agents personnalisés globaux

Utilisez /agent list pour voir la version en cours de chargement

Supprimez ou renommez les fichiers des agents personnalisés en conflit si nécessaire

Messages d’erreur concernant des outils inconnus ou indisponibles

L’agent personnalisé demande l’autorisation d’utiliser les outils dans allowedTools

Les outils du serveur MCP ne fonctionnent pas

Vérifiez que les noms des outils sont correctement orthographiés dans le tableau tools

Pour les outils MCP, assurez-vous que le serveur est correctement configuré dans mcpServers

Vérifiez que les serveurs MCP fonctionnent et sont accessibles

Utilisez la bonne syntaxe pour les outils MCP : @server_name/tool_name

Comparez les noms des outils intégrés avec la documentation relative aux outils intégrés dans la documentation complémentaire de l’interface de ligne de commande d’Amazon Q Developer

/tools renvoie une liste vide

Les outils attendus ne figurent pas dans la liste des outils

L’agent personnalisé ne semble pas disposer de fonctionnalités

Tableau tools vide dans la configuration de l’agent personnalisé

Fautes de frappe dans les noms des outils dans le tableau tools

Noms incorrects des outils du serveur MCP (préfixe du serveur manquant)

Problèmes de configuration du serveur MCP empêchant le chargement des outils

Vérifiez que la configuration de votre agent personnalisé inclut un tableau tools avec des noms d’outils valides

Vérifiez que les noms des outils sont correctement orthographiés (respect de la casse)

Pour les outils MCP, assurez-vous d’utiliser le bon format avec le préfixe du serveur : server-name___tool-name

Faites un test avec l’agent par défaut pour vérifier que les outils sont disponibles : q chat, puis /tools

Vérifiez le statut du serveur MCP si vous utilisez des outils externes

Demandes d’autorisation d’utilisation des outils répertoriés dans allowedTools

Interruptions du flux de travail malgré la configuration de l’agent personnalisé

Assurez-vous que les outils figurent bien dans les tableaux tools et allowedTools

Vérifiez que les noms d’outils des deux tableaux ne comportent pas de fautes de frappe

Pour les outils MCP, utilisez le nom complet avec le préfixe du serveur dans allowedTools

Vérifiez que les toolAliases sont correctement appliqués

Vérifiez que les chemins des fichiers dans le tableau resources sont corrects et que les fichiers existent

Vérifiez que les modèles glob des ressources correspondent aux fichiers souhaités

Assurez-vous que les commandes hook s’exécutent correctement et produisent une sortie

Testez les commandes hook manuellement pour vérifier qu’elles fonctionnent dans votre environnement

Vérifiez les paramètres du délai d’expiration des commandes hook si celles-ci sont interrompues

Vérifiez que les commandes des serveurs MCP sont correctes et que les exécutables se trouvent dans votre PATH

Vérifiez que les variables d’environnement requises sont définies

Testez les serveurs MCP individuellement pour vous assurer qu’ils fonctionnent

Vérifiez si les journaux des serveurs MCP comportent des messages d’erreur

Augmentez les valeurs du délai d’expiration si les serveurs sont lents à démarrer

Pour en savoir plus sur la résolution des problèmes liés aux serveurs MCP, consultez Utilisation de serveurs MCP avec Amazon Q Developer

Consultez la documentation relative à la configuration des agents dans la documentation complémentaire de l’interface de ligne de commande d’Amazon Q Developer

Consultez la documentation de référence des outils intégrés pour connaître la configuration de chaque outil

Pour les problèmes liés aux serveurs MCP, consultez la documentation MCP

Commencez par des configurations d’agents simples et augmentez progressivement la complexité

Comparez votre configuration avec les exemples présentés dans les exemples d’agents et les cas d’utilisation

N’oubliez pas que le changement et la modification d’agent nécessite de démarrer de nouvelles sessions de chat plutôt que d’utiliser des commandes en cours de session