Definizione di un agente personalizzato - Amazon Q Developer
Creazione del primo agente personalizzatoPersonalizzare i comandi dell’agenteMigrazione dai profili precedentiUtilizzo dell’agente predefinito rispetto agli agenti personalizzati

Definizione di un agente personalizzato

Questa sezione specifica come creare e utilizzare gli agenti nel flusso di lavoro della CLI di Amazon Q Developer.

Creazione del primo agente personalizzato

Ecco una procedura guidata per creare il primo agente personalizzato:

  1. Avvia una sessione di chat della CLI di Amazon Q Developer:

    $ q chat

  2. Elenca gli agenti esistenti per verificare la disponibilità:

    /agent list

  3. Crea un nuovo agente (sostituisci my-agent con il tuo nome preferito):

    /agent create --name my-agent

    Questa azione crea un nuovo file di configurazione dell’agente e lo apre nell’editor predefinito (impostato tramite la variabile dell’ambiente EDITOR).

  4. Adegua la configurazione personalizzata dell’agente in base alle esigenze. Per iniziare in modo semplice, è possibile:

    • Aggiungere una descrizione che spieghi lo scopo dell’agente personalizzato

    • Specificare quali strumenti devono essere disponibili

    • Approvare preventivamente gli strumenti utilizzati di frequente

  5. Salvare il file di configurazione e uscire dall’editor per tornare alla sessione di chat.

  6. Inizia una nuova sessione di chat con il tuo agente personalizzato:

    $ q chat --agent my-agent

    Nota: non è possibile cambiare agente personalizzato all’interno di una sessione di chat esistente. Le modifiche personalizzate agli agenti richiedono l’avvio di una nuova sessione.

  7. Fai un test del tuo agente personalizzato chiedendogli di eseguire attività utilizzando gli strumenti che hai configurato.

Per informazioni dettagliate sulle opzioni di configurazione dell’agente personalizzato, consulta Informazioni di riferimento sulla configurazione.

Personalizzare i comandi dell’agente

La CLI di Amazon Q Developer fornisce diversi comandi per la gestione degli agenti personalizzati. Questi comandi sono disponibili durante una sessione di chat e iniziano con/agent.

Personalizzare i comandi dell’agente
Comando Descrizione Disponibilità
/agent list Mostra tutti gli agenti personalizzati disponibili nel tuo ambiente Sessione di chat
/agent schema Visualizza lo schema JSON per la creazione dei file di configurazione dell’agente Sessione di chat
/agent create --name [name] Crea un nuovo file di configurazione dell’agente personalizzato e lo apre nell’editor predefinito Sessione di chat

Nota: alcune operazioni di gestione degli agenti personalizzati richiedono la modifica manuale dei file anziché comandi interattivi. Le modifiche personalizzate degli agenti hanno effetto all’avvio di una nuova sessione di chat.

Migrazione dai profili precedenti

Quando esegui l’aggiornamento a una versione della CLI di Amazon Q Developer che supporta gli agenti e l’accesso, ti potrebbe essere richiesto di migrare i tuoi profili legacy agli agenti se:

  • Disponi di configurazioni di profilo esistenti

  • Stai eseguendo in modalità interattiva (la migrazione viene ignorata con --no-interactive)

  • Non hai ancora completato il processo di migrazione

Il processo di migrazione:

  • Converte le configurazioni del profilo esistenti nel nuovo formato dell’agente

  • Conserva le autorizzazioni dello strumento e le impostazioni di contesto esistenti

  • Crea i file di configurazione dell’agente nella tua home directory

  • Mantiene la retrocompatibilità con i flussi di lavoro esistenti

La migrazione è facoltativa e può essere rifiutata. Se scegli di non migrare, puoi continuare a utilizzare l’agente predefinito o creare nuovi agenti manualmente. Per controllare il comportamento di migrazione, utilizza il flag --no-interactive per ignorare completamente i prompt di migrazione.

Utilizzo dell’agente predefinito rispetto agli agenti personalizzati

La CLI di Amazon Q Developer include un agente predefinito integrato che fornisce l’accesso a tutti gli strumenti con autorizzazioni minime preapprovate. Questo agente predefinito:

  • Include tutti gli strumenti disponibili (integrati e MCP)

  • Preapprova solo lo strumento fs_read per la sicurezza

  • Include automaticamente file di progetto comuni come README.md e AmazonQ.md

  • Utilizza la configurazione MCP precedente, se disponibile

Gli agenti personalizzati consentono di:

  • Limitare l’accesso agli strumenti solo a quelli necessari

  • Approvare preventivamente strumenti aggiuntivi per ridurre le interruzioni

  • Includere documentazione e file contestuali specifici del progetto

  • Configurare il comportamento degli strumenti per il tuo caso d’uso specifico