Skapa JavaScript-agenter i Visual Studio Code med verktygslådan för Microsoft 365-agenter

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

Krav

• Installera tillägget för verktygslåda för Agents 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
  • Nyckel

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

Skapa ett nytt projekt

Verktygslådan för Agents erbjuder 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 SDK för Agents.

1. I Visual Studio Code, öppna sidopanelen för verktygslådan för Microsoft 365 Agents genom att välja Microsoft 365 Agents-ikonen i sidofältet.

2. För att skapa ett nytt agentprojekt, välj Skapa ny agent/app. Du kan börja från en mall i verktygslådan eller från exempel i SDK för Agents. Den här guiden visar hur du kommer igång med verktygslådan för Agents.

1. För att börja skapa en agent med Agents SDK, välj Agent med anpassad motor:

Skapa en ny agent

Med en anpassad motoragent vald som alternativ vägleds du genom en serie prompter för att lägga till dina egna AI-tjänster.

Du har två mallar att välja mellan:

• Grundläggande anpassad motoragent
• Väderagent.

Den grundläggande anpassade motoragenten är en agent utan något fördefinierad. Du behöver lägga till en AI-orkestrering, såsom Semantic Kernel eller LangChain, samt din kunskap, för att agenten ska vara användbar.

1. I detta exempel, välj Väderagent för att skapa en agent som använder LangChain, och Azure AI Foundry, beroende på vilket språk du väljer.

Du blir ombedd att välja en LLM-tjänst.

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

   

   Du blir tillfrågad om din nyckel, mål-URI och namnet på din Azure OpenAI-modell från Microsoft Foundry-portalen. Du kan hitta dessa uppgifter under Mina tillgångar och Modeller och slutpunkter i Foundry-portalen.

2. Ange modelldetaljerna, börja med Azure OpenAI Service-nyckeln.

   

3. Välj JavaScript eller TypeScript, välj standardmappen och ange ett applikationsnamn för att lagra projektets rotmapp 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. Se till att du är inloggad på den klientorganisation du vill ansluta till.

   

Felsök och testa din agent i Testplats för agenter

Du kan felsöka och testa din kod med den Microsoft 365 Agent-testplats som finns i verktygslådan. Testplatsen hjälper dig att felsöka din kod enkelt och utan att behöva gå igenom en hel distributionscykel.

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

   När du väljer testplatsen, vänta då en kort stund medan den förbereder din lokala dator med nödvändiga komponenter. Förberedelserna tar några minuter.

   

2. Medan du väntar på driftsättningen, kontrollera din mapp för koden och granska den för att bli bekant med den.

   

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ärdigbyggda mallen med LangChain och Azure AI Foundry kan du prompt "Vad blir vädret i {din plats} imorgon?" Agenten svarar med ett adaptivt kort som visar vädret, via din valda AI-tjänst.

   

   

Felsök och testa din agent i Microsoft 365 Copilot

När du är klar med lokal testning i Agents-testplatsen 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 för att testa. Det tar några minuters förberedelse 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 ditt projekt är distribuerat bör du se att Microsoft 365 Copilot laddas och kunna ställa frågor, lägga till brytpunkter samt vid behov felsöka direkt i Microsoft 365 Copilot:

   

Översikt

Du har nu lyckats:

• Startade ett nytt Microsoft 365 Agents-projekt och agent med verktygslådan för Agents
• Testade agenten lokalt med Microsoft 365 Agents-testplatsen
• Distribuerade agenten för felsökning direkt i Microsoft 365-kanalen