Guida introduttiva: Creare un'app Microsoft Copilot Managed Runtime con GitHub Copilot

Questa guida introduttiva illustra come passare da una richiesta in linguaggio naturale a un'app Copilot Managed Runtime distribuita usando l'interfaccia a riga di comando di GitHub Copilot con il plug-in Copilot Managed Runtime (copilot-managed-runtime). L'agente Copilot pianifica l'app, esegue i comandi dell'interfaccia della riga di comando di Microsoft Copilot Managed Runtime (@microsoft/cmr-cli), guida il flusso di lavoro Git e chiede di confermare a ogni passaggio, il tutto dal terminale scelto.

Prerequisiti

  • Node.js (versione LTS) e Git installato, con un terminale a scelta.

  • GitHub Copilot abilitato per l'account o il tenant. Per configurare Copilot, vedi Introduzione a GitHub Copilot.

  • L'interfaccia della riga di comando di GitHub Copilot installata e autenticata. Questa guida introduttiva usa l'interfaccia della riga di comando autonoma copilot , che supporta i plug-in tramite /plugin comandi barra.

    Consiglio

    Il plug-in Copilot Managed Runtime funziona anche con Claude Code e altri agenti di codifica tramite plug-in aperti. Questa guida introduttiva usa GitHub Copilot per la procedura dettagliata, ma si applicano lo stesso plug-in, le stesse richieste e gli stessi comandi dell'interfaccia della riga di comando; Avvia una sessione con claude invece di copilot e continua con il resto dei passaggi come scritto.

Non è necessario installare separatamente l'interfaccia a riga di comando di Copilot Managed Runtime Il plug-in controlla e installa le dipendenze per te la prima volta che esegui una competenza.

Procedura

La tabella seguente descrive il processo da seguire.

Ordina Passaggio Descrizione
1 Installare il plug-in Copilot Managed Runtime Avvia l'interfaccia della riga di comando di Copilot, aggiunge il marketplace di plug-in Copilot Managed Runtime e installa il plug-in Copilot Managed Runtime.
2 Richiama la competenza di creazione app Avvia l'abilità di creazione dell'app in modo che Copilot possa guidare il resto del flusso di lavoro.
3 Descrivi l'app in linguaggio naturale Fornisce i requisiti dell'app in modo che l'agente possa convalidare i prerequisiti e generare un piano.
4 Approva il piano e guarda la creazione dell'agente Esamina i passaggi proposti e lascia che l'agente esegua lo scaffolding dell'app, configuri l'ambiente e funzioni in locale.
5 Push e anteprima Conferma il push in modo che l'agente esegua il commit del lavoro e apra la build di anteprima ospitata.
6 Distribuire per live Promuove l'app dall'anteprima all'esperienza live.
7 Condividi l'app Condivide l'app distribuita con un altro utente.

Installare il plug-in Copilot Managed Runtime

Avvia l'interfaccia della riga di comando di Copilot in qualsiasi terminale:

copilot

Nella sessione di Copilot, aggiungi il marketplace di plug-in Copilot Managed Runtime e installa il plug-in:

/plugin marketplace add microsoft/Copilot-Managed-Runtime
/plugin install copilot-managed-runtime@Copilot-Managed-Runtime

Il plug-in aggiunge competenze per le app a Copilot: creare app, aggiungere connettore, inviare e visualizzare in anteprima, distribuire e condividere. Inoltre, orchestra i ms comandi CLI per conto dell'utente.

Chiudi la finestra del terminale dopo l'installazione, quindi riapri l'interfaccia della riga di comando di Copilot con:

copilot

Richiama la competenza di creazione app

Nella nuova sessione di Copilot, esegui la funzionalità di creazione app:

/copilot-managed-runtime:create-app

Copilot riconosce la competenza e chiede di descrivere l'app desiderata.

Descrivi l'app in linguaggio naturale

Digitare una descrizione in linguaggio naturale dell'app. Ad esempio:

