Agenti personalizzati nell'agente SRE di Azure

Gli agenti personalizzati sono agenti specializzati che vengono attivati su richiesta. Digitare /agent nella chat, selezionare il tuo specialista e fai la tua domanda. Questo processo consente di accedere a un esperto di database per problemi SQL e a un revisore della sicurezza per l'analisi delle minacce.

A differenza delle competenze (che sono sempre disponibili), gli agenti personalizzati richiedono chiamate esplicite. Questo requisito definisce l'ambito delle proprie competenze in attività specifiche.

Funzionamento degli agenti personalizzati

Richiamare un agente personalizzato usando il /agent comando slash nella chat. L'agente personalizzato riceve il contesto di conversazione completo e lavora con competenze incentrate.

L'esempio seguente mostra una definizione di agente personalizzato 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

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: quando si usa questa proprietà, l'agente personalizzato può accedere dinamicamente alle competenze.

Perché usare agenti personalizzati

Gli agenti personalizzati 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 agenti personalizzati, l'agente principale prova a risolvere i problemi generici. Con un agente personalizzato "Esperto di database", si ottengono competenze SQL incentrate, runbook specifici del database e strumenti ottimizzati per l'analisi delle query.

Gli agenti personalizzati abilitano anche catene di trasferimento. L'agente personalizzato per il triage degli incidenti classifica un problema, passa all'esperto di dominio appropriato, che indaga e passa a un router di notifica. Ogni passaggio è specializzato.

Creare un agente personalizzato

Creare agenti personalizzati in Builder > Agent Canvas.

1. Accedere all'agente SRE di Azure nel portale di Azure.

2. Selezionare la scheda Canvas dell'agente.

3. Fare clic su Crea.

4. Selezionare Agente personalizzato.

5. Specificare i valori per le impostazioni seguenti:

   Proprietà	Valore
   Nome	Immettere un nome descrittivo per l'agente personalizzato.
   Istruzioni	Fornire istruzioni chiare e personalizzate che definiscono il comportamento dell'agente personalizzato.
   Descrizione consegna	Spiegare gli scenari in cui altri agenti personalizzati devono trasferire l'elaborazione a questo agente personalizzato e perché.
   Strumenti personalizzati (facoltativo)	Scegliere uno o più strumenti personalizzati da usare per l'agente personalizzato durante le operazioni.
   Strumenti predefiniti (facoltativo)	Selezionare gli strumenti di sistema predefiniti a cui si vuole che l'agente personalizzato abbia accesso.
   Agenti di trasferimento (facoltativo)	Specificare l'agente personalizzato che deve assumere l'elaborazione dopo il completamento delle attività di questo agente personalizzato.

   Facoltativamente, è possibile abilitare la funzionalità Knowledge Base . Questa opzione consente di caricare file che l'agente personalizzato può usare come materiale di riferimento per rispondere alle query.

Gestione della Knowledge Base

Migliorare le conoscenze degli agenti personalizzati 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

1. Accedere alla Knowledge Base passando alla scheda Impostazioni > file della Knowledge Base>.
2. Caricare i file trascinando e rilasciando i file o esplorando per selezionare i file (massimo 50 MB per file).
3. Organizzare il contenuto aggiungendo tag e descrizioni per migliorare la ricerca.
4. Abilitare l'accesso dell'agente personalizzato configurando gli agenti personalizzati che possono accedere a origini di informazioni specifiche.
5. Monitorare l'utilizzo monitorando il modo in cui gli agenti personalizzati usano le informazioni caricate nelle risposte.

Visualizzazioni del canvas dell'agente

Creare agenti personalizzati in Builder>Agent Canvas. Sono disponibili le viste seguenti:

Quando usare agenti personalizzati

La tabella seguente consente di determinare quando gli agenti personalizzati sono la scelta giusta:

Per la configurazione completa dell'agente personalizzato, vedere Risposta agli eventi imprevisti per l'automazione delle risposte.

Trasferimento dell'agente personalizzato

Quando l'agente principale passa a un agente personalizzato, i due condividono un unico contesto di conversazione. L'agente doganale ricevente vede:

• Cronologia completa della conversazione: tutti i messaggi precedenti, le chiamate agli strumenti e i risultati.
• Ragionamento della sottoattività: ciò che l'handoff chiede a questo agente personalizzato di realizzare.
• Domanda originale dell'utente: preservata lungo l'intera catena di trasferimento.

Dopo aver completato il lavoro, l'agente personalizzato passa all'agente successivo o restituisce il controllo all'orchestratore. Il contesto della conversazione continua ad accumularsi in tutta la catena.

Modelli di agente personalizzati

La tabella seguente descrive i modelli comuni dell'agente personalizzato:

Confrontare competenze, agenti personalizzati e file di conoscenza

La tabella seguente confronta ogni concetto di estendibilità:

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)
• Agente personalizzato: specialista con ambito richiamato su richiesta (PostgreSQL Expert)
• File di informazioni: contenuto di riferimento per il contesto (documentazione dell'architettura)

Connettere agenti personalizzati ai trigger

Gli eventi imprevisti o le attività pianificate possono attivare automaticamente agenti personalizzati. La visualizzazione canvas mostra visivamente queste connessioni: i trigger vengono visualizzati come nodi connessi agli agenti personalizzati, gli strumenti vengono raggruppati con l'agente personalizzato 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 agenti personalizzati a eventi imprevisti o attività pianificate per l'automazione ricorrente.

Modalità agente personalizzate

Ogni agente personalizzato viene eseguito in una modalità che controlla la quantità di autonomia di cui dispone. Impostare la modalità per ogni piano di risposta o attività pianificata.

Scegliere la modalità in base al rischio:

• Consigli per l'ottimizzazione dei costi? Usare verifica (richiesta di approvazione umana).
• Automazione ben testata? Usare autonomo (per le operazioni attendibili).

Configurare le modalità per ogni piano di risposta o attività pianificata. Non impostare le modalità nella definizione YAML dell'agente personalizzato. Per altre informazioni, vedere Modalità di esecuzione.

Testare e sviluppare agenti personalizzati

Testare gli agenti personalizzati nel sito di test prima della distribuzione. Passare a Builder>Agent Canvas e selezionare Test playground dall'opzione di cambio 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 dell'agente personalizzato nell'editor sincronizzando le modifiche con l'agente.

Per informazioni dettagliate, vedere Agent Playground.

Contenuti correlati