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
Puoi 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 generano 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, utilizza Chat dopo aver creato l'agente.
Per creare un agente personalizzato utilizzando il modulo:
Vai alla pagina Agenti nella tua app web DevOps Agent.
Nella sezione Agenti personalizzati, scegli Crea agente.
Nella finestra di dialogo, scegli Modulo.
Compila il modulo:
Nome: un identificatore 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 su come scrivere istruzioni efficaci, vedi Scrivere un prompt di sistema.
Competenze (facoltative): seleziona le competenze dal tuo Agent Space che forniscono all'agente conoscenze o funzionalità aggiuntive del dominio. Utilizza 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 dove 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 tramite Chat:
Vai alla pagina Agenti nella tua app web DevOps Agent.
Nella sezione Agenti personalizzati, scegli Crea agente.
Nella finestra di dialogo, scegli Chat. La finestra di dialogo si chiude e si apre una nuova conversazione nel pannello Chat con un messaggio precomposto.
La chat ti guida attraverso un processo collaborativo:
Chiarimento delle intenzioni: conferma lo scopo e l'ambito del tuo agente.
Controllo duplicato: verifica che non esista già un agente simile nel tuo Agent Space.
Selezione degli strumenti e delle competenze: propone gli strumenti e le competenze MCP di cui l'agente ha bisogno e chiede all'utente di confermare.
Tipo di output: determina se l'agente deve produrre risposte testuali, artefatti o consigli.
Bozza del prompt di sistema: scrive un prompt di sistema e lo presenta per la revisione. Puoi iterare 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. 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.
Scrivere un prompt di sistema
Il prompt di sistema è la parte più importante del tuo agente personalizzato. Definisce lo scopo, l'approccio, i vincoli e l'output previsto dell'agente. Un prompt ben scritto produce risultati coerenti e affidabili.
Strutturate il prompt di sistema con queste sezioni:
Obiettivo: ciò che l'agente dovrebbe realizzare in una singola frase o in un breve paragrafo.
Approccio: Step-by-step procedure che l'agente deve seguire, facendo riferimento ai nomi degli strumenti specifici 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. Specificate 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_investigationsuse_aws,query_cloudwatch_logs) in modo che l'agente sappia quali strumenti chiamare.Definisci i criteri di successo: descrivi come si presenta 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 comprensione del prompt da parte dell'agente.
Strumenti di configurazione
Gli strumenti MCP determinano le azioni che l'agente personalizzato può eseguire durante la chiamata. 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 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. 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'operatore concentrato.
Configurazione delle competenze
Le competenze forniscono al vostro agente personalizzato ulteriori conoscenze di dominio, procedure di indagine o capacità specializzate. Quando un agente personalizzato viene eseguito, carica le competenze assegnate e può fare riferimento alle relative istruzioni durante la chiamata.
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 le competenze pertinenti allo scopo dell'agente per ridurre il consumo del contesto e migliorare la concentrazione dell'agente.
