Nota
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare ad accedere o modificare le directory.
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare a modificare le directory.
Copilot Managed Runtime SDK accelera lo sviluppo di app line-of-business interne automaticamente conformi ai criteri di governance IT. Le app create con l'SDK sono ospitate con Copilot Managed Runtime, includono l'autenticazione integrata di Microsoft Entra senza richiedere codice personalizzato e possono connettersi in modo sicuro a più di 1.500 origini dati come Microsoft Graph, SQL e SharePoint.
L'SDK supporta gli sviluppatori che usano i loro strumenti preferiti, tra cui Visual Studio Code, ed è alla base delle esperienze di creazione di app Microsoft e di terze parti che pubblicano app Copilot Managed Runtime.
È possibile visualizzare e gestire completamente le app nell'interfaccia di amministrazione di Microsoft 365, dove vengono visualizzate nelle esperienze di inventario centralizzato. Includono analisi dell'utilizzo predefinite per tenere traccia dell'adozione e metriche di integrità operativa integrate con avvisi per rilevare e risolvere i problemi. I criteri di governance, come le restrizioni dell'origine dati, vengono applicati automaticamente, garantendo la conformità delle app agli standard dell'organizzazione fin dal primo giorno.
Informazioni su come gli sviluppatori creano app da una riga di comando.
Le funzionalità principali includono:
- Autenticazione e autorizzazione di Microsoft Entra pronte all'uso
- Accesso a più di 1.500 connettori, chiamabili direttamente da JavaScript e TypeScript
- Un ciclo interno di Git nativo con un repository gestito dalla piattaforma o un repository GitHub esterno
- Conformità per impostazione predefinita ai criteri IT dell'organizzazione, inclusi limiti di condivisione, accesso condizionale, criteri avanzati dei connettori e prevenzione della perdita di dati
- Il plug-in Copilot Managed Runtime , in modo da poter ottenere il massimo dall'agente di codifica che consente di creare e modificare le app aziendali
Prerequisiti
Le app richiedono alcuni strumenti di sviluppo disponibili nella riga di comando e licenze appropriate per gli utenti finali.
Installare gli strumenti di sviluppo seguenti
Usare questi strumenti per creare app in locale:
- L'IDE preferito. Ad esempio, Visual Studio Code.
- Node.js (versione LTS) >= v24.11.0.
- Git>= v2.27.0.
-
Git Credential Manager. Se si installa Git in Windows, è possibile che GCM sia già installato e che sia possibile ignorare questo passaggio. Eseguire
git credential-manager --versionper verificare. - Interfaccia della riga di comando di runtime gestito da Microsoft Copilot. Installalo globalmente e
npm install -g @microsoft/cmr-cliverifica conms --version. - Se si usa un repository GitHub remoto (facoltativo), usare un repository di proprietà di un'organizzazione su GitHub Enterprise Cloud e installare Microsoft Managed Apps nell'organizzazione e nei repository che si useranno.
Utenti finali delle licenze
Le licenze vengono applicate quando gli sviluppatori eseguono un'app in locale usando l'interfaccia a riga di comando di Copilot Managed Runtime e quando gli utenti finali eseguono le app. Altre attività di sviluppo CLI non applicano le licenze.
Opzioni di licenza
Per eseguire un'app, gli utenti devono avere uno degli elementi seguenti:
- Piano Power Apps Premium: copre tutte le operazioni delle app senza consumare crediti Copilot.
- Crediti Copilot per le applicazioni gestite: I crediti vengono addebitati ogni volta che un'app viene avviata e per ogni chiamata API. Ogni chiamata API consuma 0,1 crediti. Per altre informazioni, vedi Informazioni sulla fatturazione basata sull'utilizzo e sulla gestione dei costi per i crediti Copilot.
Questi requisiti si applicano sia agli sviluppatori che eseguono le app in locale sia agli utenti finali che eseguono le app.
Crediti insufficienti
Gli utenti che fanno affidamento sui crediti Copilot e non soddisfano i requisiti di credito per eseguire un'app inizialmente ricevono un avviso e possono continuare a usare l'app gratuitamente. L'accesso viene quindi bloccato al raggiungimento di uno dei limiti seguenti, a seconda dell'evento che si verifica per primo:
- L'utente completa 20 operazioni dell'app.
- L'utente usa l'app per cinque minuti.
Gli utenti coperti da un piano Power Apps Premium non sono soggetti a questi requisiti di credito.
Strumenti di sviluppo
Gli sviluppatori usano gli strumenti seguenti durante la creazione di app:
| Strumento | Descrizione |
|---|---|
L'interfaccia della riga di comando di Copilot Managed Runtime (@microsoft/cmr-cli) |
Un singolo strumento da riga di comando, richiamato come ms, per la creazione, lo sviluppo e la distribuzione di app. |
L'SDK di Copilot Managed Runtime (@microsoft/cmr-apps) |
Una libreria client per chiamare connettori e interagire con la piattaforma in fase di esecuzione. |
| Git nativo | L'interfaccia della riga di comando non sostituisce Git. Si usa git add, git commit, e git push allo stesso modo si farebbe per qualsiasi altro progetto. Le compilazioni e le distribuzioni fluiscono da commit reali in un repository reale. |
È possibile modificare il codice in qualsiasi IDE. Non c'è alcun editor richiesto e nessun modello richiesto oltre allo scaffold prodotto dalla CLI.
Opzioni del repository
Ogni app usa una delle tre modalità di repository, inclusa una modalità senza binding del repository. La modalità viene scelta al momento della creazione dell'app e non è possibile modificare la scelta in un secondo momento.
| Opzione | Descrizione |
|---|---|
| Git gestito dalla piattaforma (impostazione predefinita) | La piattaforma esegue il provisioning di un repository Git gestito quando crei un'app, senza bisogno di alcuna configurazione aggiuntiva. |
| Bring your own GitHub repository | Associare un'app a uno dei repository al momento della creazione o dell'inizializzazione passando --repo <url>. La piattaforma crea, analizza e distribuisce dal tuo repository e le policy di filiale esistenti e le revisioni delle richieste pull continuano ad essere applicate. |
| Nessun binding del repository | Passare --repo none per compilare gli artefatti esternamente e caricarli per la distribuzione invece di usare una build della piattaforma supportata da Git. Consulta Distribuire app con GitHub Actions. |
La distribuzione di artefatti esterni richiede l'impostazione dell'ambiente pertinente e non è consentita per impostazione predefinita. Consulta Distribuzione di artefatti esterni.
Nota
Per l'opzione bring-your-own-GitHub, il repository deve essere di proprietà di un'organizzazione su GitHub Enterprise Cloud. I repository possono usare un host o un github.com*.ghe.com host di residenza dei dati. GitHub Enterprise Server, i repository di proprietà di account personali, le organizzazioni che non sono in GitHub Enterprise Cloud e altri provider come Azure DevOps non sono supportati. Gli URL del repository devono utilizzare uno schema completo https:// .
Configura la visibilità del repository e altri criteri di gestione del repository in GitHub Enterprise Cloud. Per ulteriori informazioni, vedere Applicazione dei criteri di gestione dell'archivio nell'azienda.
Disponibilità di Copilot Managed Runtime
Tutti i tenant idonei nel cloud commerciale ottengono automaticamente il runtime gestito da Copilot. Gli amministratori tenant non devono eseguire alcuna azione per attivare la funzionalità e non esiste un passaggio di installazione separato.
Esplorare il repository e segnalare problemi
Per iniziare e rimanere produttivi, usa le risorse disponibili nel repository GitHub dell'interfaccia della riga di comando di Copilot Managed Runtime.
Inviare nuovi problemi
Per condividere feedback o cercare indicazioni, apri un nuovo problema nel repository.
Consiglio
Se si trova un problema o un miglioramento esistente che si applica all'utente, votarlo o commentarlo per segnalarne la priorità al team del prodotto.
Rivedere i problemi completati
Controllare la scheda Chiusi in Problemi per vedere in che modo altri clienti hanno risolto i problemi o richiesto miglioramenti. I problemi chiusi sono un ottimo modo per imparare da scenari reali e confermare se una correzione o una funzionalità necessaria è già disponibile.
Limitazioni
Copilot Managed Runtime usa un service worker gestito dalla piattaforma per il caricamento delle app e l'accesso sicuro ai servizi della piattaforma. I browser consentono a un solo operatore del servizio di controllare una pagina, quindi i processi di lavoro del servizio personalizzati che assumono il controllo dell'app non sono attualmente supportati e possono causare errori di caricamento o di connettività. Se il framework o gli strumenti PWA registrano automaticamente un service worker, disabilitare tale registrazione durante la distribuzione in Copilot Managed Runtime.