Esercitazione: Creare un subagente nell'agente SRE di Azure

In questo tutorial, crei un sottoagente specializzato in Agent Canvas con le sue istruzioni, strumenti e competenze. 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:

  • Crea un sottoagente con istruzioni personalizzate in Agent Canvas
  • 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>Agent Canvas.

  3. Seleziona + Crea sottoagente.

    Il dialogo Crea un sottoagente si apre con due schede: Form e YAML.

  4. Compilare i campi obbligatori:

    Campo Valore di esempio
    Nome del sottoagente (richiesto) 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. (Opzionale) Configura i campi e le sezioni rimanenti nel dialogo.

    • Istruzioni di passaggio: Descrivi quando un altro agente dovrebbe delegare il lavoro a questo sottoagente.

    • Abilità: Attiva Abilita Abilità per permettere al subagente di usare le abilità. Sotto Abilità Consentite, lascia la selezione vuota per permettere tutte le abilità o seleziona le abilità specifiche che il subagente può utilizzare. Per altre informazioni, vedere Competenze.

    • Impostazioni avanzate:

      • Trasferimento di sottoagenti: Seleziona altri sottoagenti a cui questo sottoagente può delegare lavoro.
      • Strumenti: Seleziona Scegli strumenti, poi seleziona gli strumenti che il sottoagente può utilizzare. 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. Per la procedura di configurazione, vedere Creare e gestire hook nel portale. Per ulteriori informazioni, vedere Agent hooks.
      • Dare accesso alla knowledge base: attiva questa opzione per permettere al sottoagente di utilizzare i documenti nella knowledge base.

  6. Fare clic su Crea.

Il tuo subagente appare come un nodo su Agent Canvas con qualsiasi strumento connesso visualizzato.

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. Nella barra degli strumenti di Agent Canvas, seleziona il selettore della visualizzazione Test 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, apri la sua configurazione su Agent Canvas.

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