Microsoft Copilot Managed Runtime SDK-oversigt (prøveversion)

[Denne artikel er foreløbig dokumentation og kan ændres uden varsel.]

Vigtigt!

  • Dette er en prøveversionsfunktion.
  • Disse funktioner er underlagt supplerende vilkår for anvendelse og er tilgængelige før en officiel udgivelse, så kunderne kan få tidlig adgang og give feedback.

Copilot Managed Runtime SDK accelererer udviklingen af interne line of business-apps, der automatisk overholder it-styringspolitikker. Apps, der er udviklet med SDK, hostes med Copilot Managed Runtime, inkluderer indbygget Microsoft Entra-godkendelse uden at kræve brugerdefineret kode og kan sikkert oprette forbindelse til mere end 1.500 datakilder som f.eks. Microsoft Graph, SQL og SharePoint.

SDK'et understøtter udviklere, der bruger deres foretrukne værktøjer, herunder Visual Studio Code, og understøtter både Microsoft- og tredjepartsoplevelser med oprettelse af apps, der udgiver Copilot Managed Runtime-apps.

Du kan fuldt ud få vist og styre apps i Microsoft 365 Administration, hvor de vises i centraliserede lageroplevelser. De omfatter brugsklare analyser til at spore anvendelse og indbyggede målepunkter for driftstilstand med beskeder til at registrere og løse problemer. Styringspolitikker, f.eks. begrænsninger for datakilder, håndhæves automatisk, hvilket sikrer, at apps overholder organisationens standarder fra dag ét.

Få mere at vide om, hvordan udviklere bygger apps fra en kommandolinje.

De vigtigste funktioner omfatter:

  • Microsoft Entra-godkendelse og -godkendelse direkte
  • Adgang til mere end 1.500 forbindelser, der kan kaldes direkte fra JavaScript og TypeScript
  • En oprindelig indre cirkel i Git med enten et platformsadministreret lager eller dit eget eksterne GitHub-lager
  • Overholdelse som standard af organisationens it-politikker, herunder delingsgrænser, betinget adgang, avancerede forbindelsespolitikker og forebyggelse af datatab
  • Et GitHub Copilot-plugin, så du kan få mest muligt ud af din kodningsagent, der hjælper dig med at bygge og redigere dine virksomhedsapps

Forudsætninger

Apps kræver nogle få udviklerværktøjer, der er tilgængelige på kommandolinjen, og relevante slutbrugerlicenser.

Installér følgende udviklerværktøjer

Brug disse værktøjer til at bygge apps lokalt:

  • Dit foretrukne IDE. Det kan f.eks. være Visual Studio Code.
  • Node.js (LTS-version) >= v24.11.0.
  • Git>= v2.27.0.
  • Git Legitimationsstyring. Hvis du installerer Git på Windows, har du muligvis allerede GCM installeret og kan springe dette trin over. Kør git credential-manager --version for at bekræfte.
  • Microsoft Copilot Managed Runtime CLI. Installer det globalt med npm install -g @microsoft/managed-apps-cli og kontrollér med ms --version.
  • Hvis du bruger et eksternt GitHub-lager (valgfrit), skal du bruge et lager, der ejes af en organisation, på GitHub Enterprise Cloud og installere Microsoft-administrerede apps i den organisation og de lagre, du vil bruge.

Slutbrugere med licens

Licensering håndhæves, når udviklere kører en app lokalt ved hjælp af Copilot Managed Runtime CLI, og når slutbrugere kører apps. Andre CLI-udviklingsaktiviteter gennemtvinger ikke licensering.

Licensmuligheder

Brugerne skal have en af følgende for at køre en app:

Disse krav gælder både for udviklere, der kører apps lokalt, og for slutbrugere, der kører apps.

Utilstrækkelige kreditter

Brugere, der er afhængige af Copilot-kreditter og ikke opfylder kreditkravene til at køre en app, modtager i første omgang en advarsel og kan fortsætte med at bruge appen uden beregning. Adgangen blokeres, når en af følgende grænser nås, alt efter hvad der indtræffer først:

  • Brugeren udfører 20 apphandlinger.
  • Brugeren bruger appen i fem minutter.

Brugere, der er dækket af en Power Apps Premium-plan, er ikke underlagt disse kreditkrav.

Udviklerværktøjer

Udviklere bruger følgende værktøjer, når de udvikler apps:

Værktøj Beskrivelse
Copilot-administreret kørsel CLI (@microsoft/managed-apps-cli) Et enkelt kommandolinjeværktøj, der aktiveres som ms, til oprettelse, udvikling og installation af apps.
SDK Copilot Managed Runtime (@microsoft/managed-apps) Et klientbibliotek til opkald af forbindelser og interaktion med platformen på kørselstidspunktet.
Oprindelig Git CLI erstatter ikke Git. Du bruger git add, git commitog git push på samme måde, som du ville gøre i andre projekter. Builds og installationer flyder fra rigtige bekræftelser i et rigtigt lager.

Du kan redigere kode i et hvilket som helst IDE. Der er ingen påkrævet editor og ingen påkrævet skabelon ud over det stillads, som CLI producerer.

Indstillinger for lager

Hver app har et lager tilknyttet. Du vælger lagertypen, når du opretter appen, og du kan ikke ændre valget senere.

Indstilling Beskrivelse
Platformsadministreret Git (standard) Platformen klargør et administreret Git-lager, når du opretter en app – der kræves ingen ekstra konfiguration.
Medbring dit eget GitHub-lager Bind en app til et af dine lagre på oprettelses- eller init-tidspunktet ved at overføre --repo <url>. Platformen builds, scanner og installerer fra dit lager, og dine eksisterende forgreningspolitikker og gennemgange af pull-anmodninger gælder fortsat.

Bemærk!

Lageret skal ejes af en organisation på GitHub Enterprise Cloud. Lagre kan bruge en github.com vært eller en *.ghe.com vært til dataopbevaring. GitHub Enterprise Server, lagre, der ejes af personlige konti, organisationer, der ikke er på GitHub Enterprise Cloud, og andre udbydere som f.eks. Azure DevOps understøttes ikke. Lagerets URL-adresser skal bruge et fuldt https:// skema.

Konfigurer lagersynlighed og andre politikker for administration af lager i GitHub Enterprise Cloud. Få mere at vide under Gennemtvingelse af politikker for administration af lager i din virksomhed.

Tilgængelighed af Copilot-administreret kørsel

Alle berettigede lejere i den kommercielle sky får automatisk Copilot Managed Runtime. Lejeradministratorer behøver ikke at gøre noget for at aktivere funktionen, og der er ikke noget separat installationstrin.

Udforsk lageret, og rapportér problemer

For at hjælpe dig med at komme i gang og forblive produktiv kan du bruge de ressourcer, der er tilgængelige i Copilot Managed Runtime CLI GitHub-lageret.

Indsend nye problemer

Hvis du vil dele feedback eller søge vejledning, skal du åbne et nyt problem i lageret.

Tip

Hvis du finder et eksisterende problem eller en forbedring, der gælder for dig, kan du stemme eller kommentere på det for at signalere, at produktteamet prioriterer det.

Gennemse fuldførte problemer

Se fanen Lukket i Problemer for at se, hvordan andre kunder har løst problemer eller anmodet om forbedringer. Lukkede problemer er en god måde at lære af scenarier fra den virkelige verden og bekræfte, om en programrettelse eller funktion, du har brug for, allerede er tilgængelig.

Næste trin