Creare agenti JavaScript usando Toolkit per agenti Microsoft 365 in Visual Studio Code

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

Prerequisiti

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

• È necessario un modello OpenAI Azure dal portale di Microsoft Foundry. Sono necessari i dati seguenti sul modello:

  • Nome
  • URI di destinazione
  • Chiave

  Informazioni su come aggiungere e configurare modelli ai modelli di Azure AI Foundry

Creazione di 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.

1. In Visual Studio Code aprire il pannello laterale dell'estensione Microsoft 365 Agents Toolkit selezionando l'icona Microsoft 365 Agents sulla barra laterale.

2. Per compilare un nuovo progetto agente, selezionare Crea un nuovo agente/app. È possibile iniziare da un modello nel toolkit o da esempi in Agents SDK. Questa guida tratta l'introduzione a Toolkit per agenti.

1. Per iniziare con la compilazione di un agente con Agents SDK, selezionare Agente motore personalizzato:

Creare un nuovo agente

Con l'agente del motore personalizzato selezionato come opzione, vieni guidato attraverso una serie di richieste per aggiungere i tuoi servizi di intelligenza artificiale.

Sono disponibili due modelli da selezionare:

• Agente motore personalizzato di base
• Agente meteo.

Un agente del motore personalizzato di base è un agente senza componenti predefiniti. È necessario aggiungere un agente di orchestrazione di intelligenza artificiale, ad esempio Kernel semantico o LangChain e le proprie conoscenze, affinché l'agente sia utile.

1. In questo esempio selezionare Weather Agent per creare un agente che usa LangChain e Azure AI Foundry, a seconda della lingua scelta.

Viene richiesto di selezionare un servizio LLM.

1. Selezionare Azure OpenAI per il modello.

   

   Viene richiesto di immettere l'URI Key, Target URI e il Name del modello OpenAI Azure dal portale di Microsoft Foundry. Queste informazioni sono disponibili in le mie risorse e modelli ed endpoint nel portale Foundry.

2. Immettere i dettagli del modello, a partire dalla chiave del servizio OpenAI Azure.

   

3. Selezionare JavaScript o TypeScript, selezionare la cartella Predefinita e immettere un Nome applicazione per archiviare la cartella radice del progetto nel percorso predefinito.

   Si apre il tuo nuovo progetto.

   

4. Verificare di aver eseguito l'accesso usando l'estensione selezionando il logo di Microsoft 365 sulla barra degli strumenti in Visual Studio Code. Assicurati di aver eseguito l'accesso al tenant al quale vuoi connetterti.

   

Fare il debug e provare l'agente in Agents Playground

È possibile eseguire il debug e testare il codice con il nuovo Playground di Microsoft 365 Agent disponibile nel toolkit. Il playground consente di eseguire facilmente il debug del codice e senza dover eseguire un ciclo di distribuzione completo.

1. Selezionare Debug in Microsoft 365 Agents Playground.

   Quando selezioni il playground, attendi qualche istante mentre prepari il computer locale con i componenti necessari. La preparazione richiede alcuni minuti.

   

2. Durante l'attesa della distribuzione, controllare la cartella per il codice ed esaminarla per acquisire familiarità.

   

3. Una volta che il caricamento del playground per il debug e il test è terminato, si apre un browser e sei pronto per interagire con il tuo agente usando il playground. Se si segue la guida e si usa il modello predefinito con LangChain e Azure AI Foundry, è possibile chiedere "What is the weather in {your location} tomorrow?" L'agente risponde con una scheda adattiva con il meteo, usando il servizio di intelligenza artificiale scelto.

   

   

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

Al termine del test in locale in Agents Playground, è possibile eseguire la distribuzione nel servizio Azure Bot e configurare per il canale Microsoft 365 Copilot. Assicurati di aver eseguito l'accesso a un tenant che abbia accesso a Microsoft 365 Copilot.

1. Modificare la destinazione di debug in Copilot, in modo da poter eseguire il debug usando Microsoft 365 Copilot. Selezionare F5 sulla tastiera o Debug per eseguire il test. Sono necessari alcuni minuti di preparazione per rendere disponibile l'agente a Microsoft 365. Dietro le quinte, il toolkit crea una registrazione dell'app e registra un record di Azure servizio Bot e distribuisce il progetto al tenant insieme a un manifest.

   

2. Dopo aver distribuito il progetto, verrà caricato Microsoft 365 Copilot e potrete porre domande, aggiungere punti di interruzione ed eseguire il debug, come richiesto, direttamente all'interno di Microsoft 365 Copilot.

   

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 Microsoft 365