Compilare un agente da zero usando il generatore di agenti

Importante

Alcune informazioni in questo articolo fanno riferimento alle caratteristiche di un prodotto prima del rilascio, che possono essere modificate sostanzialmente prima della distribuzione al pubblico. Microsoft non fornisce alcuna garanzia, esplicita o implicita, in relazione alle informazioni contenute in questo documento.

È possibile creare agenti personalizzati in modo rapido e intuitivo con la nuova esperienza basata su moduli. Questo articolo illustra come iniziare a creare l'agente personalizzato da zero usando il generatore di agenti in Security Copilot.

Iniziare a creare l'agente personalizzato

Dalla pagina Compilazione creare l'agente personalizzato da zero come indicato di seguito:

• Selezionare la scheda Crea un agente.

• Seleziona Inizia.

  

• Viene visualizzata la pagina Panoramica .

• Nella barra di spostamento superiore sono disponibili due schede: Compilazione e test. Compilare l'agente e configurare gli strumenti dell'agente nella scheda Compilazione.

  

• Nella pagina Panoramica dell'agente è possibile configurare i dettagli, gli strumenti, i trigger e le autorizzazioni dell'agente. Queste sezioni di configurazione sono accessibili dal riquadro di spostamento a sinistra in Panoramica dell'agente.

• Selezionare il pulsante Copilot per aprire l'interfaccia chat, visualizzata sul lato destro dello schermo. È possibile alternare l'interfaccia chat e il modulo del generatore di agenti per definire in modo iterativo l'agente e aggiungere strumenti. Nell'interfaccia chat Copilot pone domande per guidare l'utente e usa le risposte per inserire i dettagli, ad esempio il nome, la descrizione, le istruzioni e gli strumenti che definiscono l'agente.

Passaggi per creare l'agente personalizzato

Usare la pagina Panoramica per specificare lo scopo e l'ambito dell'agente, gli strumenti per eseguire attività, trigger e autorizzazioni.

Definire i dettagli dell'agente

• Immettere un nome descrittivo per l'agente.

  

• È possibile aggiungere un'icona personalizzata per l'agente . I formati accettati sono:.svg, .jpg, .png.

• Descrivere l'agente nella descrizione e l'obiettivo finale che deve soddisfare.

• Publisher è l'organizzazione che sviluppa e gestisce l'agente di sicurezza.

• Specificare il prodotto o i prodotti a cui l'agente ha l'ambito.

Nota

Il nome deve essere un identificatore valido, in quanto viene usato per identificare in modo univoco l'agente. Dopo aver distribuito l'agente in Security Copilot, è possibile usare il nome per la ricerca.

Configurare gli strumenti dell'agente

Gli strumenti rappresentano una funzionalità specifica che l'agente può usare per eseguire le attività. Uno strumento è in genere un componente modulare, una funzione o anche un altro agente specializzato progettato per eseguire un'attività predefinita. Queste attività spesso implicano l'abilitazione degli agenti per interagire con sistemi o dati esterni.

Aggiungere uno strumento esistente dal catalogo completo degli strumenti di Security Copilot o creare un nuovo strumento che consenta all'agente di eseguire attività specifiche e interagire con sistemi esterni.

Aggiungere strumenti

È possibile aggiungere gli strumenti in modo esplicito all'agente.

• Selezionare Aggiungi strumenti per aprire la modalità modale Catalogo strumenti.

• Nella modalità modale Aggiungi uno strumento è possibile selezionare più strumenti dal catalogo: Strumenti Microsoft e gli strumenti predefiniti creati, ad esempio AGENT, GPT, KQL, API e MCP.

• Ricerca: è possibile cercare lo strumento nella barra di ricerca (ricerca semantica). L'agente usa queste competenze o strumenti specifici per eseguire un'attività specifica. Dopo la selezione, lo strumento viene visualizzato nel campo Strumenti selezionati . È possibile applicare filtri per migliorare l'individuabilità per la ricerca.

