Installera Microsoft Copilot Studio-tillägget för Microsoft Visual Studio Code

Förutsättningar

Innan du installerar Microsoft Copilot Studio-tillägget för Microsoft Visual Studio Code måste du uppfylla följande krav:

Systemkrav

  • Operativsystem:
    • Windows (x64-arkitektur)
      • Windows 10 version 1809 eller senare
      • Windows 11 (vilken version som helst)
    • macOS
  • Visual Studio Code: version 1.80 eller senare (senaste stabila versionen rekommenderas)
  • Internetanslutning: Krävs för installation och autentisering

Kontokrav

  • Microsoft-konto: Aktivt Microsoft-konto med Copilot Studio-licens eller åtkomst
  • Copilot Studio-licens: Lämplig licens tilldelad till ditt konto
  • Environment access: Behörigheter för att få åtkomst till minst en Copilot Studio-miljö
  • Agentbehörigheter: Läs och skriva tillgång till alla agenter du planerar att redigera

Installationssteg

Det finns två sätt att installera Copilot Studio-tillägget i Visual Studio Code:

  • Installera inifrån Visual Studio Code
  • Installera från webbplatsen Visual Studio Code Marketplace

Metod 1: Installera från Visual Studio Code

  1. Välj ikonen Tillägg i aktivitetsfältet eller tryck Ctrl+Shift+X. Fönstret Extensions öppnas i Visual Studio Code.

  2. I sökfältet anger du "Copilot Studio." Leta efter det officiella Copilot Studio-tillägget i resultatlistan. Verifiera att utgivaren är "Microsoft."

  3. När du hittar rätt tillägg, välj det för att öppna sidan med detaljer om tillägget.

  4. Välj Installera för att påbörja installationen.

  5. Vänta tills installationen har slutförts. Du kan se en uppmaning om att läsa in Visual Studio Code igen, i så fall väljer du Reload när du uppmanas att göra det.

  6. Verifiera installationen. Leta efter ikonen Copilot Studio i aktivitetsfältet. Ikonen visas med Copilot Studio-varumärke.

Metod 2: Installera från webbplatsen för Visual Studio Code Marketplace

  1. Gå till https://marketplace.visualstudio.com/ och sök efter "Copilot Studio." Du kan också använda direktlänken: https://marketplace.visualstudio.com/items?itemName=ms-CopilotStudio.vscode-copilotstudio.

  2. Välj Installera på marknadsplatssidan. Din webbläsare kanske uppmanar dig att ladda ned Visual Studio Code innan den ber dig att öppna Visual Studio Code.

  3. Tillåt att webbläsaren öppnar Visual Studio Code och bekräftar installationen genom att leta efter tilläggsikonen i aktivitetsfältet.

Inledande konfiguration

Första uppskjutningen

  1. Välj ikonen Copilot Studio i aktivitetsfältet. Tillägget öppnas som en applikationsruta. Ett popup-meddelande visas som anger att Copilot Studio-tillägget kräver att du loggar in.

  2. Välj Logga in i popupen och välj sedan Tillåt. Din standardwebbläsare öppnas på en Microsoft-autentiseringssida.

  3. Ange dina autentiseringsuppgifter och genomför eventuell multifaktorautentisering om det behövs.

  4. Granska de begärda behörigheterna:

    • Läsa och skriva Copilot Studio-agenter
    • Åtkomst till miljöinformation
    • Synkronisera filer till molnet

    Välj Acceptera eller Tillåt. Webbläsaren uppmanar dig att stänga fönstret och återgå till Visual Studio Code.

  5. Gå tillbaka till Visual Studio Code. Tilläggspanelen laddar de miljöer du har tillgång till, och agenterna i dessa miljöer.

Verifiera lyckad installation

Efter autentiseringen bör du se en struktur under fönstret Agents i Copilot Studio-tillägget i Visual Studio Code. Du bör se en lista över miljögrupper, med nästlade miljöer och agenter, liknande följande struktur:

AGENTS
  └─ Environment Group (for example, developer, default, sandbox, production)
      ├─ Example Environment 1
      │   ├─ Agent 1
      │   └─ Agent 2
      └─ Example Environment 2
          └─ Agent 3

Felsöka installationen

Följande är felsökningssteg för vissa problem som kan uppstå när du installerar eller konfigurerar Copilot Studio Visual Studio Code-tillägget.

Tillägget visas inte

Problem: Ikonen Copilot Studio visas inte i aktivitetsfältet.

Lösning:

  1. Ladda om Visual Studio Code
  2. Välj Tillägg och leta efter tillägget i listan Installerade . Se till att förlängningen inte är avstängd.
  3. Uppdatera Visual Studio Code till den senaste versionen.
  4. Installera om tillägget.

Autentiseringsfel

Problem: Autentiseringen misslyckas eller loopar upprepade gånger.

Lösning:

  1. Rensa din webbläsares cache och cookies för microsoft.com.

  2. Försök logga in med en annan webbläsare. Sätt tillfälligt denna webbläsare som standard.

  3. Inaktivera webbläsartillägg som kan blockera autentisering.

  4. Kontrollera företagets brandvägg och proxyinställningar.

  5. Se till att du använder en stödd kontotyp.

Tillägget hittades inte på Visual Studio Code Marketplace

Problem: Det går inte att hitta Copilot Studio-tillägget när du söker.

Lösning:

  1. Se till att du söker i tilläggspanelen, inte i webbsökningen.

  2. Kontrollera stavningen: "Copilot Studio.".

  3. Kontakta administratören för att se om din organisation begränsar Visual Studio Code marketplace-åtkomst.

Avinstallera tillägget

För att ta bort förlängningen:

  1. Öppna tilläggspanelen.

  2. Leta upp Copilot Studio i de installerade tilläggen.

  3. På posten i listan, väljHantera (kugghjulsikon) >Avinstallera.

  4. Ladda Visual Studio Code igen när du uppmanas att göra det.

Anmärkning

Att avinstallera tillägget raderar inte lokalt klonade agentfiler. Du behöver ta bort dessa filer manuellt.

Nästa steg

När du har installerat tillägget och autentiserat med Copilot Studio är du redo att:

  • Last updated on