Gestione del contesto

Gestione del contesto

I file di contesto contengono informazioni che vuoi che Amazon Q prenda in considerazione durante le tue conversazioni. Questi possono includere requisiti di progetto, standard di codifica, regole di sviluppo o qualsiasi altra informazione che aiuti Amazon Q a fornire risposte più pertinenti.

Esistono due modi per configurare il contesto:

• Risorse dell'agente (consigliato): contesto persistente definito nel file di configurazione dell'agente

• Contesto della sessione: contesto temporaneo aggiunto durante una sessione di chat utilizzando /context i comandi

Configurazione del contesto persistente con le risorse dell'agente

Il modo consigliato per configurare il contesto è tramite il resources campo nel file di configurazione dell'agente. Questo crea un contesto persistente che è disponibile ogni volta che si utilizza l'agente.

Aggiungi percorsi di file o modelli di glob all'resourcesarray nella configurazione dell'agente:

{
  "name": "my-agent",
  "description": "My development agent",
  "resources": [
    "file://README.md",
    "file://.amazonq/rules/**/*.md",
    "file://docs/**/*.md",
    "file://src/config.py"
  ]
}

Le risorse devono avere il prefisso file:// da per essere incluse come file di contesto. Questi file saranno automaticamente disponibili in tutte le sessioni di chat che utilizzano questo agente.

Aggiungere un contesto di sessione temporaneo

È possibile aggiungere temporaneamente file alla sessione di chat corrente utilizzando il /context add comando. Queste aggiunte sono disponibili solo per la sessione corrente e non persisteranno quando si avvia una nuova sessione di chat.

q chat
> /context add README.md
Added 1 path(s) to context.
Note: Context modifications via slash command is temporary.

Puoi anche aggiungere più file contemporaneamente usando i modelli a glob:

q chat
> /context add docs/*.md
Added 3 path(s) to context.
Note: Context modifications via slash command is temporary.

Per rendere permanenti le modifiche al contesto, aggiungi invece i file al resources campo del tuo agente.

Visualizzazione del contesto

Per visualizzare il contesto corrente, usa il /context show comando:

q chat
> /context show
👤 Agent (my-agent):
    README.md (1 match)
    .amazonq/rules/**/*.md (3 matches)
    docs/**/*.md (5 matches)

💬 Session (temporary):
    <none>

5 matched files in use:
👤 README.md (~250 tkns)
👤 .amazonq/rules/security.md (~180 tkns)
👤 .amazonq/rules/coding-standards.md (~320 tkns)
👤 docs/architecture.md (~150 tkns)
👤 docs/best-practices.md (~200 tkns)

Total: ~1100 tokens

L'output mostra:

• 👤 Agente: contesto persistente tratto dal resources campo del tuo agente

• 💬 Sessione: contesto temporaneo aggiunto durante la sessione corrente

Rimozione del contesto

Per rimuovere i file dal contesto della sessione corrente, usa il /context rm comando:

q chat
> /context rm src/temp-file.py
Removed 1 path(s) from context.
Note: Context modifications via slash command is temporary.

Per cancellare tutto il contesto della sessione, usa il /context clear comando:

q chat
> /context clear
Cleared context
Note: Context modifications via slash command is temporary.

Nota: non è possibile rimuovere il contesto definito dall'agente utilizzando i comandi. /context Per rimuovere definitivamente il contesto, modifica il campo del tuo agente. resources

Casi di utilizzo comune

Ecco alcuni casi d'uso comuni per la gestione del contesto:

Utilizzo delle regole del progetto

Amazon Q supporta regole a livello di progetto che possono definire linee guida e restrizioni di sicurezza. Queste regole sono definite nei file Markdown nella .amazonq/rules directory del progetto.

Ad esempio, puoi creare regole che specificano:

• A quali directory Amazon Q dovrebbe evitare di accedere

• Requisiti di sicurezza per il codice generato

• Standard di codifica e best practice

Il modo consigliato per includere le regole del progetto consiste nella configurazione dell'agente:

{
  "name": "my-project-agent",
  "resources": [
    "file://.amazonq/rules/**/*.md",
    "file://README.md",
    "file://docs/architecture.md"
  ]
}

Puoi anche aggiungere temporaneamente le regole del progetto alla sessione corrente:

q chat
> /context add .amazonq/rules/*.md
Added 3 path(s) to context.
Note: Context modifications via slash command is temporary.

Per ulteriori informazioni sulla creazione e l'uso delle regole di progetto, consulta Creazione di regole di progetto da utilizzare con Amazon Q Developer chat nella documentazione IDE.

Migrazione dal contesto della sessione alle risorse degli agenti

Se ti ritrovi ad aggiungere ripetutamente gli stessi file di contesto utilizzando i /context add comandi, valuta la possibilità di spostarli resources nel campo dell'agente per renderli persistenti:

1. Annota i file che aggiungi di frequente con /context add

2. Modifica il file di configurazione dell'agente

3. Aggiungi i percorsi dei file all'resourcesarray con file:// prefisso

4. Salva la configurazione dell'agente

Esempio di migrazione:

# Instead of running these commands every session:
> /context add README.md
> /context add docs/*.md
> /context add .amazonq/rules/*.md

# Add them to your agent config once:
{
  "resources": [
    "file://README.md",
    "file://docs/**/*.md", 
    "file://.amazonq/rules/**/*.md"
  ]
}