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 OpenAI-modell från Microsoft Foundry-portalen. Du behöver följande data om modellen:

  • Namn
  • Mål-URI
  • Nyckelord

  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.

1. I Visual Studio Code öppnar du panelen Microsoft 365 Agents Toolkit-tillägg genom att välja ikonen Microsoft 365 Agenter i sidofältet.

2. Om du vill skapa ett nytt agentprojekt väljer du Skapa en ny agent/app. 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.

1. Om du vill börja med att skapa en agent med Agent-SDK väljer du Anpassad motoragent:

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.

Du har två mallar att välja mellan:

• Basic Custom Engine Agent
• Väderagent.

Den grundläggande anpassade motoragenten är en agent utan något fördefinierad. Du måste lägga till en AI-orkestrerare, till exempel Semantic Kernel eller LangChain, och dina kunskaper, för att agenten ska vara användbar.

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

Du uppmanas att välja en LLM-tjänst.

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

   

   Du uppmanas att ange din Key, Target URI och Name för din Azure OpenAI-modell från Microsoft Foundry-portalen. Du hittar dessa informationsdelar under Mina tillgångar och modeller och slutpunkter i Foundry-portalen.

2. Ange modellinformationen och börja med Azure OpenAI-tjänstnyckeln.

   

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

   Ditt nya projekt öppnas.

   

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

   

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

   

3. 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öljer guiden och använder 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 på tangentbordet eller Felsök att testa. Det tar bara några minuter att göra agenten tillgänglig för Microsoft 365. I bakgrunden skapar verktygslådan en appregistrering och en Azure Bot Service-post, och distribuerar sedan projektet till din klientorganisation tillsammans med ett manifest.

   

2. När projektet har distribuerats bör du se Microsoft 365 Copilot läsa in och kunna ställa frågor, lägga till brytpunkter och felsöka direkt i Microsoft 365 Copilot:

   

Sammanfattning

Nu har du framgångsrikt:

• 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