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

Questo articolo illustra come creare un nuovo progetto JavaScript SDK per agenti in Visual Studio, usando il Toolkit agenti di Microsoft 365.

Prerequisiti

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

• Occorre un modello Azure OpenAI dal portale Microsoft Foundry. Hai bisogno dei seguenti dati sul modello:

  • Nome
  • URI di destinazione
  • Tasto

  Scopri come aggiungere modelli ai modelli di Fonderia Azure AI e come configurarli

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.

1. In Visual Studio Code, apri il pannello laterale dell'estensione Toolkit agenti di Microsoft 365 selezionando l'icona Agenti Microsoft 365 nella barra laterale.

2. Per creare un nuovo progetto di agente, seleziona Crea un nuovo agente/app. Puoi iniziare da un modello del toolkit o da esempi nell'SDK per agenti. Questa guida tratta l'introduzione a Toolkit per agenti.

1. Per iniziare a creare un agente con l'SDK per gli agenti, seleziona Agente con motore personalizzato:

Crea 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.

Puoi scegliere tra due modelli:

• Agente motore personalizzato di base
• Agente per le previsioni meteo.

Un agente del motore personalizzato di base è un agente senza componenti predefiniti. Devi aggiungere un orchestratore IA, come Kernel semantico o LangChain, e la tua fonte delle informazioni specifica, affinché l'agente sia utile.

1. In questo esempio, seleziona Agente per le previsioni meteo per creare un agente che utilizzi LangChain e Fonderia Azure AI, a seconda del linguaggio scelto.

Viene richiesto di selezionare un servizio LLM.

1. Seleziona Azure OpenAI per il tuo modello.

   

   Ti viene richiesto di inserire Chiave, URI di destinazione e Nome del tuo modello Azure OpenAI dal portale Microsoft Foundry. Queste informazioni sono disponibili nelle sezioni Risorse e Modelli ed endpoint all'interno del portale Foundry.

2. Inserisci i dettagli del modello, a partire dalla chiave del Servizio Azure OpenAI.

   

3. Seleziona JavaScript o TypeScript, seleziona la Cartella predefinita, quindi inserisci il Nome applicazione per memorizzare il tuo progetto nella cartella radice nel percorso predefinito.

   Si apre il tuo nuovo progetto.

   

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

   

Effettuare i debug e i test dell'agente in Agents Playground

Puoi eseguire il debug e testare il tuo codice con il nuovo Microsoft 365 Agent Playground disponibile nel toolkit. Il playground ti aiuta a eseguire il debug del codice facilmente e senza dover affrontare un ciclo completo di distribuzione.

1. Seleziona Esegui 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 qualche minuto.

   

2. Mentre aspetti il completamento della distribuzione, controlla il codice nella tua cartella ed esaminalo per acquisire familiarità.

   

3. Una volta che il playground per il debug e i test è caricato, si apre un browser da cui puoi iniziare a interagire con il tuo agente tramite il playground. Se segui la guida e usi il modello predefinito con LangChain e Fonderia Azure AI, puoi chiedere "Che tempo fa domani a {la tua posizione}?" L'agente risponde con una scheda adattiva che mostra il meteo, usando il servizio IA scelto.

   

   

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

Al termine dei test locali nell'Agents Playground, puoi distribuire l'agente sul servizio Azure Bot e configurarlo per il canale Microsoft 365 Copilot. Assicurati di aver eseguito l'accesso a un tenant che abbia accesso a Microsoft 365 Copilot.

1. Seleziona Copilot come target di debug, così puoi eseguire il debug usando Microsoft 365 Copilot. Premi F5 sulla tastiera oppure seleziona Debug per eseguire il test. Sono necessari alcuni minuti di preparazione per rendere l'agente disponibile per Microsoft 365. Dietro le quinte, il toolkit crea una registrazione dell'app e registra un record di servizio Azure Bot e distribuisce il progetto al tenant insieme a un manifest.

   

2. Una volta che il tuo progetto è stato distribuito, Microsoft 365 Copilot si carica e tu puoi porre domande, aggiungere punti di interruzione ed eseguire il debug, secondo necessità, direttamente in Microsoft 365 Copilot:

   

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
• Distribuito l'agente per il debug direttamente nel canale Microsoft 365