View a markdown version of this page

Esecuzione di agenti personalizzati - AWS DevOps Agente
Esecuzione di un agente personalizzato su richiestaPianificazione degli agenti personalizzatiGestione dei triggerAnnullamento di una chiamataRisultati delle chiamate allo strumento

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:

  1. Accedi alla pagina Agenti nella tua app web per DevOps agenti.

  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 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.

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. Accedi alla pagina Agenti nella tua app web per DevOps agenti.

  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 essere uno dei seguenti formati:

    • Espressione di 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 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 UTC

      • cron(0 0 1 * ? *)— Il 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 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

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

È inoltre possibile creare trigger a livello di programmazione. Usa gli AWS SDK per richiamare l'CreateTriggeroperazione del devops-agent client, che richiede l'autorizzazione. aidevops:CreateTrigger In alternativa, il modello si attiva come AWS::DevOpsAgent::Trigger risorse in. AWS CloudFormation Un trigger basato sulla pianificazione fa riferimento all'agente personalizzato che esegue, quindi crea prima l'agente. Per ulteriori informazioni sul tipo di AWS::DevOpsAgent::Trigger risorsa, vedere. Gestione delle risorse

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 «Pausa» 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 un'invocazione in corso dalla vista della traiettoria:

  1. Dalla scheda Cronologia, scegli l'invocazione 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 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_logs restituisce le voci del 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 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