Nota
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare ad accedere o modificare le directory.
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare a modificare le directory.
I subagenti sono agenti specializzati che si richiamano su richiesta. Digitare /agent nella chat, selezionare il tuo specialista e fai la tua domanda. Ad esempio, è possibile richiamare un esperto di database per problemi SQL o un revisore della sicurezza per l'analisi delle minacce.
A differenza delle competenze (che sono sempre disponibili), i subagenti richiedono chiamate esplicite. Questo requisito definisce l'ambito delle proprie competenze in attività specifiche.
Funzionamento dei subagenti
Richiamare un subagent usando il /agent comando slash nella chat. L'agente secondario riceve il contesto di conversazione completo e lavora con competenze incentrate.
L'esempio seguente illustra una definizione di subagente di base:
name: database_expert
system_prompt: |
You are a database specialist. Analyze query performance,
diagnose connection issues, and recommend optimizations.
handoff_description: Handles SQL and database troubleshooting
tools:
- execute_kusto_query
- azure_cli
connectors:
- azure_sql
enable_skills: true # Can use skills for additional expertise
agent_type: Review # ReadOnly | Review | Autonomous
Le proprietà chiave includono:
-
system_prompt: il profilo esperto e le istruzioni. -
handoff_description: cosa vede l'orchestratore quando decide di delegare. -
tools: funzionalità disponibili. -
enable_skills: consente a questo subagente di accedere dinamicamente alle competenze. -
agent_type: controlla le azioni (ReadOnly, Review, Autonomous).
Suggerimento
Le competenze sono automatiche: l'agente le usa ogni volta che sono rilevanti.
I subagenti sono espliciti: è possibile richiamarli usando /agent quando è necessaria un'esperienza mirata.
Perché usare subagenti
I subagenti consentono di creare pacchetti di competenze, strumenti e conoscenze del dominio per il riutilizzo. Invece dell'agente principale che cerca di gestire tutto, delega agli specialisti.
Si consideri un problema del database: senza subagenti, l'agente principale prova a risolvere i problemi generici. Con un sottoagente "Esperto di database", si ottengono competenze SQL incentrate, runbook specifici del database e strumenti ottimizzati per l'analisi delle query.
Le sottoagenti abilitano anche le catene di consegna. Il subagente di valutazione degli eventi imprevisti classifica un problema e passa all'esperto di dominio appropriato. L'esperto di dominio indaga e passa il controllo a un router di notifica. Ogni passaggio è specializzato.
Creare un subagente
Creare subagenti in Costruttore di sottoagenti > Subagent builder.
Accedere all'agente SRE di Azure nel portale di Azure.
Selezionare la scheda Generatore di subagenti .
Fare clic su Crea.
Selezionare Subagent.
Specificare i valori per le impostazioni seguenti:
Proprietà Valore Nome Immettere un nome descrittivo per il subagente. Istruzioni Fornire istruzioni chiare e personalizzate che definiscono il comportamento del subagente. Descrizione consegna Spiegare gli scenari in cui altri subagenti devono trasferire l'elaborazione a questo subagente e perché. Strumenti personalizzati (facoltativo) Scegliere uno o più strumenti personalizzati per il subagente da usare durante le operazioni. Strumenti predefiniti (facoltativo) Selezionare tutti gli strumenti di sistema predefiniti a cui si vuole che il subagente abbia accesso. Agenti di trasferimento (facoltativo) Specificare quale subagente deve assumere l'elaborazione dopo il completamento delle attività da parte di questo subagente. Facoltativamente, è possibile abilitare la funzionalità Knowledge Base . Questa opzione consente di caricare file che il subagente può usare come materiale di riferimento per rispondere alle query.
Gestione della Knowledge Base
Migliorare le conoscenze dei subagenti caricando documentazione, runbook e guide procedurali.
Esempi di file che è possibile aggiungere all'agente:
- Architettura o progettazione del sistema: diagrammi e documentazione che illustrano i componenti di sistema e i flussi di dati.
- Guide alla risoluzione dei problemi: istruzioni dettagliate per diagnosticare e risolvere problemi comuni o ricorrenti.
- Runbook e SOP: flussi di lavoro dettagliati per operazioni di routine, manutenzione e risposta agli eventi imprevisti.
- Report e postmortem degli incidenti: Documentazione delle interruzioni precedenti, inclusi l'analisi della causa principale e le lezioni apprese.
- Note sulla versione e log delle modifiche: riepiloghi degli aggiornamenti del prodotto o del servizio, incluse nuove funzionalità, correzioni di bug e modifiche.
Tipi di file supportati
Procedure operative in formato Markdown (.md) o testo (.txt).
Flusso di lavoro di gestione dei file
- Accedere alla Knowledge Base passando alla scheda Impostazioni > file della Knowledge Base>.
- Caricare i file trascinando e rilasciando i file o esplorando per selezionare i file (massimo 50 MB per file).
- Organizzare il contenuto aggiungendo tag e descrizioni per migliorare la ricerca.
- Abilitare l'accesso al subagente configurando quali subagenti possono accedere a specifiche origini conoscenze.
- Monitorare l'utilizzo monitorando il modo in cui i subagenti usano le informazioni caricate nelle risposte.
Annotazioni
I file caricati vengono indicizzati automaticamente e resi ricercabili dai subagenti. Il sistema supporta fino a 1.000 file per ogni istanza del subagente.
Visualizzazioni del generatore di subagenti
Compilare i sottoagenti in Creatore di sottoagenti. Sono disponibili le viste seguenti:
| Visualizza | Scopo |
|---|---|
| Vista canvas | Diagramma visivo che mostra subagenti, strumenti e connessioni trigger |
| Vista tabella | Elenco di tutti i subagenti con accesso rapido |
| Parco giochi di test | Ambiente di test interattivo |
Quando usare subagenti
La tabella seguente consente di determinare quando i subagenti sono la scelta giusta:
| Scenario | Usare un sotto-agente? | Perché |
|---|---|---|
| Competenze di dominio approfondite necessarie | Sì | Competenze in SQL, conoscenze di rete, migliori pratiche per la sicurezza |
| Flussi di lavoro in più passaggi | Sì | Valutazione degli eventi imprevisti, convalida della distribuzione, verifica del backup |
| Set di strumenti specializzati | Sì | Strumenti specifici del database, strumenti di ottimizzazione dei costi |
| Semplici operazioni singole | No | Usare invece le competenze per azioni semplici e ripetibili |
| Query di sola lettura | No | L'agente principale può gestire senza delega |
Per la configurazione completa del subagent, vedere Risposta agli eventi imprevisti per l'automazione delle risposte.
Passaggio del subagente
Quando l'agente principale passa a un subagente, condividono un singolo contesto di conversazione. Il subagente ricevente vede:
- Cronologia completa della conversazione: tutti i messaggi precedenti, le chiamate agli strumenti e i risultati
- Ragionamento della sottoattività: che cosa chiede a questo subagente di eseguire
- Domanda originale dell'utente: preservata in tutta la catena di passaggio
Annotazioni
I subagenti non ripartono da zero. Continuano lo stesso thread di conversazione. Questo approccio consente catene di consegna in cui ogni specialista si basa sul lavoro dell'agente precedente.
Dopo aver completato il lavoro, il subagente passa all'agente successivo o restituisce il controllo all'agente di orchestrazione. Il contesto della conversazione continua ad accumularsi in tutta la catena.
Modelli di subagente
La tabella seguente descrive i modelli comuni di subagente:
| Modello | Sottoagenti di esempio | caso d'uso |
|---|---|---|
| Esperto di dominio | Esperto di VM, Esperto di AKS, Esperto di rete | Esperienza approfondita in una sola tecnologia (tutti i problemi delle macchine virtuali, la risoluzione dei problemi di Kubernetes, la rete virtuale/il gruppo di sicurezza di rete/bilanciamento del carico) |
| Specialista attività | Analizzatore log, Ottimizzazione costi, Scanner di sicurezza | Incentrato su attività specifiche (analizzare i log, trovare risparmi, identificare le vulnerabilità) |
| Esecutore del flusso di lavoro | Triage degli incidenti, Validatore di distribuzione, Verificatore di backup | Procedure in più passaggi (classificare eventi imprevisti, controlli post-distribuzione, integrità del backup di test) |
Confrontare competenze, subagenti e file di conoscenza
La tabella seguente confronta ogni concetto di estendibilità:
| Feature | Competenze | Subagenti | File di conoscenza |
|---|---|---|---|
| Access | Automatico |
/agent comando |
Tramite lo strumento di query KB |
| Strumenti | Può allegare | Dispone di strumenti | Nessun strumento |
| Contesto | Usa il contesto del thread | Condivide il contesto del thread | Solo riferimento |
| migliore per | Procedures | Specialisti del dominio | Runbook, documentazione |
Usare le indicazioni seguenti per scegliere l'approccio corretto:
- Competenza: procedura a livello di team con esecuzione facoltativa (Guida alla risoluzione dei problemi del servizio Azure Kubernetes + interfaccia della riga di comando di Azure)
- Subagent: specialista con ambito richiamato su richiesta (PostgreSQL Expert)
- File di informazioni: contenuto di riferimento per il contesto (documentazione dell'architettura)
Connettere i subagenti ai trigger
Gli eventi imprevisti o le attività pianificate possono attivare automaticamente subagenti. La visualizzazione canvas mostra visivamente queste connessioni: i trigger vengono visualizzati come nodi connessi ai subagenti, gli strumenti vengono raggruppati con il sottoagente padre e i badge di stato mostrano lo stato attivo o inattivo.
Per informazioni dettagliate sulla configurazione, vedere Risposta agli eventi imprevisti per la connessione di subagenti a eventi imprevisti o attività pianificate per l'automazione ricorrente.
Modalità subagent
Ogni subagente può operare in una modalità diversa a seconda del livello di autonomia che si vuole concedere.
| Modalità | Descrizione |
|---|---|
| Sola lettura | Può esclusivamente eseguire query e analizzare, senza eseguire azioni. |
| Esamina | Propone azioni, attende l'approvazione |
| Autonoma | Atti senza approvazione umana |
Impostare la modalità in base al livello di rischio del subagente:
- Analisi dei log? ReadOnly (più sicuro)
- Consigli per l'ottimizzazione dei costi? Revisione (richiesta di approvazione umana)
- Automazione ben testata? Autonomo (per operazioni attendibili)
Testare e sviluppare subagenti
Testare i subagenti nel playground di test prima della distribuzione. Passare a Generatore Subagente > e selezionare Test playground dal commutatore di vista. Il layout dello schermo diviso consente di modificare le istruzioni a sinistra e di testare in una chat live a destra, con la valutazione basata sull'intelligenza artificiale per assegnare punteggi alla configurazione.
Per gli utenti di VS Code, l'estensione server MCP dell'agente SRE consente di modificare YAML del sottoagente nell'editor con modifiche sincronizzate con l'agente.
Per informazioni dettagliate, vedere Agent Playground.