Condividi tramite

Clonare l'agente di Microsoft Copilot Studio in Microsoft Visual Studio Code

Quando cloni un agente da Microsoft Copilot Studio usando l'estensione, scarichi la definizione dell'agente e le definizioni dei componenti correlati da Copilot Studio sul tuo computer locale. È possibile modificare questi file usando Microsoft Visual Studio Code. L'operazione clone crea uno spazio di lavoro locale con tutti i file agente in un formato di directory strutturato.

Prerequisiti

Prima di iniziare a clonare agenti, ci sono alcuni prerequisiti e considerazioni importanti.

Scegli una posizione di spazio di lavoro

Seleziona una cartella locale appropriata per i file del tuo agente. Questa posizione è dove l'estensione salva i file agente. Ecco alcuni consigli importanti per scegliere una location:

  • Assicurati di avere uno spazio su disco adeguato. Un agente tipico può variare in dimensione a seconda del numero di componenti.
  • Usa un percorso senza spazi se possibile, anche se gli spazi sono supportati.
  • Considera di usare una località già tracciata da Git.

Capire cosa viene clonato

Quando si clona un agente, i file dell'agente vengono clonati localmente nel percorso scelto, creando una definizione di struttura simile alla seguente in Esplora Visual Studio Code:

my-agent/
├── actions                   # Connectors
│   ├── DevOpsAction.mcs.yml  
│   └── GetItems.mcs.yml      
├── knowledge/files                # Knowledge sources
│   ├── source1.yaml
│   └── source2.yaml
├── topics/                   # Conversation topics
│   ├── greeting.mcs.yaml
│   ├── help.mcs.yaml
│   └── escalate.mcs.yaml
├── workflows/                    # Agent tools and actions
│   └── GetDevOpsItems
│       ├── metadata.yaml
│       └── workflow.json
│   └── GetMeetings
│       ├── metadata.yaml
│       └── workflow.json
├── trigger/                 # Event triggers
│   └── welcometrigger.mcs.yaml
├── agent.mcs.yaml                # Main agent definition
├── icon.png                      # Icon used for the agent, visible in test panel and in supported channels
├── settings.mcs.yml              # Configuration settings for the agent
└── connectioreferences.mcs.yml   # Connection References used by Connectors and other actions

Metodi di clonazione

Se si usa l'estensione per la prima volta o anche una novità di Visual Studio Code, il modo più semplice per clonare un agente consiste nel selezionare Clone Agent quando il riquadro Extension è aperto. Tuttavia, questa opzione non è disponibile quando hai già un Agente clonato e aperto localmente. Al loro posto si possono utilizzare i seguenti metodi:

Questo è il metodo più semplice e raccomandato per clonare un agente.

  1. Aprire l'estensione Copilot Studio selezionando l'icona Copilot Studio nella barra delle attività. È anche possibile premere Ctrl+Shift+P e immettere "Copilot Studio: Focus on Agents View". Il riquadro Copilot Studio viene visualizzato nella barra laterale.

  2. Nel pannello Agenti , seleziona l'ambiente target dalla lista a tendina (ad esempio, "Ambiente 1") per vedere l'elenco degli agenti presenti nell'ambiente.

    > Environment 1
  Environment 2
  Environment 3

  3. Seleziona l'agente da clonare dalla lista. Gli agenti mostrano la data dell'ultimo aggiornamento. Clicca con il tasto destro sul nome dell'agente e seleziona Clona agente.

    > Customer Support Agent
    HR Assistant
    Sales Agent
    IT Helpdesk Agent

    Si apre una finestra di dialogo per la selezione di file.

  4. Naviga nella posizione desiderata nella finestra di dialogo del selettore file oppure crea una nuova cartella e seleziona Seleziona cartella. Inizia il processo di clonazione.

  5. Aspetta che il processo di clonazione si completi. Appare una notifica di avanzamento che mostra "Cloning agent: Customer Support Bot", seguita dal messaggio di successo "Agente clonato con successo." Questo processo di solito dura tra 10 e 30 secondi.

  6. Verifica che la clonazione sia stata completata con successo. La cartella dell'agente viene aperta in Visual Studio Code Explorer, il riquadro del controllo del codice sorgente mostra un albero di lavoro pulito e la finestra del file visualizza il nome della cartella.

Metodo 3: Clonare usando la palette di comandi

