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.
Exemples
Cette section fournit des exemples pratiques de configurations d'agents personnalisées pour les flux de travail de développement et les cas d'utilisation courants.
Agent personnalisé spécialisé AWS
Cet agent personnalisé est optimisé pour les tâches de gestion et de développement de l'infrastructure AWS. Il fournit un accès préapprouvé aux outils AWS tout en incluant la documentation pertinente.
Exemple Configuration d'agents personnalisés AWS Specialist
{ "description": "Specialized custom agent for AWS infrastructure and development tasks", "tools": [ "fs_read", "fs_write", "execute_bash", "use_aws" ], "allowedTools": [ "fs_read", "use_aws" ], "toolsSettings": { "use_aws": { "allowedServices": [ "s3", "lambda", "cloudformation", "ec2", "iam", "logs" ] }, "fs_write": { "allowedPaths": [ "infrastructure/**", "scripts/**", "*.yaml", "*.yml", "*.json" ] } }, "resources": [ "file://README.md", "file://infrastructure/**/*.yaml", "file://infrastructure/**/*.yml", "file://docs/aws-setup.md", "file://scripts/deploy.sh" ], "hooks": { "agentSpawn": [ { "command": "aws sts get-caller-identity", "timeout_ms": 10000, "cache_ttl_seconds": 300 } ] } }
Cas d'utilisation de cet agent personnalisé :
-
Déploiement CloudFormation de piles
-
Gestion des compartiments S3 et des fonctions Lambda
-
Résolution des problèmes liés aux services AWS
-
Révision et mise à jour de l'infrastructure sous forme de code
Agent personnalisé pour le flux de travail de développement
Cet agent personnalisé est conçu pour les tâches générales de développement logiciel, notamment la révision du code, les tests et les opérations Git.
Exemple Configuration d'agents personnalisés pour le flux de travail de développement
{ "description": "General development workflow custom agent with Git integration", "mcpServers": { "git": { "command": "git-mcp-server", "args": [], "timeout": 30000 } }, "tools": [ "fs_read", "fs_write", "execute_bash", "@git" ], "allowedTools": [ "fs_read", "@git/git_status", "@git/git_log", "@git/git_diff" ], "toolAliases": { "@git/git_status": "status", "@git/git_log": "log", "@git/git_diff": "diff" }, "toolsSettings": { "fs_write": { "allowedPaths": [ "src/**", "tests/**", "docs/**", "*.md", "*.json", "package.json", "requirements.txt" ] } }, "resources": [ "file://README.md", "file://CONTRIBUTING.md", "file://docs/**/*.md", "file://package.json", "file://requirements.txt" ], "hooks": { "agentSpawn": [ { "command": "git status --porcelain", "timeout_ms": 5000 }, { "command": "git branch --show-current", "timeout_ms": 3000 } ] } }
Cas d'utilisation de cet agent personnalisé :
-
Révision et analyse du code
-
Rédaction et mise à jour de tests
-
Gestion du flux de travail Git
-
Mises à jour de la documentation
-
Gestion des dépendances
Agent personnalisé de révision de code
Cet agent personnalisé se concentre spécifiquement sur les tâches de révision du code, avec des outils et un contexte optimisés pour analyser la qualité du code, la sécurité et les meilleures pratiques.
Exemple Configuration de l'agent personnalisé pour la révision du code
{ "description": "Specialized custom agent for code review and quality analysis", "tools": [ "fs_read", "execute_bash" ], "allowedTools": [ "fs_read", "execute_bash" ], "toolsSettings": { "execute_bash": { "allowedCommands": [ "grep", "find", "wc", "head", "tail", "cat", "diff", "git diff", "git log", "eslint", "pylint", "rubocop" ] } }, "resources": [ "file://CONTRIBUTING.md", "file://docs/coding-standards.md", "file://docs/security-guidelines.md", "file://.eslintrc.json", "file://.pylintrc", "file://pyproject.toml" ], "hooks": { "agentSpawn": [ { "command": "git diff --name-only HEAD~1", "timeout_ms": 5000, "max_output_size": 2048 } ], "userPromptSubmit": [ { "command": "find . -name '*.py' -o -name '*.js' -o -name '*.ts' | wc -l", "timeout_ms": 3000, "cache_ttl_seconds": 60 } ] } }
Cas d'utilisation de cet agent personnalisé :
-
Examen des pull requests pour vérifier la qualité du code
-
Identification des failles de sécurité
-
Vérification du respect des normes de codage
-
Analyse de la complexité et de la maintenabilité du code
-
Suggérer des améliorations et des opportunités de refactorisation
Agent personnalisé spécifique au projet
Cet exemple montre comment créer un agent personnalisé adapté à un projet spécifique, y compris des outils, de la documentation et des processus de création spécifiques au projet.
Exemple Configuration d'agent personnalisé spécifique au projet
{ "description": "Custom agent for the mobile app backend project", "mcpServers": { "docker": { "command": "docker-mcp-server", "args": ["--socket", "/var/run/docker.sock"] }, "database": { "command": "postgres-mcp-server", "args": ["--connection", "postgresql://localhost:5432/myapp"], "env": { "PGPASSWORD": "$DATABASE_PASSWORD" } } }, "tools": [ "fs_read", "fs_write", "execute_bash", "@docker", "@database" ], "allowedTools": [ "fs_read", "@docker/docker_ps", "@docker/docker_logs", "@database/query_read_only" ], "toolAliases": { "@docker/docker_ps": "containers", "@docker/docker_logs": "logs", "@database/query_read_only": "query" }, "toolsSettings": { "fs_write": { "allowedPaths": [ "src/**", "tests/**", "migrations/**", "docker-compose.yml", "Dockerfile", "requirements.txt" ] }, "execute_bash": { "allowedCommands": [ "npm test", "npm run build", "python manage.py test", "docker-compose up", "docker-compose down" ] } }, "resources": [ "file://README.md", "file://docs/api-documentation.md", "file://docs/database-schema.md", "file://docker-compose.yml", "file://requirements.txt", "file://src/config/settings.py" ], "hooks": { "agentSpawn": [ { "command": "docker-compose ps", "timeout_ms": 10000, "cache_ttl_seconds": 30 }, { "command": "git status --porcelain", "timeout_ms": 5000 } ] } }
Cas d'utilisation de cet agent personnalisé :
-
Gestion des conteneurs et des services Docker
-
Exécution de requêtes et de migrations de base de données
-
Création et test de l'application
-
Débogage des problèmes de production
-
Mettre à jour la documentation des API
Conseils pour créer des agents personnalisés efficaces
-
Commencez simplement : commencez par les configurations d'outils de base et ajoutez de la complexité selon les besoins
-
Utiliser des noms descriptifs : choisissez des noms d'agents personnalisés qui indiquent clairement leur objectif
-
Inclure le contexte pertinent - Ajoutez la documentation du projet et les fichiers de configuration aux ressources
-
Pré-approbation des outils sécurisés - Incluez les outils fréquemment utilisés et à faible risque dans AllowedTools
-
Utiliser des crochets pour un contexte dynamique - Incluez l'état actuel du système via des crochets de commande
-
Limiter la portée de l'outil : utilisez ToolsSettings pour restreindre l'accès des outils aux chemins et services pertinents
-
Effectuez des tests approfondis : vérifiez que la configuration de votre agent personnalisé fonctionne comme prévu
-
Documentez vos agents personnalisés : utilisez des descriptions claires pour aider les membres de l'équipe à comprendre les objectifs des agents personnalisés
