Gestione degli agenti personalizzati - Amazon Q Developer
Posizioni personalizzate dei file degli agentiLe migliori pratiche per l'organizzazione degli agenti personalizzatiCondivisione di agenti personalizzati con i team

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à.

Gestione degli agenti personalizzati

Questa sezione spiega come organizzare, gestire e utilizzare gli agenti personalizzati in modo efficace nel flusso di lavoro di sviluppo.

Posizioni personalizzate dei file degli agenti

I file di configurazione degli agenti personalizzati vengono archiviati come file JSON in directory specifiche:

Agenti personalizzati globali

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

Disponibile in tutti i progetti e le directory del sistema.

Agenti personalizzati a livello di progetto

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

Disponibile solo all'interno della cartella specifica del progetto e delle relative sottodirectory.

Importante: il {agent-name} nome del file è solo di riferimento. Il nome effettivo dell'agente è determinato dal name campo all'interno del file di configurazione JSON stesso, che è obbligatorio.

Precedenza personalizzata degli agenti e risoluzione dei conflitti

Quando la CLI di Amazon Q Developer cerca un agente personalizzato, segue un ordine di precedenza specifico:

  1. Innanzitutto gli agenti personalizzati locali: verifica la presenza di agenti personalizzati nella directory di lavoro corrente

  2. In secondo luogo, gli agenti personalizzati globali: torna agli agenti personalizzati presenti nella home directory

  3. Impostazioni predefinite: utilizza l'agente predefinito se non viene trovato alcun agente personalizzato

Se entrambe le directory locali e globali contengono agenti personalizzati con lo stesso nome, l'agente personalizzato locale ha la precedenza. La CLI per sviluppatori di Amazon Q mostrerà un messaggio di avviso quando ciò si verifica:

WARNING: Agent conflict for my-agent. Using workspace version.

Questo sistema di precedenza ti consente di:

  • Sostituisci gli agenti personalizzati globali con versioni specifiche del progetto

  • Prova le modifiche agli agenti personalizzati localmente prima di renderle globali

  • Mantieni diverse configurazioni di agenti personalizzati per diversi progetti

Le migliori pratiche per l'organizzazione degli agenti personalizzati

Quando utilizzare agenti personalizzati globali

Utilizza agenti personalizzati globali per:

  • Flussi di lavoro generici: agenti personalizzati utilizzati in più progetti

  • Produttività personale: agenti personalizzati personalizzati in base al tuo stile di lavoro individuale

  • Attività di sviluppo comuni: revisione del codice, debug, generazione della documentazione

  • Flussi di lavoro specifici per strumenti: gestione AWS, operazioni Git, flussi di lavoro Docker

Quando utilizzare agenti personalizzati locali

Utilizza agenti personalizzati locali per:

  • Configurazioni specifiche del progetto: agenti personalizzati che richiedono l'accesso a file di progetto specifici

  • Collaborazione in team: agenti personalizzati condivisi tramite il controllo delle versioni

  • Ambienti di sviluppo: agenti personalizzati con requisiti unici per progetti specifici

  • Test e sperimentazione: modifiche temporanee agli agenti personalizzati senza influire sulle impostazioni globali

Convenzioni di denominazione degli agenti personalizzate

Prendi in considerazione queste convenzioni di denominazione per una migliore organizzazione personalizzata degli agenti:

  • Nomi basati sullo scopo -,, aws-specialist.json code-reviewer.json documentation-writer.json

  • Nomi specifici della tecnologia -, python-dev.json react-frontend.json terraform-ops.json

  • Nomi specifici del progetto -, project-alpha.json mobile-app.json api-backend.json

  • Nomi specifici dell'ambiente -, development.json staging.json production.json

Condivisione di agenti personalizzati con i team

Gli agenti personalizzati locali possono essere condivisi con i membri del team tramite sistemi di controllo delle versioni. Questo approccio consente ai team di:

  • Standardizza gli ambienti di sviluppo: assicurati che tutti i membri del team abbiano accesso agli stessi strumenti e configurazioni

  • Condividi il contesto specifico del progetto: includi la documentazione del progetto, gli standard di codifica e gli script personalizzati

  • Mantieni la coerenza: utilizza le stesse autorizzazioni e impostazioni dello strumento in tutto il team

  • Collabora ai miglioramenti: utilizza le richieste pull per rivedere e migliorare le configurazioni personalizzate degli agenti

Best practice per il controllo delle versioni

Quando si condividono agenti personalizzati tramite il controllo della versione:

  • Includi directory di agenti personalizzate: aggiungi .aws/amazonq/agents/ al tuo repository

  • Documenta gli scopi degli agenti personalizzati: utilizza descrizioni chiare nei file di configurazione degli agenti personalizzati

  • Rivedi le modifiche agli agenti personalizzati: tratta le modifiche alla configurazione degli agenti personalizzati come le modifiche al codice

  • Verifica le configurazioni degli agenti personalizzati: verifica che gli agenti personalizzati condivisi funzionino correttamente per tutti i membri del team

  • Evita le informazioni sensibili: non includere chiavi API, password o informazioni personali negli agenti personalizzati condivisi