JavaScript-agenten in Visual Studio Code maken met de toolkit voor Microsoft 365-agenten

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

Vereisten

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

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

  • Naam
  • Doel-URI
  • Sleutel

  Ontdek hoe u modellen toevoegt en configureert in Azure AI Foundry-modellen

Een nieuw project maken

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

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

2. Om een nieuw agentproject aan te maken, selecteert u Een nieuwe agent/app maken. U kunt starten vanuit een sjabloon in de toolkit of vanuit voorbeelden in de Agents SDK. Deze gids legt uit hoe u kunt starten met de Agents Toolkit.

1. Om te beginnen met het maken van een agent met de Agents SDK, selecteert u Custom Engine Agent:

Een nieuwe agent maken

Wanneer u de optie 'Custom engine-agent' selecteert, wordt u door een reeks prompts geleid om uw eigen AI-services toe te voegen.

U hebt twee sjablonen om uit te kiezen:

• Basisagent met aangepaste engine
• 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 is.

1. Selecteer in dit voorbeeld Weeragent om een agent te maken die LangChain en Azure AI Foundry gebruikt, afhankelijk van uw gekozen taal.

U wordt gevraagd een LLM-service te kiezen.

1. Selecteer Azure OpenAI voor uw model.

   

   U wordt gevraagd om uw Sleutel, Doel-URI en de Naam van uw Azure OpenAI-model uit het Microsoft Foundry-portal. U kunt deze informatie vinden onder Mijn assets en Modellen en eindpunten in de Foundry-portal.

2. Voer de modeldetails in, beginnend met de Azure OpenAI-servicesleutel.

   

3. Selecteer JavaScript of TypeScript, selecteer de Standaardmap en voer een Toepassingsnaam in om de hoofdmap van het project op de standaardlocatie op te slaan.

   Uw nieuwe project wordt geopend.

   

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

   

Spoor fouten op en test uw agent lokaal in Agents Playground

U kunt fouten in uw code opsporen en testen met de nieuwe Microsoft 365 Agent Playground, die beschikbaar is in de toolkit. De playground helpt u om fouten in uw code eenvoudig op te sporen, zonder dat u een volledige implementatiecyclus hoeft te doorlopen.

1. Selecteer Foutopsporing in Microsoft 365 Agents Playground.

   Wanneer u de playground selecteert, wacht u even terwijl uw lokale machine wordt voorbereid met de vereist onderdelen. De voorbereiding duurt een paar minuten.

   

2. Terwijl je wacht op de implementatie, bekijkt u de code in uw map en neemt u deze door om ermee vertrouwd te raken.

   

3. Wanneer de playground voor foutsopsporing en testen klaar is met laden, wordt er een browser geopend en kunt u met uw agent communiceren in de playground. Als u de handleiding volgt en de kant-en-klare template met LangChain en Azure AI Foundry gebruikt, kunt u vragen: "Wat is het weer in {uw locatie} morgen?" De agent reageert met een adaptieve kaart met het weer, met behulp van de door u gekozen AI-service.

   

   

Spoort fouten op en test uw agent in Microsoft 365 Copilot

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

1. Stel het doel voor foutopsporing op in Copilot, zodat u fouten kunt opsporen in Microsoft 365 Copilot. Selecteer F5 op het toetsenbord of Foutopsporing om te testen. Het duurt enkele minuten voorbereiding om de agent beschikbaar te maken voor Microsoft 365. Op de achtergrond maakt de toolkit een app-registratie en een Azure Bot Service-record aan in Azure Bot Service en implementeert uw project naar uw tenant samen met een manifest.

   

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

   

Overzicht

U hebt nu het volgende gedaan:

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