Istruzioni per l'agente

Utilizza le istruzioni dell'agente per fornire una guida sempre attiva che AWS DevOps l'agente applica a ogni sessione. Una sessione è una singola conversazione o indagine con un agente. Nella pagina Agenti della tua app Web Agent Space Operator, puoi impostare istruzioni globali che si applicano a tutti gli agenti o impostare istruzioni per uno specifico agente gestito, come Chat o Incident Triage. Queste istruzioni vengono archiviate come AGENTS.md file. A differenza DevOps Competenze degli agenti di quelle che vengono caricate su richiesta quando l'agente abbina una descrizione delle competenze all'attività corrente, le istruzioni dell'agente sono sempre presenti dall'inizio di ogni sessione, indipendentemente da ciò su cui l'agente sta lavorando.

Cosa sono le istruzioni per l'agente

Le istruzioni per gli agenti forniscono agli agenti una guida incondizionata e sempre attiva. All'inizio di ogni sessione, il servizio agente recupera le istruzioni configurate per Agent Space e ne inserisce il contenuto direttamente nel prompt del sistema dell'agente. L'agente non decide se caricarle; sono sempre presenti.

Ogni sessione dell'agente riceve istruzioni sia dalle istruzioni globali che dalle istruzioni specifiche dell'agente pertinenti, ad esempio Chat.

Le istruzioni dell'agente vengono archiviate come AGENTS.md file e differiscono tra loro DevOps Competenze degli agenti in diversi modi importanti:

Aspetto	Abilità	Istruzioni per l'agente (AGENTS.md)
Nome e descrizione	Richiesto	Non applicabile
Formato del contenuto	Pacchetto Markdown o ZIP	Solo Markdown
File di risorse	Supportata	Non supportata
Iniezione di contesto	Su richiesta (l'agente decide tramite l'abbinamento della descrizione delle competenze)	Sempre (incondizionato, ogni sessione)
Univocità	Spazio multiplo per agente	Uno per agente (uno per le istruzioni globali, uno per agente gestito)

Le istruzioni dell'agente non hanno un nome o un campo di descrizione. Il AGENTS.md file sottostante contiene solo markdown senza frontespizio, senza supporto per pacchetti ZIP e senza file di risorse.

Perché usare le istruzioni per gli agenti

Le istruzioni per gli agenti offrono un modo affidabile per garantire che determinate indicazioni siano sempre contestualizzate, senza dipendere dalle decisioni che comportano un carico di competenze dell'agente.

Principali vantaggi:

• Prevedibilità: le istruzioni sono sempre presenti, indipendentemente dall'attività su cui sta lavorando l'agente. Non è richiesta alcuna corrispondenza tra le descrizioni e l'agente non può ignorare il contenuto.

• Copertura garantita: a differenza di Skills, che l'agente può caricare o meno a seconda della rilevanza dell'attività, le istruzioni dell'agente vengono sempre fornite all'inizio di ogni sessione.

• Politiche permanenti: utilizza le istruzioni degli agenti per le politiche operative permanenti, le linee guida di sicurezza, gli standard di codifica o qualsiasi altra guida che debba essere applicata a ogni sessione senza eccezioni.

• Ambito mirato: è possibile applicare le istruzioni a tutti i tipi di agente contemporaneamente utilizzando istruzioni globali o limitare le istruzioni a un tipo specifico di agente quando le linee guida riguardano solo il lavoro di quell'agente.

Come funzionano le istruzioni per gli agenti

All'avvio di una sessione, il servizio dell'agente recupera le istruzioni configurate per Agent Space e ne inserisce il contenuto nel prompt del sistema dell'agente prima dell'inizio della sessione. Ciò avviene automaticamente per ogni sessione. L'agente non valuta se caricarli; inietta sempre il contenuto.

Ogni nuova sessione carica le istruzioni fresche all'avvio. Se aggiorni le istruzioni, la modifica ha effetto immediato per le sessioni che iniziano dopo il salvataggio. Le sessioni già in corso continuano a utilizzare il contenuto caricato al momento dell'avvio.

L'ambito determina le istruzioni ricevute da una sessione. Le istruzioni globali si applicano a tutti i tipi di agenti presenti nell'Agent Space, quindi ogni sessione le riceve. Agent-specific le istruzioni si applicano solo alle sessioni di quel particolare tipo di agente. Una sessione riceve istruzioni sia dalle istruzioni globali che dalle istruzioni pertinenti specifiche dell'agente.

Ambito del tipo di agente

L'ambito controlla quali sessioni di agenti ricevono un determinato set di istruzioni. Sono disponibili due opzioni di ambito:

