Référence de configuration - Amazon Q Developer
Référence de configurationConcepts de configurationModèles de configuration courants

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.

Référence de configuration

Les fichiers de configuration des agents personnalisés sont des documents JSON qui définissent le comportement d'un agent personnalisé. Cette section fournit une vue d'ensemble des concepts de configuration et des modèles courants.

Référence de configuration

Pour obtenir des informations complètes sur le format de fichier de configuration de l'agent personnalisé, les champs disponibles et la syntaxe, consultez la documentation supplémentaire de l'Amazon Q Developer CLI :

Vous pouvez également consulter le schéma JSON pour les fichiers de configuration d'agents personnalisés en exécutant :

/agent schema

Concepts de configuration

Les fichiers de configuration des agents personnalisés contiennent plusieurs sections clés qui contrôlent différents aspects du comportement des agents personnalisés :

Métadonnées de base

Chaque agent personnalisé peut inclure des métadonnées de base pour l'identification et la documentation :

  • Nom : identifiant de l'agent personnalisé (dérivé du nom du fichier s'il n'est pas spécifié)

  • Description - Explication lisible par l'homme de l'objectif de l'agent personnalisé

Configuration des outils

La configuration des outils contrôle les outils mis à la disposition de l'agent personnalisé et leur comportement :

outils

Répertorie tous les outils que l'agent personnalisé peut potentiellement utiliser, y compris les outils intégrés et les outils du serveur MCP

Outils autorisés

Spécifie quels outils peuvent être exécutés sans confirmation de l'utilisateur, améliorant ainsi l'efficacité du flux de travail

Alias d'outils

Fournit des noms alternatifs pour les outils, utiles pour résoudre les conflits de dénomination ou créer des raccourcis

Réglages des outils

Configure le comportement spécifique des outils individuels, tels que les chemins de fichiers autorisés ou les autorisations de service

Configuration des serveurs MCP

La mcpServers section définit les serveurs Model Context Protocol auxquels l'agent personnalisé peut accéder. Chaque configuration de serveur inclut :

  • Commande : commande exécutable permettant de démarrer le serveur MCP

  • Arguments : arguments de ligne de commande pour le serveur

  • Variables d'environnement - Paramètres d'environnement pour le processus serveur

  • Paramètres du délai d'expiration - Configuration du délai d'expiration des demandes

Pour plus d'informations sur l'intégration de MCP, consultez la section Utilisation de MCP avec Amazon Q Developer.

Ressources et contexte

Les agents personnalisés peuvent automatiquement inclure le contexte pertinent par le biais de deux mécanismes :

resources

Fichiers et répertoires à inclure dans le contexte de l'agent personnalisé, prenant en charge les modèles globaux pour une sélection flexible des fichiers

hooks

Commandes à exécuter à des points de déclenchement spécifiques (comme le démarrage d'un agent personnalisé ou une entrée utilisateur), avec sortie incluse dans le contexte

Modèles de configuration courants

Configuration minimale de l'agent personnalisé

Un agent personnalisé simple qui fournit des opérations de base sur les fichiers avec un accès en lecture préapprouvé :

{
"name": "basic-ops",
  "description": "Basic file operations custom agent",
  "tools": [
    "fs_read",
    "fs_write",
    "execute_bash"
  ],
  "allowedTools": [
    "fs_read"
  ]
}

Agent personnalisé spécialisé dans le flux de travail

Un agent personnalisé configuré pour la gestion de l'infrastructure AWS avec des autorisations d'outils spécifiques :

{
"name": "infra-manage",
  "description": "AWS infrastructure management custom agent",
  "tools": [
    "fs_read",
    "fs_write",
    "execute_bash",
    "use_aws"
  ],
  "allowedTools": [
    "fs_read",
    "use_aws"
  ],
  "toolsSettings": {
    "use_aws": {
      "allowedServices": ["s3", "lambda", "cloudformation"]
    }
  },
  "resources": [
    "file://README.md",
    "file://infrastructure/**/*.yaml",
    "file://docs/deployment.md"
  ]
}

Agent personnalisé spécifique au projet avec crochets

Un agent personnalisé qui inclut le contexte du projet par le biais de fichiers statiques et de commandes dynamiques :

{
  "name": "project-dev",
  "description": "Project development custom agent with git context",
  "tools": [
    "fs_read",
    "fs_write",
    "execute_bash",
    "@git"
  ],
  "allowedTools": [
    "fs_read",
    "@git/git_status"
  ],
  "resources": [
    "file://README.md",
    "file://CONTRIBUTING.md",
    "file://src/**/*.md"
  ],
  "hooks": {
    "agentSpawn": [
      {
        "command": "git status --porcelain",
        "timeout_ms": 10000
      }
    ]
  }
}

Agent personnalisé avec intégration au serveur MCP

Un agent personnalisé qui intègre des outils externes via des serveurs MCP :

{
"name": "custom-dev",
  "description": "Development custom agent with external tool integration",
  "mcpServers": {
    "git": {
      "command": "git-mcp-server",
      "args": [],
      "timeout": 30000
    },
    "fetch": {
      "command": "fetch-mcp-server",
      "args": ["--timeout", "10"]
    }
  },
  "tools": [
    "fs_read",
    "fs_write",
    "@git",
    "@fetch/fetch_url"
  ],
  "allowedTools": [
    "fs_read",
    "@git/git_status",
    "@fetch/fetch_url"
  ],
  "toolAliases": {
    "@git/git_status": "status",
    "@fetch/fetch_url": "get"
  }
}