Informazioni di riferimento sulla configurazione - Amazon Q Developer
Informazioni di riferimento sulla configurazioneConcetti di configurazioneSchemi di configurazione comuni

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

Informazioni di riferimento sulla configurazione

I file di configurazione dell'agente personalizzato sono documenti JSON che definiscono il comportamento di un agente personalizzato. Questa sezione fornisce una panoramica dei concetti di configurazione e dei modelli comuni.

Informazioni di riferimento sulla configurazione

Per dettagli completi sul formato del file di configurazione dell'agente personalizzato, i campi disponibili e la sintassi, consulta la documentazione supplementare Amazon Q Developer CLI:

Puoi anche visualizzare lo schema JSON per i file di configurazione degli agenti personalizzati eseguendo:

/agent schema

Concetti di configurazione

I file di configurazione degli agenti personalizzati contengono diverse sezioni chiave che controllano diversi aspetti del comportamento degli agenti personalizzati:

Metadati di base

Ogni agente personalizzato può includere metadati di base per l'identificazione e la documentazione:

  • Nome: l'identificatore dell'agente personalizzato (derivato dal nome del file se non specificato)

  • Descrizione: spiegazione leggibile dall'uomo dello scopo dell'agente personalizzato

Configurazione degli strumenti

La configurazione degli strumenti controlla quali strumenti sono disponibili per l'agente personalizzato e come si comportano:

strumenti

Elenca tutti gli strumenti che l'agente personalizzato può potenzialmente utilizzare, inclusi gli strumenti integrati e gli strumenti del server MCP

Strumenti consentiti

Speciifica quali strumenti possono essere eseguiti senza la conferma dell'utente, migliorando l'efficienza del flusso di lavoro

Alias degli strumenti

Fornisce nomi alternativi per gli strumenti, utili per risolvere conflitti di denominazione o creare scorciatoie

Impostazioni degli strumenti

Configura un comportamento specifico per i singoli strumenti, come i percorsi dei file consentiti o le autorizzazioni di servizio

Configurazione dei server MCP

La mcpServers sezione definisce a quali server Model Context Protocol può accedere l'agente personalizzato. Ogni configurazione del server include:

  • Comando: il comando eseguibile per avviare il server MCP

  • Argomenti: argomenti della riga di comando per il server

  • Variabili di ambiente: impostazioni di ambiente per il processo del server

  • Impostazioni del timeout: richiedi la configurazione del timeout

Per ulteriori informazioni sull'integrazione MCP, consulta Using MCP with Amazon Q Developer.

Risorse e contesto

Gli agenti personalizzati possono includere automaticamente il contesto pertinente attraverso due meccanismi:

risorse

File e directory da includere nel contesto dell'agente personalizzato, che supportano modelli a glob per una selezione flessibile dei file

hooks

Comandi da eseguire in punti trigger specifici (come l'avvio di un agente personalizzato o l'input dell'utente), con l'output incluso nel contesto

Schemi di configurazione comuni

Configurazione minima dell'agente personalizzato

Un semplice agente personalizzato che fornisce operazioni di base sui file con accesso in lettura preapprovato:

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

Agente personalizzato per il flusso di lavoro specializzato

Un agente personalizzato configurato per la gestione dell'infrastruttura AWS con autorizzazioni per strumenti specifici:

{
"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"
  ]
}

Agente personalizzato specifico del progetto con ganci

Un agente personalizzato che include il contesto del progetto tramite file statici e comandi dinamici:

{
  "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
      }
    ]
  }
}

Agente personalizzato con integrazione del server MCP

Un agente personalizzato che integra strumenti esterni tramite server 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"
  }
}