• Istruzioni globali: si applicano a tutti i tipi di agenti presenti nell'Agent Space. Ogni sessione dell'agente riceve questo contenuto.

• Agent-specific: si applica solo alle sessioni del tipo di agente selezionato.

Gli agenti gestiti disponibili per istruzioni specifiche per agente sono:

• Chat: Ad-hoc domande e richieste durante le sessioni di chat.

• Valutazione degli incidenti: filtraggio degli allarmi, classificazione della gravità e definizione iniziale dell'ambito.

• RCA degli incidenti: analisi delle cause principali con raccolta e convalida delle prove.

• Attenuazione degli incidenti: raccomandazioni per la correzione e Short-term la correzione a lungo termine.

• Valutazione: valutazione delle prestazioni degli agenti e controlli di conformità alle politiche.

Indicazioni sulla dimensione dei contenuti

Ogni volta che inizi una conversazione o un'indagine, l'agente legge tutte le tue istruzioni prima di fare qualsiasi altra cosa. L'agente dispone di una quantità fissa di memoria di lavoro per sessione e le istruzioni dell'utente ne utilizzano una parte. Più grande è il file, meno spazio rimane per le domande, le indagini, i registri letti dall'agente e il suo ragionamento. Istruzioni più brevi e mirate offrono all'agente una maggiore capacità di risolvere il problema.

• Limite rigido: 25 KB

• Dimensione consigliata: 120 righe (consigliata per la maggior parte delle configurazioni)

Concentra le tue istruzioni sulla guida che deve essere presente in ogni sessione. Per le procedure di indagine specializzate che si applicano solo a compiti specifici, considera DevOps Competenze degli agenti invece l'utilizzo.

Esempio

L'esempio seguente mostra istruzioni ben formate per gli agenti con linee guida per le indagini, standard di formattazione delle risposte e requisiti di sicurezza che si applicano a ogni sessione dell'agente.

# Agent Instructions

## Investigation approach
- Always check CloudWatch alarms and recent deployments before proposing a root cause.

## Response format
- Lead with a one-sentence summary of findings before listing details.
- Include the AWS region and resource identifier for any resource you reference.
- Use bullet points for lists of findings or recommendations.

## Security
- Never log, display, or suggest storing credentials or secrets in plaintext.
- When recommending IAM changes, follow least-privilege principles.

Impostazione delle istruzioni per l'agente

Prima di impostare le istruzioni per l'agente, è necessario disporre di un Agent Space. Per ulteriori informazioni, consulta Creazione di uno spazio per agenti.

Ogni agente ha esattamente un set di istruzioni. Quando si salvano nuovi contenuti, questi sovrascrivono i contenuti esistenti per quell'agente.

Per impostare istruzioni globali (si applica a tutti gli agenti):

1. Vai alla pagina Agenti nella tua app Web Agent Space Operator.

2. Scegli Visualizza accanto alle istruzioni globali.

3. Inserisci le istruzioni di markdown nell'editor.

4. Scegli Save (Salva).

Per impostare le istruzioni per un agente specifico:

1. Vai alla pagina Agenti nella tua app Web Agent Space Operator.

2. In Agenti gestiti, scegli Visualizza accanto all'agente che desideri configurare: Chat, Incident triage, Incident RCA, Incident mitigation o Evaluation.

3. Inserisci le istruzioni di markdown nell'editor.

4. Scegli Save (Salva).

Istruzioni per gli agenti di gestione

AWS DevOps L'agente fornisce funzionalità di gestione per le istruzioni degli agenti tramite l'Operator Web App.

Visualizzazione delle istruzioni: accedi alla pagina Agenti e scegli Visualizza accanto a Istruzioni globali o all'agente gestito specifico. L'editor mostra il contenuto corrente. Usa la scheda Anteprima per vedere il markdown renderizzato o la scheda Codice per vedere il markdown non elaborato.

Istruzioni di modifica: apri l'agente come descritto sopra, modifica il contenuto nell'editor e scegli Salva.

Istruzioni per il caricamento da un file: apri l'agente, quindi scegli il pulsante Carica nell'editor per caricare un file markdown dal tuo computer.

Istruzioni per il download: apri l'agente, quindi scegli il pulsante Download nell'editor per scaricare il contenuto corrente come file.

Istruzioni per l'eliminazione: apri l'agente, scegli il pulsante Elimina nell'editor e conferma l'eliminazione. Questa operazione non può essere annullata. Prendi in considerazione la possibilità di scaricare prima il contenuto se potresti averne bisogno di nuovo.