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à.
Istruzioni per l'agente
Utilizza le istruzioni dell'agente per fornire indicazioni sempre attive che l' AWS DevOps agente applica a ogni sessione. Una sessione è una singola conversazione o indagine con un agente. Nella pagina Knowledge della tua app Web Agent Space Operator, scegli la scheda Istruzioni per impostare le istruzioni che si applicano a tutti gli agenti o imposta le istruzioni per un agente gestito specifico, ad esempio 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 dell'agente
Le istruzioni per gli agenti forniscono una guida incondizionata e sempre attiva per i vostri agenti. All'inizio di ogni sessione, il servizio agente recupera le istruzioni configurate per l'Agent Space e ne inserisce il contenuto direttamente nel prompt del sistema dell'agente. L'agente non decide se caricarli; sono sempre presenti.
Ogni sessione dell'agente riceve istruzioni sia dalle istruzioni globali che dalle relative istruzioni specifiche dell'agente, ad esempio Chat.
Le istruzioni dell'agente vengono archiviate come AGENTS.md file e differiscono 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 confrontando le descrizioni 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 campo relativo al nome o alla 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 dell'agente
Le istruzioni per gli agenti offrono un modo affidabile per garantire che determinate indicazioni siano sempre contestualizzate, senza dipendere dalle decisioni dell'agente in materia di competenze.
Principali vantaggi:
Prevedibilità: le istruzioni sono sempre presenti, indipendentemente dall'attività su cui l'agente sta lavorando. 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 pertinenza dell'attività, le istruzioni dell'agente vengono sempre inserite all'inizio di ogni sessione.
Politiche permanenti: utilizza le istruzioni dell'agente per le politiche operative permanenti, le linee guida di sicurezza, gli standard di codifica o qualsiasi altra guida che deve essere applicata a ogni sessione senza eccezioni.
Ambito mirato: puoi applicare le istruzioni a tutti i tipi di agente contemporaneamente utilizzando istruzioni globali o limitare le istruzioni a un tipo di agente specifico quando le linee guida sono pertinenti solo al lavoro di quell'agente.
Come funzionano le istruzioni per gli agenti
All'avvio di una sessione, il servizio agente recupera le istruzioni configurate per l'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 nuove istruzioni all'avvio. Se si aggiornano 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 all'avvio.
L'ambito determina le istruzioni ricevute da una sessione. Le istruzioni globali si applicano a tutti i tipi di agenti nel tuo 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 relative istruzioni 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 scoping:
Istruzioni globali: si applicano a tutti i tipi di agenti presenti nel tuo 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 le istruzioni specifiche dell'agente sono:
Chat: Ad-hoc domande e richieste durante le sessioni di chat.
Triage 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.
Mitigazione degli incidenti: raccomandazioni per la correzione e Short-term la correzione a lungo termine.
Incident UI: generazione dei risultati di un'indagine, compresi quelli pubblicati su altre piattaforme.
Valutazione: punteggio delle prestazioni degli agenti e controlli di conformità alle politiche.
Test di rilascio: test automatizzati dell'interfaccia utente e delle API REST sulle applicazioni Web e sulle API REST distribuite.
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 ne utilizzano una parte. Più grande è il file, minore è lo spazio rimasto per le domande, le indagini, i log letti dall'agente e il proprio 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 sulle indicazioni che devono essere presenti in ogni sessione. Per procedure investigative specializzate che si applicano solo a compiti specifici, valuta DevOps Competenze degli agenti invece l'utilizzo.
Esempio
L'esempio seguente mostra istruzioni ben formate per gli agenti con indicazioni sulle 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 gli agenti, è 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 salva un nuovo contenuto, questo sovrascrive il contenuto esistente per quell'agente.
Per impostare istruzioni globali (valide per tutti gli agenti):
Accedi alla pagina delle informazioni nella tua app Web Agent Space Operator.
Scegli la scheda Istruzioni.
Scegli Visualizza accanto a Tutti gli agenti.
Inserisci le istruzioni di markdown nell'editor.
Selezionare Salva.
Per impostare le istruzioni per un agente specifico:
Accedi alla pagina delle informazioni nella tua app Web Agent Space Operator.
Scegli la scheda Istruzioni.
Scegli Visualizza accanto all'agente che desideri configurare: Chat, Incident triage, Incident RCA, Incident Mitigation, Incident UI , Evaluation o Release testing.
Inserisci le istruzioni di markdown nell'editor.
Selezionare Salva.
Gestione delle istruzioni per gli agenti
AWS DevOps L'agente fornisce funzionalità di gestione per le istruzioni degli agenti tramite l'Operator Web App.
Visualizzazione delle istruzioni: accedi alla pagina Knowledge, scegli la scheda Istruzioni e scegli Visualizza accanto a Tutti gli agenti 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 grezzo.
Istruzioni per la modifica: aprite l'agente come descritto sopra, modificate il contenuto nell'editor e scegliete 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. Valuta la possibilità di scaricare prima il contenuto se potresti averne bisogno di nuovo.