• Selezionare Aggiungi selezionato per aggiungere gli strumenti all'agente.

  • Selezionare Mostra dettagli per visualizzare le informazioni dettagliate sullo strumento.

  

• Lo strumento selezionato viene aggiunto alla sezione Strumenti. Viene visualizzato anche nel riquadro di spostamento a sinistra.

• Selezionare Rimuovi per eliminare uno strumento.

Nota

La ricerca semantica migliora il recupero delle informazioni interpretando il contesto e la finalità alla base della query. Usa tecniche avanzate come l'elaborazione del linguaggio naturale (NLP) per ottenere risultati più rilevanti e significativi.

Strumento di creazione

È possibile estendere le funzionalità dell'agente personalizzato aggiungendo uno o più strumenti.

Per creare uno strumento dai tipi di strumento, ad esempio GPT, KQL, AGENT, API e MCP, vedere Come creare gli strumenti.

Configurare i trigger

I trigger attivano l'agente per l'esecuzione in base a una pianificazione. Usa lo strumento Recupera per raccogliere i dati prima di richiamare lo strumento Processo per analizzare i dati.

Selezionare Aggiungi trigger per configurare una pianificazione per l'agente. È possibile configurare più trigger.

• Specificare un nome trigger, Frequenza sulla frequenza di esecuzione del trigger.

• Strumento di recupero (facoltativo): specificare i dettagli dello strumento per recuperare i dati per l'agente.

• Strumento di elaborazione: elabora i dati recuperati dallo strumento Fetch.

Recuperare lo strumento e la funzione dello strumento Processo come punti di ingresso per il flusso di lavoro dell'agente. È possibile aggiungere i tipi di strumenti seguenti:

• Strumento appena creato (AGENT, API, KQL, GPT, MCP) da Agent Tools.

• Strumenti globali creati in Security Copilot.

• Strumenti personalizzati creati per l'organizzazione.

L'agente usa questi strumenti specifici per eseguire un'attività specifica.

Gestione autorizzazioni

È possibile impostare se l'agente può essere eseguito contemporaneamente e visualizzare i plug-in necessari per l'esecuzione.

• Selezionare il vincolo Tenant singolo desiderato per l'agente dall'elenco a discesa.

  • Tenant: può essere presente una sola istanza per ogni tenant.

  • Area di lavoro: l'ambito dell'istanza dell'agente è un ambiente di collaborazione specifico all'interno del tenant. Le esecuzioni dell'agente sono visibili solo ai membri dell'area di lavoro, a meno che non vengano condivise in modo esplicito. Può essere presente una sola istanza per ogni area di lavoro.

  • Nessuno: nessuna restrizione. Creare quante istanze dell'agente si desidera.

  Per altre informazioni sulle aree di lavoro, vedere Aree di lavoro.

• I plug-in Necessari visualizzano i plug-in Microsoft o altri plug-in aggiunti per l'agente. Questa operazione viene aggiunta automaticamente in base agli strumenti selezionati nell'agente.

Visualizzare il codice

• È possibile attivare/disattivare Visualizza codice per visualizzare l'editor di codice che visualizza il codice dell'agente generato automaticamente in formato YAML. È possibile apportare modifiche a YAML per applicare modifiche dinamiche alla visualizzazione modulo.

• È anche possibile copiare direttamente YAML o scaricare YAML per modificarlo nell'editor di codice preferito.

  

Aggiungere strumenti tramite chat

• È possibile usare l'interfaccia di chat per compilare anche l'agente e gli strumenti personalizzati sottostanti. Selezionare Applica modifiche da accettare.

  

• Lo strumento figlio viene aggiunto alla sezione Strumenti.

Nota

È possibile creare uno strumento Security Copilot o un agente in qualsiasi ordine. Il processo di sviluppo consente la flessibilità necessaria per adattarsi al flusso di lavoro.

Passaggi successivi

• Pubblicare un agente

Vedere anche

• Componenti dell'agente
• Manifesto dell'agente