Skapa JavaScript-agenter i Visual Studio Code med Microsoft 365 Agents Toolkit

I den här artikeln får du lära dig hur du skapar ett nytt Agents SDK JavaScript-projekt i Visual Studio med hjälp av Microsoft 365 Agents Toolkit.

Förutsättningar

• Installera Tillägget Agents Toolkit för Visual Studio Code.

• Du behöver en Azure-modell från Azure AI Foundry-portalen. Du behöver dessa data om modellen:

  • Namn
  • Mål-URI
  • Nyckel

  Lär dig hur du lägger till och konfigurerar modeller i Azure AI Foundry Models

Skapa ett nytt projekt

Agentverktyget innehåller en projektmall som hjälper dig att komma igång med att skapa en agent. Du kan börja från en mall i verktygslådan eller från exempel i Agents SDK.

Anmärkning

Proceduren som följer fungerar för närvarande endast för JavaScript och TypeScript. Stöd planeras för Python.

Du kan skapa ett nytt agentprojekt genom att välja Skapa en ny agent/app i Microsoft 365 Agents Toolkit. Du kan börja från en mall i verktygslådan eller från exempel i Agents SDK. Den här guiden beskriver hur du börjar med Agentverktyg.

Om du vill börja med att skapa en agent med Agent-SDK väljer du Anpassad motoragent på den första menyn:

Skapa en ny agent

När agenten för anpassad motor har valts som ett alternativ vägleds du genom en serie uppmaningar att lägga till dina egna AI-tjänster.

1. Du har två mallar att välja mellan: Basic Custom Engine Agent eller Weather Agent. Den grundläggande anpassade motoragenten är en agent utan något fördefinierad. Du måste lägga till en AI-orkestrerare, till exempel semantisk kernel eller LangChain, och dina kunskaper.

   

2. I det här exemplet väljer du Väderagent för att skapa en agent som använder LangChain och Azure AI Foundry beroende på ditt valda språk.

3. Välj Azure OpenAI för din modell.

   

   Du uppmanas att ange din nyckel, mål-URI och namnet på din Azure-modell från Azure AI Foundry-portalen. Du hittar dessa informationsdelar under Mina tillgångar och modeller och slutpunkter i Foundry-portalen.

4. Ange informationen och börja med nyckeln:

   

5. Välj JavaScript eller TypeScript, välj standardmappen och ange ett programnamn för att lagra projektrotmappen på standardplatsen.

   Ditt nya projekt öppnas.

   

6. Bekräfta att du är inloggad med tillägget genom att välja Microsoft 365-logotypen i verktygsfältet i Visual Studio Code. Kontrollera att du är inloggad på den klientorganisation som du vill ansluta till.

   

Felsöka och testa din agent i Agents Playground

Du kan felsöka och testa koden med den nya Microsoft 365 Agent Playground som finns i verktygslådan. Lekplatsen hjälper dig att felsöka koden enkelt och utan att behöva gå igenom en fullständig distributionscykel.

1. Välj Felsök i Microsoft 365 Agents Playground.

När du väljer lekplatsen väntar du en kort stund medan den förbereder din lokala dator med nödvändiga komponenter. Förberedelsen tar några minuter.

1. Medan du väntar på distributionen kontrollerar du din mapp efter koden och granskar den för att bekanta dig.

   

2. När testplatsen för felsökning och testning har slutfört inläsningen öppnas en webbläsare och du är redo att interagera med din agent med hjälp av testplatsen. Om du följde guiden och använde den fördefinierade mallen med LangChain och Azure AI Foundry kan du fråga "Vad är vädret i {din plats} i morgon?" Agenten svarar med ett adaptivt kort med vädret med hjälp av din valda AI-tjänst.

   

   

Felsöka och testa din agent i Microsoft 365 Copilot

När du slutför testningen lokalt i Agents Playground kan du distribuera till Azure Bot Service och konfigurera för Microsoft 365 Copilot-kanalen. Se till att du är inloggad i en klientorganisation som har åtkomst till Microsoft 365 Copilot.

1. Ändra felsökningsmålet till Copilot så att du kan felsöka med Microsoft 365 Copilot. Välj F5 eller Felsök för att testa. Det tar bara några minuter att göra agenten tillgänglig för Microsoft 365. I bakgrunden skapar verktygssatsen en post för appregistrering och bottjänst i Azure Bot Service och distribuerar och implementerar ditt projekt till din klientorganisation tillsammans med ett manifest.

   

2. När du gör detta bör du se Microsoft 365 Copilot-belastningen och kunna ställa frågor, lägga till brytpunkter och felsöka direkt i Microsoft 365 Copilot efter behov:

   

Sammanfattning

Du har nu lyckats:

• Startade ett nytt Microsoft 365 Agents-projekt och en agent med hjälp av agentverktyget
• Testade agenten lokalt med Hjälp av Microsoft 365 Agents Playground
• Distribuerade agenten för felsökning direkt i Microsoft 365-kanalen