Creare un'app per visualizzare la gerarchia dell'organizzazione come rappresentata in Microsoft Entra. Mostra la gerarchia come un albero di visualizzazione in cui il leader dell'azienda è in cima, con i suoi dipendenti diretti sotto. Aggiungere un livello per ogni livello di dipendenti. L'albero mostra inizialmente i due strati superiori. Quando si seleziona una persona, l'app si aggiorna per mostrare chi fa capo a lei.

Includi un pulsante "Visualizza profilo" per ogni utente. Quando si fa clic sul mouse, mostra il nome completo, il titolo, la posizione di lavoro, l'indirizzo e-mail e il numero di telefono.

Prima di effettuare qualsiasi altra operazione, l'agente:

  • Convalida i prerequisiti necessari controllando le dipendenze, installando gli elementi mancanti e confermando che si è autenticati nel tenant corretto.
  • Pianifica l'app. Identifica le origini dati necessarie, l'interfaccia utente e le interazioni, quindi presenta il piano per l'approvazione. Copilot non passa direttamente al codice. Rivedi ogni passaggio proposto dall'agente prima di approvare. L'utente mantiene il controllo delle azioni da eseguire.

Approva il piano e guarda la creazione dell'agente

Quando si approva il piano, l'agente esegue l'interfaccia della riga di comando di Copilot Managed Runtime per:

  • Creare il record dell'app ed eseguire il provisioning di un repository Git gestito dalla piattaforma, offrendo il controllo del codice sorgente predefinito senza alcuna configurazione aggiuntiva.
  • Configurare un ambiente di sviluppo. Ogni sviluppatore (e ogni agente di codifica) accede a una sandbox sicura e gestita dai criteri con una baseline configurata da Microsoft. Gli amministratori possono convalidare e personalizzare la linea di base in base alle esigenze.
  • Eseguire lo scaffolding dei file di progetto, installare le dipendenze e avviare il server di sviluppo locale.
  • Apri l'app nel browser in modo da poterla verificare in locale.

Push e anteprima

L'agente chiede se sei pronto per il push e l'anteprima. Conferma, e l'agente corre git add, git commit, e git push sotto il cofano. Il repository gestito dalla piattaforma utilizza intenzionalmente Git standard; gli agenti di codifica comprendono già i flussi di lavoro di Git e la piattaforma si basa su commit reali in un repository reale.

Il browser si apre con l'URL di anteprima che attiva una build della piattaforma. Al termine della compilazione e quando si preme Aggiorna, l'anteprima carica l'app in esecuzione con la stessa governance aziendale (Microsoft Entra ID, Accesso condizionale e DLP) che si applica in produzione.

Distribuire per live

Quando l'anteprima è corretta, chiedere all'agente di eseguire la distribuzione:

deploy app

L'agente viene eseguito ms app deploy e restituisce l'URL live. L'app è ora in esecuzione per gli utenti come app, governata da Entra ID, Accesso condizionale e DLP, con la telemetria e l'integrità operativa che fluiscono nell'interfaccia di amministrazione.

Condividi l'app

Chiedere all'agente di condividere con un collega, in linguaggio naturale:

share the app with someone@contoso.com

L'agente richiama l'abilità di condivisione e conferma quando la condivisione viene completata.

Congratulazioni! È stata creata, distribuita e condivisa un'app end-to-end usando GitHub Copilot. Tu e i tuoi utenti potete ora visualizzare e riprodurre l'app all'indirizzo https://managedapps.cloud.microsoft/.

Che cosa è appena successo?

Non è stata eseguita l'impalcatura di un progetto, il collegamento dei dati o l'esecuzione di comandi di infrastruttura. Hai descritto quello che volevi. L'agente Copilot ha eseguito l'interfaccia della riga di comando di Copilot Managed Runtime; la piattaforma Copilot Managed Runtime ha fornito identità, governance dei dati, creazione e distribuzione di infrastrutture, audit trail, telemetria operativa e condivisione sicura. Questo è il valore che la piattaforma offre intorno al tuo codice, in modo che tu possa rimanere concentrato sulla descrizione dell'app che vuoi creare.