Esercitazione: Creare un subagente nell'agente SRE di Azure

In questa esercitazione viene creato un subagente specializzato nel generatore di subagent con istruzioni, strumenti e competenze specifici. I subagenti gestiscono attività incentrate come la reportistica sulla salute, lo smistamento degli avvisi o il recapito delle notifiche. Per altre informazioni sul funzionamento dei subagenti, vedere Subagenti.

Tempo stimato: 5 minuti

In questa esercitazione apprenderai a:

  • Creare un subagent con istruzioni personalizzate nel generatore di subagent
  • Assegna competenze, strumenti e "hook" al subagent
  • Testare il subagente nella finestra di dialogo e nel playground
  • Modificare e gestire la configurazione del subagente usando il modulo o YAML

Prerequisiti

  • Agente creato nel portale dell'agente SRE di Azure.
  • Almeno un connettore configurato, se si vuole che il sottoagente usi strumenti esterni.

Creare un subagente

Seguire questa procedura per creare un nuovo sottoagente dal portale.

  1. Aprire il portale dell'agente SRE e selezionare l'agente.

  2. Selezionare Builder>Builder subagente.

  3. Selezionare l'elenco a discesa Crea sulla barra degli strumenti e quindi selezionare Agente personalizzato.

    Viene visualizzata la finestra di dialogo di creazione con due schede: Modulo e YAML.

  4. Compilare i campi obbligatori:

    Campo Valore di esempio
    Nome agente personalizzato (obbligatorio) health-check-reporter
    Istruzioni (obbligatorio) "Riferisci sui controlli di integrità. Controllare l'integrità delle risorse di Azure per le applicazioni container nel gruppo delle risorse di produzione. Riepilogare i conteggi integri, di avviso e critici. Invia il riepilogo tramite posta elettronica."

    Suggerimento

    Selezionare Affina con intelligenza artificiale sopra il campo delle istruzioni per consentire all'agente di migliorare automaticamente le istruzioni. Selezionare Visualizza suggerimenti di intelligenza artificiale per visualizzare le raccomandazioni per migliorare istruzioni, strumenti e competenze.

  5. (Facoltativo) Configurare le sezioni rimanenti nella finestra di dialogo. Se si ignorano queste sezioni, il subagent eredita tutte le competenze e gli strumenti globali per impostazione predefinita.

    • Competenze: selezionare Scegli competenze per assegnare competenze specifiche al subagente. La selezione di competenze specifiche sostituisce le impostazioni predefinite globali. Lasciare vuota la selezione per consentire tutte le competenze globali. Per altre informazioni, vedere Competenze.

    • Strumenti: selezionare Scegli strumenti per aprire il pannello di selezione degli strumenti. Esplorare o cercare gli strumenti organizzati per categoria (ad esempio, strumenti Kusto o strumenti di notifica). Selezionare gli strumenti da usare per il subagente. Per creare prima strumenti personalizzati, vedere Creare uno strumento Kusto o Creare uno strumento Python. Per altre informazioni, vedere Strumenti.

    • Hook: selezionare Gestisci Hook per aggiungere controlli di sicurezza e di governance. Gli hook vengono eseguiti prima delle azioni (hook prompt) o dopo l'uso dello strumento (hook comandi). Per la procedura di configurazione, vedere Creare e gestire hook nel portale. Per ulteriori informazioni, vedere Agent hooks.

  6. Fare clic su Crea.

Il sottoagente viene visualizzato come nodo nell'area di disegno del generatore di subagent con tutti gli strumenti connessi visualizzati.

Suggerimento

Prima di assegnare gli strumenti, testarli singolarmente nel playground di test per assicurarsi che restituiscano i dati previsti.

Testare il subagente

Dopo aver creato il sottoagente, testarlo per verificarne il comportamento previsto.

Eseguire il test dalla finestra di dialogo

Nella finestra di dialogo Crea o modifica, selezionare l'icona del test nell'angolo in alto a destra per aprire il pannello Test agente live. Digitare un prompt e vedere in che modo il subagente risponde con le istruzioni e gli strumenti correnti.

Test nell'area giochi

Usa il playground per un'esperienza di test interattiva con un layout a schermo diviso.

  1. Sulla barra degli strumenti del builder di subagenti, selezionare l'interruttore di visualizzazione Testa playground.
  2. Il layout dello schermo diviso mostra la configurazione del sottoagente su un lato e una chat live sull'altra.
  3. Selezionare il sottoagente, digitare una richiesta di test e verificare che si comporti come previsto.
  4. Iterare modificando le istruzioni o scambiando gli strumenti, quindi ripetere il test finché l'output non corrisponde alle aspettative.

Per altre informazioni, vedere Agent playground o Testare uno strumento nel playground.

Modificare un sottoagente

Per modificare un sottoagente esistente, aprire la configurazione nell'area di disegno del generatore di subagent.

Selezionare il nodo subagente e quindi selezionare Modifica (o fare doppio clic sul nodo). Viene visualizzata la finestra di dialogo di modifica con tutti i valori correnti prepopolati.

Cosa modificare Campo da aggiornare
Funzionamento Istruzioni
Quali competenze usa Abilità> Scegliere le competenze
Quali strumenti usa Strumenti> Scegliere gli strumenti
Controlli di sicurezza Hook> Gestire gli hook

Al termine, selezionare Salva .

Modifica con YAML

È possibile visualizzare o modificare la configurazione del sottoagente come YAML per copiare le configurazioni o gestire la configurazione come codice.

Selezionare la scheda YAML nella parte superiore della finestra di dialogo crea o modifica per passare alla modalità YAML. Le modifiche apportate alla modalità YAML vengono sincronizzate di nuovo nella visualizzazione modulo.

Passo successivo

Informazioni sui subagenti

Contenuti correlati

  • Last updated on