JavaScript-agents maken in Visual Studio Code met de Microsoft 365 Agents Toolkit

In dit artikel leert u hoe u een nieuw Agents SDK JavaScript-project maakt in Visual Studio met behulp van de Microsoft 365 Agents Toolkit.

Vereiste voorwaarden

• Installeer de Agents Toolkit-extensie voor Visual Studio Code.

• U hebt een Azure OpenAI-model nodig vanuit de Microsoft Foundry-portal. U hebt de volgende gegevens over het model nodig:

  • Naam
  • Doel-URI
  • Sleutel

  Meer informatie over het toevoegen en configureren van modellen aan Azure AI Foundry-modellen

Een nieuw project maken

De Agents Toolkit biedt een projectsjabloon waarmee u aan de slag kunt met het bouwen van een agent. U kunt beginnen met een sjabloon in de toolkit of vanuit voorbeelden in de Agents SDK.

1. Open in Visual Studio Code het deelvenster Microsoft 365 Agents Toolkit-extensie door het pictogram Microsoft 365 Agents op de zijbalk te selecteren.

2. Als u een nieuw agentproject wilt maken, selecteert u Een nieuwe agent/app maken. U kunt beginnen met een sjabloon in de toolkit of vanuit voorbeelden in de Agents SDK. In deze handleiding wordt beschreven hoe u begint met de Agents Toolkit.

1. Als u wilt beginnen met het bouwen van een agent met de Agents SDK, selecteert u Custom Engine Agent:

Een nieuwe agent maken

Met de optie 'aangepaste motoragent' geselecteerd, wordt u door een reeks prompts geleid om uw eigen AI-services toe te voegen.

U hebt twee sjablonen waaruit u kunt kiezen:

• Basic Custom Engine Agent
• Weeragent.

De basisagent met aangepaste engine is een agent zonder vooraf samengestelde bewerkingen. U moet een AI-orchestrator toevoegen, zoals Semantic Kernel of LangChain, en uw kennis, zodat de agent nuttig kan zijn.

1. Selecteer in dit voorbeeld Weather Agent om een agent te maken die Gebruikmaakt van LangChain en Azure AI Foundry, afhankelijk van de gekozen taal.

U wordt gevraagd om een LLM-service te selecteren.

1. Selecteer Azure OpenAI voor uw model.

   

   U wordt gevraagd om uw Key, Target URI en de Name van uw Azure OpenAI-model vanuit de Microsoft Foundry-portal. U vindt deze stukjes informatie onder Mijn assets en modellen en eindpunten in de Foundry-portal.

2. Voer de modelgegevens in, te beginnen met de Azure OpenAI-servicesleutel.

   

3. Selecteer JavaScript of TypeScript, selecteer de standaardmap en voer een toepassingsnaam in om de hoofdmap van uw project op te slaan op de standaardlocatie.

   Het nieuwe project wordt geopend.

   

4. Bevestig dat u bent aangemeld met behulp van de extensie door het Microsoft 365-logo op de werkbalk in Visual Studio Code te selecteren. Zorg ervoor dat u bent aangemeld bij de tenant waarmee u verbinding wilt maken.

   

Fouten opsporen en uw agent testen in Agents Playground

U kunt fouten opsporen en testen met de nieuwe Microsoft 365 Agent Playground die beschikbaar is in de toolkit. De speeltuin helpt u bij het eenvoudig opsporen van fouten in uw code en zonder dat u een volledige implementatiecyclus hoeft te doorlopen.

1. Selecteer Debuggen in Microsoft 365 Agents Playground.

   Wanneer u de speeltuin selecteert, wacht u even terwijl deze uw lokale machine voorbereidt met de vereiste onderdelen. De voorbereiding duurt een paar minuten.

   

2. Terwijl je wacht op de implementatie, kijk in je map naar de code en bekijk deze om vertrouwd te raken.

   

3. Zodra de speeltuin voor foutopsporing en testen is geladen, wordt er een browser geopend en bent u klaar om met uw agent te communiceren met behulp van de speeltuin. Als u de handleiding volgt en de vooraf samengestelde sjabloon gebruikt met LangChain en Azure AI Foundry, kunt u vragen 'Wat is het weer in {uw locatie} morgen?' De agent reageert met een adaptieve kaart met het weer, met behulp van uw gekozen AI-service.

   

   

Fouten opsporen en uw agent testen in Microsoft 365 Copilot

Wanneer u klaar bent met het lokaal testen in de Agents Playground, kunt u implementeren in Azure Bot Service en configureren voor het Microsoft 365 Copilot-kanaal. Zorg ervoor dat u bent aangemeld bij een tenant die toegang heeft tot Microsoft 365 Copilot.

1. Wijzig het debugdoel in Copilot, zodat u met behulp van Microsoft 365 Copilot kunt debuggen. Selecteer F5 op het toetsenbord of Foutopsporing om te testen. Het duurt enkele minuten om de agent beschikbaar te maken voor Microsoft 365. Achter de schermen maakt de toolkit een app-registratie en een Azure Bot Service-record aan binnen Azure Bot Service. Vervolgens wordt uw project samen met een manifest geïmplementeerd in uw tenant.

   

2. Zodra uw project is geïmplementeerd, ziet u Microsoft 365 Copilot laden en kunt u vragen stellen, onderbrekingspunten toevoegen en fouten opsporen, indien nodig, rechtstreeks in Microsoft 365 Copilot:

   

Samenvatting

U hebt nu met succes:

• Een nieuw Microsoft 365 Agents-project en -agent gestart met behulp van de Agents Toolkit
• De agent lokaal getest met de Microsoft 365 Agents Playground
• De agent rechtstreeks geïmplementeerd voor foutopsporing in de Microsoft 365-kanaal