Creare agenti .NET usando Microsoft 365 Agents Toolkit in Visual Studio

Questo articolo illustra come creare un nuovo progetto Agents SDK .NET in Visual Studio usando Microsoft 365 Agents Toolkit.

Prerequisiti

• Installare l'estensione Agents Toolkit per Visual Studio per Visual Studio.

• Modello OpenAI Azure dal portale di Azure AI Foundry. Sono necessari i dati seguenti sul modello:

  • Nome
  • URI di destinazione
  • Chiave

Creare un nuovo progetto

Agents Toolkit fornisce un modello di progetto che consente di iniziare a creare un agente. È possibile iniziare da un modello nel toolkit o da esempi in Agents SDK. Questo documento è incentrato sui modelli disponibili in Agents Toolkit. Sono disponibili modelli e opzioni diversi per creare progetti Agents SDK con il toolkit. Questa procedura dettagliata è incentrata sulla creazione di un agente meteo usando Semantic Kernel e Azure AI Foundry.

1. Aprire Visual Studio e selezionare Crea un nuovo progetto. Cercare "agente" per trovare nuovi modelli usando Microsoft 365 Agent Toolkit and Agents SDK Selezionare Microsoft 365 Agents>Next.

   

   Viene visualizzata una finestra di dialogo in modo che sia possibile assegnare un nome all'agente. Se si vuole, è anche possibile modificare il percorso e il nome della soluzione.

2. Al termine, selezionare Crea

   

   È possibile selezionare alcune opzioni diverse disponibili nel toolkit per la creazione di agenti.

3. Per questa procedura dettagliata, selezionare Weather Agent>Avanti esempio per usare il Microsoft 365 Agents SDK. Questo esempio predefinito implementa il kernel semantico per l'orchestrazione con i 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 richiede di scegliere il servizio LLM.

4. Per questa procedura dettagliata, selezionare Azure OpenAI.

   Queste informazioni sono disponibili in Azure AI Foundry in Modelli ed endpoint.

   

5. Immettere gli input necessari: Azure chiave del servizio OpenAI, Azure endpoint OpenAI e Azure nome della distribuzione OpenAI.

6. Fare clic su Crea. Il toolkit crea automaticamente il progetto da un modello.

7. In breve tempo, è necessario creare un nuovo progetto usando Agents SDK.

   

Prova il tuo agente nell'ambiente Microsoft 365 Agents Playground

Per iniziare, è possibile eseguire test in locale usando Microsoft 365 Agents Playground in the Toolkit.

Per avviare il test, impostare la destinazione di debug nel progetto in modo che sia Microsoft 365 Agents Playground."

Il playground viene aperto per il test in una nuova finestra del browser con l'host locale e mostra il playground con esso pronto per il test. Iniziare a inviare messaggi all'agente per testarne il comportamento.

Eseguire il debug e testare l'agente in Microsoft Teams o Microsoft 365 Copilot

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

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

   

   Ci vogliono alcuni istanti per passare a Microsoft Teams. Viene richiesto di aggiungere l'agente nel client di Teams che si apre.

   

2. Selezionare Aggiungi. Viene visualizzato un riquadro di notifica che indica che l'agente è stato aggiunto correttamente.

   

3. Selezionare Apri nel nuovo agente per aprirlo in Teams. È possibile porre domande all'agente direttamente in Teams. È possibile impostare punti di interruzione per eseguire il debug dell'esperienza quando necessario.

   

Riassunto

L'operazione è stata completata correttamente:

• È stato avviato un nuovo progetto e agente di Microsoft 365 Agents con Agents Toolkit
• Testare l'agente in locale usando Microsoft 365 Agents Playground
• Distribuito l'agente per il debug direttamente nel canale Teams o Microsoft 365