Creare agenti .NET in Visual Studio Code utilizzando il Toolkit agenti di Microsoft 365

In questo articolo scoprirai come creare un nuovo progetto .NET SDK per agenti in Visual Studio, utilizzando il Toolkit agenti di Microsoft 365.

Prerequisiti

• Installa l'estensione Toolkit agenti per Visual Studio per Visual Studio.

• Un modello Azure OpenAI dal portale Azure AI Foundry. Hai bisogno dei seguenti dati sul modello:

  • Nome
  • URI di destinazione
  • Tasto

Crea un nuovo progetto

Il Toolkit agenti fornisce un modello di progetto per aiutarti a iniziare a creare un agente. Puoi iniziare da un modello del toolkit o da esempi nell'SDK per agenti. Questo documento si concentra sui modelli disponibili nel Toolkit agenti. Sono disponibili diversi template e opzioni per creare progetti Agents SDK utilizzando il toolkit. Questa guida si concentra sulla creazione di un Weather Agent utilizzando Kernel semantico e Azure AI Foundry.

1. Aprire Visual Studio e selezionare Crea un nuovo progetto. Cerca "agent" per trovare nuovi modelli con il Toolkit agenti di Microsoft 365 e Agents SDK. Seleziona Agenti Microsoft 365>Avanti.

   

   Appare una finestra di dialogo per assegnare un nome all'agente. Puoi anche cambiare la posizione e il nome della soluzione, se vuoi.

2. Al termine seleziona Crea

   

   Puoi selezionare diverse opzioni che il toolkit offre per creare agenti.

3. Per questa procedura dettagliata, seleziona l'esempio Weather Agent>Avanti per usare SDK per agenti Microsoft 365. Questo esempio precostruito implementa Kernel semantico per l'orchestrazione con modelli Azure AI Foundry o Azure OpenAI. È anche possibile usare l'esempio di agente vuoto se si vuole iniziare senza un modello o un agente di orchestrazione.

   

   

   Una finestra di dialogo ti chiede di scegliere il servizio LLM.

4. Per questa procedura dettagliata, seleziona Azure OpenAI.

   Queste informazioni si trovano in Azure AI Foundry sotto Modelli ed endpoint.

   

5. Inserisci i dati richiesti: chiave di servizio Azure OpenAI, endpoint Azure OpenAI e nome della distribuzione Azure OpenAI.

6. Seleziona Crea. Il toolkit crea automaticamente il progetto a partire da un modello.

7. In poco tempo, dovresti avere un nuovo progetto creato usando l'Agents SDK.

   

Testa l'agente nel playground per gli agenti di Microsoft 365

Per iniziare, puoi testare localmente usando il playground per gli agenti di Microsoft 365 nel Toolkit.

Per iniziare i test, imposta la destinazione di debug nel tuo progetto come Playground per gli agenti di Microsoft 365.

Il playground viene aperto per il test in una nuova finestra del browser con l'host locale e mostra il playground pronto per il test. Inizia a inviare messaggi al tuo agente per testare il suo comportamento.

Esegui il debug e testa il tuo agente in Microsoft Teams o Microsoft 365 Copilot

Puoi anche impostare la destinazione di debug direttamente in Microsoft Teams o Microsoft 365 Copilot.

1. Seleziona una delle opzioni di debug come destinazione dall'elenco delle destinazioni.

   

   Ci vogliono alcuni istanti per passare a Microsoft Teams. Ti viene chiesto di aggiungere il tuo agente nel client Teams che si apre.

   

2. Seleziona Aggiungi. Appare un pannello di notifica che indica che l'agente è stato aggiunto con successo.

   

3. Seleziona Apri sul tuo nuovo agente per aprirlo in Teams. Puoi fare domande al tuo agente direttamente su Teams. Puoi impostare punti di interruzione per eseguire il debug della tua esperienza quando necessario.

   

Riepilogo

Ora hai:

• Avviato un nuovo progetto e agente Microsoft 365 per agenti usando il Toolkit agenti
• Testato l'agente localmente usando Microsoft 365 Agents Playground
• Hai distribuito l'agente per il debug direttamente nel canale di Teams o Microsoft 365