Usa questo metodo se preferisci flussi di lavoro focalizzati sulla tastiera.

  1. Apri la palette di comandi premendo Ctrl+Shift+P.

  2. Digitare "Copilot Studio: Clone Agent" e premere Enter. Il comando viene eseguito e appaiono i prompt.

  3. Segui le istruzioni per selezionare l'ambiente, seleziona l'agente, scegli la cartella di destinazione e attendi che la clonazione si completi. L'agente viene clonato nella posizione selezionata.

Metodo 3: Clonare usando l'URL dell'agente

Questo metodo è utile quando qualcuno condivide un URL di agente con te.

  1. Apri l'agente nel portale Web di Copilot Studio.

  2. Seleziona Impostazioni>dettagli dell'agente, e copia l'URL dell'agente. L'URL dovrebbe avere il formato: https://copilotstudio.microsoft.com/environments/{guid}/bots/{guid}. L'URL ora è nella tua cartellina.

  3. Tornare a Visual Studio Code e aprire l'estensione Copilot Studio.

  4. Seleziona Clona agente. L'estensione rileva l'URL nella tua cartellina e mostra l'agente contrassegnato come "(dalla cartellina)."

  5. Seleziona l'agente contrassegnato "(dalla cartellina)", seleziona una cartella di destinazione e attendi che la clonazione si completi. L'agente viene clonato nella posizione selezionata.

Scenari comuni di clonazione

Ecco alcuni scenari comuni su quando clonare agenti è utile, con dettagli generali sul flusso di lavoro suggerito.

Scenario 1: Clone per lo sviluppo in solitaria

Obiettivo: lavora autonomamente su un agente

  1. Clona l'agente in una cartella locale.

  2. Inizializza un repository Git da Source Control nella barra di navigazione.

  3. Apportare modifiche in locale.

  4. Esegui i commit.

  5. Applicare le modifiche a Copilot Studio quando si è pronti.

Scenario 2: Clone per la collaborazione di squadra

Obiettivo: Più sviluppatori che lavorano sullo stesso agente

  1. Il primo sviluppatore clona l'agente.

  2. Il primo sviluppatore inizializza Git ed esegue il push del contenuto in un repository condiviso (GitHub, Azure DevOps).

  3. Altri sviluppatori clonano dal repository Git condiviso.

  4. Ogni sviluppatore esegue Copilot Studio: Reattach Agent per connettere la cartella locale a Copilot Studio.

  5. Il team usa Git per la collaborazione e tiene traccia delle modifiche e usa l'estensione Visual Studio Code per lavorare sull'agente.

  6. Ogni sviluppatore applica quindi le modifiche a Copilot Studio per il test o il push in un altro ambiente downstream in base al ciclo di vita di sviluppo software o alle pipeline automatizzate.

Scenario 3: Clona più ambienti

Obiettivo: Gestire lo sviluppo, il test e le versioni di produzione

L'approccio raccomandato per il deployment con più ambienti è utilizzare soluzioni. Consideriamo un processo di distribuzione automatizzato con processi organizzativi che sono auditabili e scalabili, come le pipeline. Per gli utenti che scelgono di non usare soluzioni, l'estensione Copilot Studio offre la possibilità di sincronizzare una definizione dell'agente di Copilot Studio da un computer locale a un altro ambiente. Dovresti comunque considerare il processo organizzativo per spostare le risorse tecniche negli ambienti a valle per fornire audit, telemetria e altri componenti critici all'interno del ciclo di vita dello sviluppo software quando invii software ai tuoi clienti e utenti finali.

  1. Clona l'agente dall'ambiente di sviluppo a una cartella di sviluppo locale.

  2. Apporta modifiche nella cartella di sviluppo.

  3. Applica quei cambiamenti e testa i cambiamenti nello stesso ambiente.

  4. Usare Copilot Studio: Ricollega agente per connettere l'agente all'ambiente alternativo.

  5. Testare l'agente nel riquadro di test di Copilot Studio.

Procedure consigliate

Esegui

  • Clona tutti gli agenti in una posizione coerente.
  • Inizializza Git subito dopo il clonaggio.
  • Usa un nome di cartella significativo.
  • Controlla che il clone funzioni prima di apportare modifiche.
  • Mantenere il backup del percorso di clonazione, ad esempio in GitHub o Azure DevOps.
  • Documenta la posizione del clone nel wiki interno del team o nella documentazione.

Non

  • Non clonare in directory temporanee.
  • Non clonare più volte in luoghi diversi. Farlo può causare confusione.

Passaggi successivi

Dopo aver clonato il tuo agente:

  • Last updated on