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à.
Esecuzione di agenti personalizzati
È possibile eseguire un agente personalizzato su richiesta o configurare i trigger per eseguirlo automaticamente.
Esecuzione di un agente personalizzato su richiesta
Puoi eseguire un agente personalizzato immediatamente dalla pagina dei dettagli dell'agente o tramite Chat.
Per eseguire un agente personalizzato dalla pagina dei dettagli:
Accedi alla pagina Agenti nella tua app web per DevOps agenti.
Scegli l'agente personalizzato che desideri eseguire.
Scegliete Esegui ora per eseguire l'agente con le relative istruzioni configurate.
Per fornire un contesto aggiuntivo per un'esecuzione specifica, scegli la freccia a discesa accanto a Esegui ora, inserisci un prompt che descriva su cosa deve concentrarsi l'agente in questa chiamata e scegli Esegui con prompt. Il prompt viene passato all'agente come contesto aggiuntivo insieme al prompt di sistema.
Dopo l'avvio dell'esecuzione, la nuova chiamata viene visualizzata nella scheda Cronologia con lo stato «Avvio in sospeso». Scegli l'invocazione per visualizzarne la traiettoria in tempo reale.
Per eseguire un agente personalizzato utilizzando Chat:
Chiedi a Chat di eseguire l'agente per nome. Ad esempio:
Run my weekly-investigation-report agent.
Run certificate-checker and focus on certificates expiring in the next 7 days.
Quando fornisci un contesto aggiuntivo nel messaggio di chat, Chat lo trasmette come richiesta per l'esecuzione. Se non fornisci un contesto aggiuntivo, l'agente viene eseguito solo con il prompt di sistema configurato.
Un agente personalizzato può eseguire solo una chiamata alla volta. Se l'agente è già in esecuzione, è necessario attendere il completamento della chiamata corrente, il timeout o l'annullamento prima di avviarne un'altra.
Configurazione dei trigger di
I trigger eseguono automaticamente un agente personalizzato in base a condizioni definite. AWS DevOps L'agente supporta due tipi di trigger:
Pianifica i trigger: esegue l'agente a intervalli ricorrenti utilizzando EventBridge-compatible espressioni cron o rate.
Trigger di eventi: esegue l'agente quando arriva un evento webhook da un'integrazione connessa, passando il payload dell'evento come contesto.
Entrambi i tipi di trigger vengono creati dalla scheda Triggers dell'agente personalizzato. Per aprirlo, accedi alla pagina Agenti nella tua app web DevOps Agent, scegli l'agente personalizzato, quindi scegli la scheda Trigger.
Creazione di un trigger di pianificazione
Le espressioni di pianificazione utilizzano la sintassi EventBridge-compatible cron o rate. L'espressione deve essere in uno dei seguenti formati:
Espressione di frequenza: viene eseguita a intervalli fissi. Formato:
rate(value unit). Esempi:rate(1 hour)— Ogni orarate(30 minutes)— Ogni 30 minutirate(7 days)— Ogni 7 giorni
Espressione Cron: viene eseguita in base a una pianificazione specifica. Formato:
cron(minutes hours day-of-month month day-of-week year). Esempi:cron(0 9 ? * MON-FRI *)— Tutti i giorni feriali alle 9:00 UTCcron(0 0 1 * ? *)— Il primo giorno di ogni mese a mezzanotte UTCcron(0 */6 ? * * *)— Ogni 6 ore
Per le espressioni cron, deve essere indicato esattamente il giorno del mese o il giorno della settimana (punto interrogativo). ? Per ulteriori informazioni sulla sintassi delle espressioni di pianificazione, consulta i tipi di pianificazione nella Amazon Scheduler User Guide. EventBridge
Per creare un trigger di pianificazione:
Scegli il pulsante + (crea).
Per il tipo di trigger, scegli Pianificazione.
Inserisci un'espressione di pianificazione. Quando l'espressione è valida, viene visualizzato un messaggio di conferma verde.
(Facoltativo) Per fornire un contesto aggiuntivo per ogni esecuzione pianificata, inserisci un prompt nel campo Richiesta utente (opzionale). Il prompt viene passato all'agente insieme al prompt del sistema.
Scegli Crea.
Dopo la creazione, il trigger viene visualizzato nell'elenco con l'espressione, la data di creazione e l'ora di esecuzione successiva pianificata.
Creazione di un trigger di evento
Un trigger di evento esegue l'agente personalizzato quando arriva un evento webhook da un'integrazione connessa. Il payload dell'evento viene passato all'agente come contesto per l'esecuzione.
Prerequisiti:
Prima di creare un trigger di evento, è necessario disporre di un'integrazione connessa con un webhook attivo nello spazio dell'agente. Qualsiasi integrazione con un webhook attivo può fungere da fonte di eventi. Per ulteriori informazioni sulla configurazione di integrazioni, consulta Richiamo DevOps dell'agente tramite Webhook.
Per creare un trigger di evento:
Scegli il pulsante + (crea).
Per il tipo di trigger, scegli Evento.
Per Event source, scegli l'integrazione i cui eventi webhook devono eseguire l'agente. Sono elencate solo le integrazioni con un webhook attivo.
(Facoltativo) Per l'espressione Filter, inserisci un'espressione JMESPath per filtrare e, facoltativamente, trasformare il payload dell'evento.
Scegli Crea.
Se non è elencata alcuna origine di eventi, significa che non esiste alcuna integrazione abilitata per il webhook nello spazio degli agenti oppure al tuo ruolo mancano le autorizzazioni and. ListAssociations ListWebhooks
Espressioni di filtro:
È possibile specificare facoltativamente un'espressione di filtro JMESPath per controllare quali eventi avviano l'agente e quale contesto riceve l'agente. Le espressioni di filtro vengono valutate rispetto alla radice del payload degli eventi non elaborati.
Sintassi: specifica JMESPath
Lunghezza massima: 4.096 caratteri
Convalida: le espressioni non valide vengono rifiutate quando si crea il trigger
L'espressione del filtro funge sia da condizione che, facoltativamente, da proiezione:
Quando il risultato non
nullè una stringa vuota, un array vuoto o un oggetto vuoto, il trigger viene eseguito.falseQuando il risultato è booleano
true(ad esempio, un predicato simileseverity == 'critical'), l'agente riceve il payload dell'evento non elaborato come contesto.Quando il risultato è un qualsiasi altro valore veritiero (ad esempio, una proiezione simile
{sev: severity}), l'agente riceve il risultato proiettato come contesto.
AWS DevOps L'agente tronca questo contesto a 10.000 caratteri.
Se si lascia vuota l'espressione del filtro, l'agente viene eseguito su tutti gli eventi di tale origine e riceve il payload dell'evento non elaborato come contesto.
Nota
Una proiezione che restituisce un oggetto vuoto o un array vuoto viene conteggiata come nessuna corrispondenza e l'agente non viene eseguito. Per passare un valore possibilmente vuoto, racchiudetelo in un oggetto letterale. Ad esempio, {payload: details}.
Esempi di espressioni di filtro:
severity == 'critical'— Predicato: esegue l'agente solo quando la gravità è uguale a critica, passando il payload dell'evento non elaborato come contesto.{sev: severity}— Proiezione: esegue l'agente su ogni evento, passando come contesto un oggetto contenente solo il campo di gravità. Poiché un hash a selezione multipla include sempre le sue chiavi, il risultato non è mai vuoto e non viene filtrato.
Poiché la forma del payload è diversa per ogni fonte, i campi disponibili dipendono dall'integrazione. Quando arriva un evento ma non viene eseguito un trigger, l' AWS DevOps agente emette un avviso che ne descrive il motivo. Ad esempio, l'avviso potrebbe indicare che l'espressione del filtro non corrisponde a nulla. L'avviso elenca anche i campi di primo livello presenti in quel payload. Per ulteriori informazioni, consulta Registri e metriche venduti.
Creazione di trigger a livello di codice
Puoi anche creare trigger a livello di codice utilizzando gli SDK. AWS Chiama l'CreateTriggeroperazione del devops-agent cliente, che richiede l'autorizzazione. aidevops:CreateTrigger Imposta il tipo di trigger TIME_BASED e fornisci una condizione di pianificazione contenente l'espressione di pianificazione e il prompt utente opzionale.
In alternativa, puoi modellare i trigger basati sulla pianificazione come risorse inAWS::DevOpsAgent::Trigger. AWS CloudFormation Un trigger fa riferimento all'agente personalizzato che esegue, quindi crea prima l'agente. Per ulteriori informazioni sul tipo di AWS::DevOpsAgent::Trigger risorsa, vedereGestione delle risorse.
Gestione dei trigger
La scheda Trigger mostra tutti i trigger configurati per l'agente personalizzato. Un trigger di pianificazione mostra la relativa espressione di pianificazione. Un trigger di evento mostra l'origine dell'evento e, se impostata, la relativa espressione di filtro. Entrambi i tipi mostrano la data di creazione.
Se l'integrazione del codice sorgente o il relativo webhook vengono rimossi, un trigger di evento rimane elencato ma mostra che il sorgente non è più disponibile e non viene eseguito.
Mettere in pausa un trigger:
Per impedire temporaneamente a un trigger di richiamare l'agente senza eliminarlo, disattiva l'interruttore a levetta accanto al trigger. Lo stato del trigger cambia in Pausa e non viene più eseguito finché non viene riattivato. Riattiva l'interruttore per riprendere.
Eliminazione di un trigger:
Per rimuovere definitivamente un trigger, scegli l'icona di eliminazione (cestino) accanto al trigger che desideri rimuovere. Conferma l'eliminazione nella finestra di dialogo che appare. I trigger eliminati non possono essere recuperati.
Annullamento di una chiamata
È possibile annullare una chiamata in corso dalla visualizzazione della traiettoria di chiamata o tramite Chat.
Per annullare un'invocazione in corso dalla vista della traiettoria:
Dalla scheda Cronologia, scegli l'invocazione in esecuzione.
Scegliete Annulla nella parte superiore della vista della traiettoria.
Per annullare una chiamata in corso utilizzando Chat:
Cancel the running invocation of weekly-health-report.
Lo stato della chiamata cambia in «Annullato». Qualsiasi lavoro completato prima dell'annullamento viene mantenuto nella traiettoria. Le chiamate allo strumento in corso al momento dell'annullamento possono ancora essere completate.
Risultati delle chiamate allo strumento
Durante la chiamata, l'agente personalizzato richiama gli strumenti MCP per raccogliere dati, eseguire azioni e produrre output. Ogni chiamata allo strumento e il relativo risultato vengono registrati nella traiettoria di chiamata.
I risultati delle chiamate allo strumento forniscono trasparenza su ciò che l'agente ha fatto durante l'invocazione:
Chiamate effettuate correttamente: lo strumento ha restituito i dati che l'agente utilizza per continuare il suo lavoro. Ad esempio,
query_cloudwatch_logsrestituisce le voci del registro ouse_awsrestituisce le risposte API.Chiamate allo strumento non riuscite: lo strumento ha restituito un errore. L'agente può riprovare, provare un approccio alternativo o segnalare l'errore nell'output.
È possibile esaminare le singole chiamate allo strumento e i relativi risultati lungo la traiettoria di chiamata per comprendere il comportamento dell'agente, verificare che abbia effettuato l'accesso alle risorse corrette e risolvere i problemi relativi ai risultati imprevisti. Per ulteriori informazioni sulla visualizzazione delle traiettorie, vedere Visualizzazione di una traiettoria di chiamata. Gestione degli agenti personalizzati
