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 immediatamente un agente personalizzato dalla pagina dei dettagli dell'agente o tramite chat.

Per eseguire un agente personalizzato dalla pagina dei dettagli:

1. Vai alla pagina Agenti nella tua app web DevOps Agent.

2. Scegli l'agente personalizzato che desideri eseguire.

3. Scegli Esegui ora per eseguire l'agente con le istruzioni configurate.

Per fornire un contesto aggiuntivo per un'esecuzione specifica, scegli la freccia del menu a discesa accanto a Esegui ora, inserisci un prompt che descrive su cosa l'agente dovrebbe concentrarsi 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 tramite Chat:

Chiedi a Chat di eseguire l'agente per nome. 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 passa come prompt 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 iniziarne un'altra.

Pianificazione degli agenti personalizzati

I trigger consentono di eseguire automaticamente un agente personalizzato in base a condizioni definite. AWS DevOps L'agente attualmente supporta i trigger basati sulla pianificazione, che eseguono l'agente a intervalli ricorrenti utilizzando espressioni cron o rate. EventBridge-compatible

Per creare un trigger di pianificazione:

1. Vai alla pagina Agenti nella tua app web DevOps Agent.

2. Scegli l'agente personalizzato che desideri pianificare.

3. Selezionare la scheda Triggers (Trigger).

4. Scegli il pulsante + (crea).

5. Nella finestra di dialogo, inserisci un'espressione di pianificazione nel campo di immissione. L'espressione deve avere uno dei seguenti formati:

   • Espressione della frequenza: viene eseguita a intervalli fissi. Formato:rate(value unit). Esempi:

     • rate(1 hour)— Ogni ora

     • rate(30 minutes)— Ogni 30 minuti

     • rate(7 days)— Ogni 7 giorni

   • Espressione Cron: viene eseguita secondo 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 UTC

     • cron(0 0 1 * ? *)— Primo giorno di ogni mese a mezzanotte UTC

     • cron(0 */6 ? * * *)— Ogni 6 ore

Quando l'espressione è valida, viene visualizzato un messaggio di conferma verde.

1. Scegli Create (Crea).

Per le espressioni cron, deve essere esattamente uno dei giorni del mese o della settimana (punto interrogativo). ? Per ulteriori informazioni sulla sintassi delle espressioni di pianificazione, consulta i tipi di pianificazione nella Amazon EventBridge Scheduler User Guide.

Dopo la creazione, il trigger viene visualizzato nell'elenco che mostra l'espressione, la data di creazione e la successiva esecuzione pianificata.

Gestione dei trigger

La scheda Trigger mostra tutti i trigger configurati per l'agente personalizzato. Per ogni trigger, puoi vedere l'espressione di pianificazione, quando è stata creata e quando verrà eseguita la prossima volta.

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 «Sospeso» e non si attiva più finché non viene riattivato. Riattiva l'interruttore per riprendere la pianificazione.

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 una chiamata in esecuzione dalla vista della traiettoria:

1. Dalla scheda Cronologia, scegliete la chiamata in esecuzione.

2. 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 di chiamata cambia in «Annullata». Qualsiasi lavoro completato prima dell'annullamento viene mantenuto nella traiettoria. Le chiamate agli strumenti che erano in corso al momento dell'annullamento potrebbero ancora essere completate.

Risultati della chiamata 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 invocazione.

I risultati della chiamata allo strumento forniscono trasparenza su ciò che l'agente ha fatto durante la chiamata:

• Chiamate dello strumento riuscite: lo strumento ha restituito i dati utilizzati dall'agente per continuare il suo lavoro. Ad esempio, query_cloudwatch_logs restituisce le voci di registro o use_aws restituisce 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 agli strumenti e i relativi risultati nella traiettoria di invocazione per comprendere il comportamento dell'agente, verificare che abbia avuto accesso alle risorse corrette e risolvere i problemi relativi a risultati imprevisti. Per ulteriori informazioni sulla visualizzazione delle traiettorie, vedere Visualizzazione di una traiettoria di chiamata.