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à.
Creazione di un agente personalizzato
È possibile creare un agente personalizzato in due modi: utilizzando il modulo nell'app web DevOps Agent o tramite una conversazione guidata in Chat. Entrambi i metodi danno come risultato la stessa configurazione personalizzata dell'agente memorizzata nell'Agent Space.
Prima di creare un agente personalizzato, è necessario disporre di un Agent Space con almeno un'integrazione connessa. Per ulteriori informazioni, consulta Creazione di uno spazio per agenti.
Creazione di un agente personalizzato utilizzando il modulo
Il modulo consente di creare rapidamente un agente personalizzato specificando un nome, un prompt di sistema e competenze opzionali. Per assegnare gli strumenti MCP all'agente, usa Chat dopo aver creato l'agente.
Per creare un agente personalizzato utilizzando il modulo:
Accedi alla pagina Agenti nella tua app web per DevOps agenti.
Nella sezione Agenti personalizzati, scegli Crea agente.
Nella finestra di dialogo, scegli Modulo.
Compila il modulo:
Nome: un identificativo univoco per il tuo agente. Utilizza solo lettere minuscole, numeri e trattini (massimo 64 caratteri). Non deve iniziare o terminare con un trattino. Ad esempio:
weekly-health-reportPrompt di sistema: istruzioni che definiscono cosa fa l'agente e come funziona, scritte in Markdown (minimo 10 caratteri, massimo 50.000 caratteri). Per indicazioni sulla scrittura di prompt efficaci, vedi Scrivere un prompt di sistema.
Competenze (opzionali): seleziona dal tuo Agent Space le competenze che forniscono all'agente conoscenze o funzionalità aggiuntive sul dominio. Usa il campo di ricerca per trovare le competenze per nome.
Scegliere Create agent (Crea agente).
Dopo la creazione, verrai reindirizzato alla pagina dei dettagli dell'agente in cui puoi visualizzare la configurazione, eseguire l'agente o impostare i trigger.
Creazione di un agente personalizzato tramite Chat
Chat offre un'esperienza conversazionale guidata per la creazione di agenti personalizzati. Questo metodo è consigliato quando si desidera assegnare strumenti MCP all'agente o quando si desidera assistenza nella stesura del prompt di sistema.
Per creare un agente personalizzato utilizzando Chat:
Accedi alla pagina Agenti nella tua app web per DevOps agenti.
Nella sezione Agenti personalizzati, scegli Crea agente.
Nella finestra di dialogo, scegli Chat. La finestra di dialogo si chiude e nel pannello Chat si apre una nuova conversazione con un messaggio precomposto.
La chat ti guida attraverso un processo collaborativo:
Chiarimento delle intenzioni: conferma lo scopo e la portata del tuo agente.
Controllo duplicato: verifica che nessun agente simile sia già presente nel tuo Agent Space.
Selezione di strumenti e competenze: propone gli strumenti e le competenze MCP necessari all'agente e ti chiede di confermare.
Tipo di output: determina se l'agente deve produrre risposte testuali, artefatti o raccomandazioni.
Bozza del prompt di sistema: scrive un prompt di sistema e lo presenta per la revisione. Puoi ripetere l'iterazione finché non sei soddisfatto.
Conferma: suggerisce un nome e conferma tutte le impostazioni prima di creare l'agente.
Puoi anche creare un agente personalizzato chiedendo direttamente a Chat in qualsiasi momento. Ad esempio:
Create an agent that generates a weekly report of all investigations from the past week.
Create a custom agent for checking certificate expiration across all accounts.
Make me an agent that audits DynamoDB table configurations daily.
Importazione di un agente personalizzato da un repository
È possibile importare il prompt di sistema di un agente personalizzato direttamente da un file Markdown in un repository. GitHub Il contenuto del file diventa il prompt di sistema dell'agente. È possibile gestire i prompt dell'agente nel controllo della versione e importarli con una sola azione.
Prerequisiti:
Un GitHub account associato al tuo Agent Space. Per connettere un GitHub account, consultaConnessione GitHub. Qualsiasi connessione GitHub all'account consente l'importazione da archivi pubblici. Per gli archivi privati, l'account associato deve avere accesso in lettura al repository. GitHub Sono supportati anche Enterprise Server ed GitHub Enterprise Cloud con connessioni di residenza dei dati.
Un file Markdown (
.md) in un GitHub repository contenente il prompt di sistema.
Per importare un agente personalizzato da un repository:
Accedi alla pagina Agenti nella tua app web per DevOps agenti.
Nella sezione Agenti personalizzati, scegli Crea agente.
Nella finestra di dialogo, scegli Importa. La finestra di dialogo passa alla GitHub vista Importa da.
Compila il modulo:
Nome: un identificativo univoco per il tuo agente. Utilizza solo lettere minuscole, numeri e trattini (massimo 64 caratteri). Non deve iniziare o terminare con un trattino.
URL del repository: collegamento a un singolo file Markdown (
.md) contenente il prompt di sistema dell'agente. Ad esempio:https://github.com/my-org/my-repo/blob/main/my-agent.md. Per GitHub Enterprise Server o GitHub Enterprise Cloud con residenza dei dati, utilizza invece l'URL dell'istanza. Ad esempio:https://github.example.com/my-org/my-repo/blob/main/my-agent.md. Se l'URL non termina con.md, viene visualizzato un avviso. L'importazione non riesce se il file non è Markdown.Competenze (opzionale): seleziona le competenze dal tuo Agent Space per fornire ulteriori conoscenze o funzionalità di dominio all'agente.
Scegli Import agent.
Il file del repository fornisce solo il prompt di sistema. Il nome e le competenze derivano dal modulo.
Dopo la creazione, si viene reindirizzati alla pagina dei dettagli dell'agente in cui è possibile visualizzare la configurazione, eseguire l'agente o impostare i trigger.
Visualizzazione degli agenti importati:
Un agente importato mostra un GitHub badge Synced from accanto al suo nome nella pagina dei dettagli dell'agente, insieme a un timestamp dell'ultima sincronizzazione e a un link al file sorgente su. GitHub Nell'elenco degli agenti personalizzati, gli agenti importati includono un collegamento al loro file sorgente.
Se si modifica un agente importato, il prompt di sistema visualizza un'Read-onlyetichetta con un suggerimento che si collega al file sorgente. Il nome e le competenze rimangono modificabili.
Sincronizzazione degli agenti importati:
Quando aggiorni il file Markdown nel tuo repository, apri la pagina dei dettagli dell'agente importato e scegli Sincronizza per visualizzare la richiesta di sistema più recente.
Vincoli:
Formato URL: sono accettati solo GitHub gli URL, inclusi GitHub Enterprise Server ed GitHub Enterprise Cloud con residenza dei dati. L' GitHub account connesso deve corrispondere all'host dell'URL. Ad esempio, una
github.example.comconnessione può importare solo dagligithub.example.comURL, non dagligithub.comURL.File Markdown obbligatorio: l'URL deve puntare a un singolo file.
.mdDimensione massima del file: il file non deve superare 1 MB (limite GitHub API).
GitHub account richiesto: il tuo Agent Space deve avere un GitHub account associato agli agenti di importazione. Per gli archivi privati, l'account deve avere accesso in lettura.
Agenti doganali della comunità
L'archivio AWS DevOps Agent Tools
Per utilizzare un agente personalizzato della community, importalo dal repository utilizzando il flusso Importa dal repository nella pagina Agenti. Copia l'URL del file Markdown dell'agente e incollalo come URL del repository. Per i dettagli, consulta Importazione di un agente personalizzato da un repository.
Scrittura di un prompt di sistema
Il prompt di sistema è la parte più importante del tuo agente personalizzato. Definisce lo scopo, l'approccio, i vincoli e il risultato previsto dell'agente. Un prompt ben scritto produce risultati coerenti e affidabili.
Strutturate il prompt di sistema con queste sezioni:
Obiettivo: cosa dovrebbe fare l'agente in una singola frase o in un breve paragrafo.
Approccio: Step-by-step procedure che l'agente deve seguire, facendo riferimento ai nomi specifici degli strumenti che deve chiamare e in quale ordine.
Vincoli: limiti su ciò che l'agente dovrebbe e non dovrebbe fare. Ad esempio, accesso in sola lettura, intervalli di tempo da considerare o servizi da escludere.
Output: cosa deve produrre l'agente e in quale formato. Specifica se deve generare testo, creare un artefatto o creare una raccomandazione.
Esempio di prompt di sistema:
You are a DevOps reporting agent specializing in summarizing investigation activity. ## Goal Generate a concise weekly report of all investigations from the past 7 days. ## Approach 1. Call `list_investigations` to fetch investigations from the last 7 days. 2. For each investigation, retrieve its title, status, root cause, and resolution time. 3. Group investigations by status and root cause category. 4. Identify trends: services most affected, average resolution time, recurring root causes. ## Constraints - Only include investigations from the past 7 days. - Read-only access — do not modify, close, or reassign investigations. ## Output Produce a single artifact titled "Weekly Investigation Report" containing: - A table listing each investigation with title, status, and resolution time. - A chart showing investigation counts by root cause category. - A summary paragraph with key trends and recommendations.
Suggerimenti per istruzioni di sistema efficaci:
Sii specifico sugli strumenti: fai riferimento direttamente ai nomi degli strumenti (ad esempio
list_investigations,use_aws,query_cloudwatch_logs) in modo che l'agente sappia quali strumenti chiamare.Definisci i criteri di successo: descrivi l'aspetto di un buon risultato in modo che l'agente sappia quando è finito.
Stabilisci dei limiti: indica esplicitamente cosa non deve fare l'agente per prevenire azioni indesiderate.
Usa la formattazione Markdown: intestazioni, elenchi e blocchi di codice semplificano l'analisi e la visualizzazione del prompt da parte dell'agente.
Strumenti di configurazione
Gli strumenti MCP determinano le azioni che l'agente personalizzato può eseguire durante l'invocazione. Puoi selezionare gli strumenti dal set completo disponibile nel tuo Agent Space, inclusi strumenti provenienti da AWS account connessi, piattaforme di osservabilità, CI/CD pipeline, sistemi di ticketing e server MCP personalizzati.
Gli strumenti possono essere configurati solo tramite Chat. Per assegnare gli strumenti durante la creazione di un agente, utilizza il metodo di creazione della chat. Per aggiungere o modificare strumenti su un agente esistente, chiedi a Chat di aggiornare l'agente. Ad esempio:
Add the query_cloudwatch_logs and use_aws tools to my weekly-health-report agent.
Update certificate-checker to also use the list_resources tool.
Remove the use_kubectl tool from cluster-audit-agent.
Quando selezioni gli strumenti, segui il principio del privilegio minimo: assegna solo gli strumenti di cui l'agente ha bisogno per svolgere il suo compito. Ciò riduce il rischio di azioni indesiderate e mantiene l'agente concentrato.
Strumenti di Release Manager
Gli agenti personalizzati hanno accesso agli strumenti di Release Manager. Questi strumenti consentono all'agente di creare, elencare, ottenere e annullare le attività di Release Manager. Il tuo agente può anche analizzare un rapporto di revisione della disponibilità al rilascio per evidenziare i risultati e le azioni consigliate.
Per utilizzare gli strumenti di Release Manager, assegnali al tuo agente personalizzato tramite Chat. Ad esempio:
Add the release manager tools to my release-pipeline-agent.
Per ulteriori informazioni sulle funzionalità di gestione delle versioni, consultaGestione dei rilasci.
Configurazione delle competenze
Le competenze forniscono all'agente personalizzato ulteriori conoscenze di dominio, procedure di indagine o funzionalità specializzate. Quando viene eseguito un agente personalizzato, carica le competenze assegnate e può fare riferimento alle relative istruzioni durante l'invocazione.
Puoi assegnare le competenze durante la creazione (utilizzando il modulo o la chat) o aggiungerle in un secondo momento modificando l'agente. Le competenze assegnate a un agente personalizzato devono già esistere nel tuo Agent Space. Per ulteriori informazioni sulla creazione di competenze, consultaDevOps Competenze degli agenti.
Gli agenti personalizzati dispongono inoltre di funzionalità integrate per la creazione di artefatti e consigli che non richiedono l'assegnazione di competenze. Per ulteriori informazioni, consulta Output agenti personalizzati.
Puoi assegnare fino a 200 competenze per agente personalizzato. Scegli competenze pertinenti allo scopo dell'agente per ridurre il consumo di contesto e migliorare la concentrazione dell'agente.
