Definizione di un agente personalizzato - Amazon Q Developer
Creare il tuo primo agente personalizzatoComandi dell'agente personalizzatoMigrazione dai profili precedentiUtilizzo dell'agente predefinito rispetto agli agenti personalizzati

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

Definizione di un agente personalizzato

Questa sezione spiega come creare e utilizzare agenti personalizzati nel flusso di lavoro Amazon Q Developer CLI.

Creare il tuo primo agente personalizzato

Ecco una step-by-step procedura dettagliata per creare il tuo primo agente personalizzato:

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

    $ q chat

  2. Elenca gli agenti esistenti per vedere cosa è disponibile:

    /agent list

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

    /agent create --name my-agent

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

  4. Personalizzate la configurazione personalizzata dell'agente in base alle esigenze. Per iniziare in modo semplice, potresti voler:

    • Aggiungi una descrizione che spieghi lo scopo dell'agente personalizzato

    • Specificate quali strumenti devono essere disponibili

    • Approva preventivamente gli strumenti che usi di frequente

  5. Salva il file di configurazione ed esci 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 puoi cambiare agente personalizzato all'interno di una sessione di chat esistente. Le modifiche personalizzate agli agenti richiedono l'avvio di una nuova sessione.

  7. Testa il tuo agente personalizzato chiedendogli di eseguire attività utilizzando gli strumenti che hai configurato.

Per informazioni dettagliate sulle opzioni di configurazione dell'agente personalizzato, consulta Riferimento alla configurazione.

Comandi dell'agente personalizzato

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

Comandi personalizzati per gli agenti
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 di file di configurazione degli agenti personalizzati 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 personalizzate di gestione degli agenti 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 di Amazon Q Developer CLI 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 utilizzando la modalità interattiva (la migrazione viene ignorata) --no-interactive

  • Non hai ancora completato il processo di migrazione

Il processo di migrazione:

  • Converte le configurazioni dei profili esistenti nel nuovo formato dell'agente

  • Conserva le autorizzazioni degli strumenti 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, utilizzate il --no-interactive flag per ignorare completamente le richieste di migrazione.

Utilizzo dell'agente predefinito rispetto agli agenti personalizzati

Amazon Q Developer CLI 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 per la sicurezza fs_read

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

  • Utilizza la configurazione MCP precedente, se disponibile

Gli agenti personalizzati consentono di:

  • Limita l'accesso agli strumenti solo a ciò di cui hai bisogno

  • Approva preventivamente strumenti aggiuntivi per ridurre le interruzioni

  • Includi documentazione e file contestuali specifici del progetto

  • Configura il comportamento dello strumento per il tuo caso d'uso specifico