pac copilot

Strumenti e utilità per la gestione copilota.

I initcomandi , clone, pushpull, e pack consentono di mantenere un agente Copilot Studio come set di file su disco, modificarli localmente e sincronizzarli con un ambiente Dataverse.

Un ciclo tipico è simile al seguente:

1. Avviare un'area di lavoro. Eseguire lo scaffolding di un nuovo agente con pac copilot inito scaricare uno esistente con pac copilot clone. In entrambi i casi si ottiene un'area di lavoro locale che contiene i metadati di sincronizzazione da cui dipendono gli altri comandi.
2. Eseguire il pull prima di modificare. pac copilot pull porta le modifiche remote inattivi e le unisce nei file locali, quindi si inizia dallo stato del server corrente.
3. Eseguire il push al termine. pac copilot push invia di nuovo le modifiche locali. Se lo stesso elemento è stato modificato nel server nel frattempo, il push si arresta e chiede di eseguire prima il pull.
4. Pacchetto per la distribuzione. pac copilot pack trasforma un'area di lavoro in una soluzione .zip che è possibile distribuire con pac solution import.

Per passare da nulla a un agente attivo in un singolo passaggio, eseguire lo scaffolding, pac copilot init --environment i pacchetti, le importazioni e connettere automaticamente l'area di lavoro. I singoli comandi consentono di guidare ogni parte del ciclo autonomamente.

Commands

pac copilot clone

Clonare un agente Copilot Studio in una directory dell'area di lavoro locale.

pac copilot clonescarica un agente di Copilot Studio esistente in una directory dell'area di lavoro locale, insieme ai metadati di sincronizzazione su cui pac copilot pull si basano.pac copilot push I file dell'agente vengono scritti in una sottocartella denominata dopo il nome visualizzato.

Example

pac copilot clone `
   --bot 11111111-1111-1111-1111-111111111111 `
   --environment 22222222-2222-2222-2222-222222222222 `
   --output-dir contoso-support

Parametri obbligatori per copilot clone

--bot -id

L'ID o lo schema copilot (nome univoco trovato in Dettagli bot o nome file in Esplora soluzioni).

Parametri facoltativi per copilot clone

--component-collection -cc

ID raccolta componenti da clonare. Ripetere per più.

--display-name -dn

Nome visualizzato dell'agente (usato per la denominazione delle cartelle).

--environment -env

Specifica l'oggetto Dataverse di destinazione. Il valore può essere un GUID o un URL https assoluto. Se non specificato, verrà usata l'organizzazione attiva selezionata per il profilo di autenticazione corrente.

--output-dir -od

Cartella radice per l'output clone. Il valore predefinito è la directory corrente.

Remarks

• --botaccetta un ID Copilot o un nome di schema. Passare l'ID Copilot (GUID) o il nome dello schema dell'agente. Il comando risolve un nome di schema nell'ambiente di destinazione.
• La sottocartella di destinazione deve essere vuota. Il clone scrive in una cartella denominata dopo il nome visualizzato (sanificato) dell'agente in --output-dir. Se la cartella contiene già file, il clone si arresta anziché sovrascriverli. Usare --display-name per scegliere un nome di cartella diverso.
• Clonazione di raccolte di componenti. Per ridurre le raccolte di componenti insieme all'agente, passare uno o più ID raccolta con --component-collection, separati da punti e virgola.
• La clonazione richiede un profilo autenticato (pac auth create) e risolve l'ambiente da --environmento dall'organizzazione del profilo attivo quando lo si omette.

pac copilot create

Crea un nuovo copilota usando un file modello esistente come riferimento.

Parametri obbligatori per copilot create

--displayName

Nome visualizzato del nuovo copilota

--schemaName

Nome dello schema (nome univoco) del nuovo copilota.

--solution -s

Nome della soluzione.

--templateFileName

File yaml di origine contenente il modello copilot estratto usando il comando extract-template.

Parametri facoltativi per copilot create

--environment -env

Specifica l'oggetto Dataverse di destinazione. Il valore può essere un GUID o un URL https assoluto. Se non specificato, verrà usata l'organizzazione attiva selezionata per il profilo di autenticazione corrente.

pac copilot delete

Eliminare un Copilot personalizzato.

Parametri obbligatori per copilot delete

--bot -id

L'ID o lo schema copilot (nome univoco trovato in Dettagli bot o nome file in Esplora soluzioni).

Parametri facoltativi per copilot delete

--confirm -y

Obbligatorio per confermare l'eliminazione del copilota.

Questo parametro non richiede alcun valore. È un cambio.

--environment -env

Specifica l'oggetto Dataverse di destinazione. Il valore può essere un GUID o un URL https assoluto. Se non specificato, verrà usata l'organizzazione attiva selezionata per il profilo di autenticazione corrente.

pac copilot extract-template

Estrae un file modello da un copilota esistente in un ambiente.

Example

Questo comando estrae un file modello da un copilota esistente in un ambiente.

pac copilot extract-template `
   --environment 2e250e7a-5607-4fea-aa4e-1aeb7bf79118 `
   --bot 9ee3f7aa-ab79-4cf6-a726-d85c8c18cc3e `
   --templateFileName NewTestCopilot.yaml

Il comando restituisce un output simile al seguente per un copilota usando le lingue inglese e tedesca:

Connected as user@contoso.org

Loaded 34 components for bot 'New Test Copilot ' with id 9ee3f7aa-ab79-4cf6-a726-d85c8c18cc3e. Primary language: English, supported languages: German

New Test Copilot -> C:\Users\user\NewTestCopilot.yaml

Parametri obbligatori per copilot extract-template

--bot -id

L'ID o lo schema copilot (nome univoco trovato in Dettagli bot o nome file in Esplora soluzioni).

--templateFileName

Percorso del file yaml in cui scrivere il modello copilot.

Parametri facoltativi per copilot extract-template

--environment -env

Specifica l'oggetto Dataverse di destinazione. Il valore può essere un GUID o un URL https assoluto. Se non specificato, verrà usata l'organizzazione attiva selezionata per il profilo di autenticazione corrente.

--overwrite -o

Consentire la sovrascrittura del file di dati di output, se già esistente.

Questo parametro non richiede alcun valore. È un cambio.

--templateName

Nome del modello o 'kickStartTemplate' se il nome non è specificato.

--templateVersion

Versione del modello in formato X.X.X o 1.0.0 se la versione non è specificata.

pac copilot extract-translation

Estrae il file contenente contenuto localizzato per uno o più bot.

Example

Questo comando estrae un file contenente contenuto localizzato per uno o più copiloti.

pac copilot extract-translation `
   --environment 2e250e7a-5607-4fea-aa4e-1aeb7bf79118 `
   --bot 9ee3f7aa-ab79-4cf6-a726-d85c8c18cc3e `
   --all `
   --outdir . `
   --format json

Il comando restituisce un output simile al seguente:

Connected as user@contoso.org

Loaded 32 components for bot 'New Test Copilot' with id 9ee3f7aa-ab79-4cf6-a726-d85c8c18cc3e. Primary language: English, supported languages: German

Parametri facoltativi per copilot extract-translation

--all -a

Scrivere file di localizzazione per tutte le lingue supportate. Per impostazione predefinita, viene scritta solo la lingua primaria.

Questo parametro non richiede alcun valore. È un cambio.

--bot -id

L'ID o lo schema copilot (nome univoco trovato in Dettagli bot o nome file in Esplora soluzioni).

--environment -env

Specifica l'oggetto Dataverse di destinazione. Il valore può essere un GUID o un URL https assoluto. Se non specificato, verrà usata l'organizzazione attiva selezionata per il profilo di autenticazione corrente.

--format

Formato di file in cui scrivere file localizzati, "resx" o "json". Il valore predefinito è "resx".

--outdir

Directory di output in cui scrivere.

--overwrite -o

Consentire la sovrascrittura del file di dati di output, se già esistente.

Questo parametro non richiede alcun valore. È un cambio.

--sourcedir -src

Directory della soluzione di origine. Se specificato, ignorerà l'ambiente connesso durante la ricerca di bot e cercherà invece il contenuto nella cartella della soluzione.

pac copilot init

Creare una nuova area di lavoro dell'agente Copilot Studio da un modello.

pac copilot initconsente di eseguire lo scaffolding di una nuova area di lavoro dell'agente Copilot Studio da un modello. Viene eseguito in una delle due modalità e la presenza di --environment decide quale modalità usare:

• Scaffolding locale : nessun oggetto --environment. Scrive i file modello nella directory del progetto e si arresta. Il comando non crea nulla in Dataverse e non richiede l'accesso. Usare questa modalità quando si vuole creare localmente e connettersi a un ambiente in un secondo momento.
• Bootstrap , --environment fornito. Esegue lo scaffolding dei file, li inserisce in una soluzione, importa tale soluzione nell'ambiente e connette l'area di lavoro all'agente appena creato. Questa modalità è il percorso in un unico passaggio da nulla a un agente attivo pronto per la sincronizzazione e richiede un profilo autenticato.

Examples

Eseguire lo scaffolding di un'area di lavoro in locale:

pac copilot init `
   --name "Contoso Support Agent" `
   --publisher-prefix contoso

Eseguire lo scaffolding e il bootstrap di un agente attivo in un ambiente in un unico passaggio:

pac copilot init `
   --name "Contoso Support Agent" `
   --publisher-prefix contoso `
   --environment 22222222-2222-2222-2222-222222222222

Eseguire lo scaffolding di un agente dell'interfaccia della riga di comando (CliCopilot) in una cartella specifica:

pac copilot init `
   --name "Contoso Support Agent" `
   --publisher-prefix contoso `
   --authoring-mode cli-copilot `
   --project-dir contoso-support

Parametri obbligatori per copilot init

--name -n

Nome visualizzato dell'agente.

--publisher-prefix -pp

Publisher prefisso di personalizzazione per la soluzione.

Parametri facoltativi per copilot init

--authoring-mode -am

La forma di creazione dell'agente per lo scaffolding (impostazione predefinita: 'classic'). Usare "cli-copilot" per eseguire lo scaffolding di un agente CliCopilot creato dall'interfaccia della riga di comando.

--environment -env

Specifica l'oggetto Dataverse di destinazione. Il valore può essere un GUID o un URL https assoluto. Se non specificato, verrà usata l'organizzazione attiva selezionata per il profilo di autenticazione corrente.

--instructions -ins

Istruzioni di sistema dell'agente.

--project-dir -pd

Directory di destinazione per l'area di lavoro dell'agente. Il valore predefinito è la directory corrente.

--schema-name -sn

Nome completo dello schema dell'agente. Esegue l'override della derivazione predefinita ({publisher-prefix}_{sanitized-name}). Utilizzato as-is senza modifiche.

--template -t

Nome profilo modello (impostazione predefinita, minima). Il valore predefinito è 'default'.

Remarks

• La directory del progetto deve essere vuota. init non esegue lo scaffolding su file esistenti, quindi punta --project-dir a una cartella nuova o vuota.
• Derivazione del nome dello schema. Quando si omette --schema-name, il nome dello schema dell'agente viene compilato come {publisher-prefix}_{sanitized-name}. Passare --schema-name per impostarlo in modo esplicito; il valore viene usato as-is.
• Bootstrap funziona per entrambe le modalità di creazione. init --environment esegue il bootstrap di un agente live in un passaggio per la modalità classica predefinita e per --authoring-mode cli-copilot. In alternativa a un agente CliCopilot, è possibile eseguire lo scaffolding in locale (no --environment), quindi eseguire pac copilot pack seguito da pac solution import per distribuirlo manualmente.
• Bootstrap crea oggetti lato server. In modalità bootstrap importa init una soluzione e crea l'agente nell'ambiente di destinazione. Se esiste già un agente con lo stesso nome di schema, init arresta e punta a connettersi pac copilot clone all'agente esistente.
• Un nuovo ambiente può essere lento ad accettare la prima importazione. Un ambiente appena creato potrebbe richiedere un minuto o due per scaldarsi. Un bootstrap anticipato può non riuscire con "Le operazioni asincrone sono attualmente disabilitate per questa organizzazione". Attendere un attimo ed eseguirlo di nuovo.
• --template (default o minimal) si applica solo alla modalità di creazione classica.

pac copilot list

Elenco di copiloti nell'ambiente Dataverse corrente o di destinazione.

Example

Questo comando elenca tutti i copiloti nell'ambiente Dataverse corrente o di destinazione.

pac copilot list --environment 2e250e7a-5607-4fea-aa4e-1aeb7bf79118

Il comando restituisce un output simile al seguente:

Name                           Bot ID                               Component State Is Managed Solution ID                          Status Code State Code
Ask Me Anything Copilot       584e012c-dc95-46d6-af5a-1263b6a44342 Published       Unmanaged  285af946-6383-49a0-8615-4e2afafeaf38 Active      Provisioned
New Test Copilot               9ee3f7aa-ab79-4cf6-a726-d85c8c18cc3e Published       Unmanaged  285af946-6383-49a0-8615-4e2afafeaf38 Active      Provisioned

Parametri facoltativi per copilot list

--environment -env

Specifica l'oggetto Dataverse di destinazione. Il valore può essere un GUID o un URL https assoluto. Se non specificato, verrà usata l'organizzazione attiva selezionata per il profilo di autenticazione corrente.

pac copilot mcp

Informazioni sul server MCP (Model Context Protocol) locale.

Example

pac copilot mcp --run

Parametri facoltativi per copilot mcp

--run -r

Eseguire il server MCP (Model Context Protocol) locale.

Questo parametro non richiede alcun valore. È un cambio.

Remarks

Informazioni su come usare l'interfaccia della riga di comando di Power Platform con il server MCP predefinito

pac copilot merge-translation

Unire file contenenti contenuto localizzato per uno o più bot.

Example

Questo comando unisce i file contenenti contenuto localizzato per uno o più copiloti.

pac copilot merge-translation `
   --environment 2e250e7a-5607-4fea-aa4e-1aeb7bf79118 `
   --file ms_store_newTestCopilot.de-DE.json `
   --solution SolutionName

Quando si aggiorna la lingua tedesca, il comando restituisce un output simile al seguente:

Connected as user@contoso.org

Loading language German into bot 'ms_store_newTestCopilot' (New Test Copilot) from file 'C:\Users\user\ms_store_newTestCopilot'. 0 key(s) were missing, 0 value(s) were not used. Use the --verbose switch to get more details.

Updated 16 out of 16 components.

Informazioni su come gestire gli errori dal comando merge-translation

Parametri facoltativi per copilot merge-translation

--environment -env

Specifica l'oggetto Dataverse di destinazione. Il valore può essere un GUID o un URL https assoluto. Se non specificato, verrà usata l'organizzazione attiva selezionata per il profilo di autenticazione corrente.

--file -f

Elenco di file che contengono traduzioni. Sono supportati i modelli Glob.

--solution -s

Nome della soluzione.

--sourcedir -src

Directory della soluzione di origine. Se specificato, ignorerà l'ambiente connesso durante la ricerca di bot e cercherà invece il contenuto nella cartella della soluzione.

--verbose

Ottenere altre informazioni di diagnostica durante l'importazione/esportazione dei dati

Questo parametro non richiede alcun valore. È un cambio.

--whatif

Non esegue il comando, ma restituisce i dettagli di ciò che accadrebbe.

Questo parametro non richiede alcun valore. È un cambio.

Errori di conversione unione

In base all'esempio precedente, se nel file usato per aggiornare il copilot è presente un errore, l'output sarà simile al seguente:

Connected as user@contoso.org

Loading language German into bot 'ms_store_newTestCopilot' (New Test Copilot) from file 'C:\Users\user\ms_store_newTestCopilot'. 1 key(s) were missing, 1 value(s) were not used. Use the --verbose switch to get more details.

Updated 16 out of 16 components.

Il --verbose flag aggiunge informazioni dettagliate sull'errore:

Connected as user@contoso.org

Missing translation key: 'dialog(ms_store_newTestCopilot.topic.Lesson2)'.'trigger(main)'.'action(LbWwpD)'.Entity.Definition.'closedListItem(Redmond)'.DisplayName.

Unused translation: 'dialog(ms_store_newTestCopilot.topic.Lesson2)'.'trigger(main)'.'action(LbWwpD)'.Entity.Definition.'closedListItem(Redmont)'.DisplayName, value: Redmond

Loading language German into bot 'ms_store_newTestCopilot' (New Test Copilot) from file 'C:\Users\user\ms_store_newTestCopilot'. 1 key(s) were missing, 1 value(s) were not used. Use the --verbose switch to get more details.

Updated 16 out of 16 components.

pac copilot model list

Modelli di AI Builder nell'ambiente corrente.

Example

Questo comando elenca tutti i modelli di AI Builder.

pac copilot model list --environment 2e250e7a-5607-4fea-aa4e-1aeb7bf79118

Il comando restituisce un output simile al seguente:

Id                                   State    Name
32a9e265-1149-4155-af54-d2856d2b83f5 Active   Document Processing 2023/09/20, 12:21:40
2bcd7b94-50bc-4767-af4a-367c63fb5487 Inactive AI Classify
4e72b59a-17d6-451e-8657-89fbdec56d7a Inactive AI Extract
572f57a7-7a8f-49fc-adb4-331e02c509a6 Inactive AI Reply
b9b636cf-9748-47a7-b617-6df5f00f5151 Inactive AI Sentiment
c076eac8-f218-4feb-8ad1-7ee4fb039419 Inactive AI Summarize
a0440df3-2656-e911-8194-000d3a6cd5a5 Inactive BusinessCard model
62d1e848-5ca7-490a-94bf-79baabe85ef4 Inactive CategoryClassification model
4da7ec17-5c26-4fd2-9ddb-be4f7eda21a9 Inactive DataGenieEmailAddressValidation
51f4da11-5702-401d-b53a-9638744e8ac9 Inactive Document Layout Analysis Model
d1bb8d57-24ab-3b36-9592-bd792e153b79 Inactive DVCopilotQueryModel
3fbd4e5c-32bc-40fc-acce-59c2821cf113 Inactive Empty Dynamic Prompt
8c281981-c5d6-484f-bac7-4924ddd0b8ae Inactive EntityExtraction model
a1afa5d4-7a44-4c31-9cd2-e852a78431fa Inactive GptPromptEngineering model
2c444168-f8b1-4c6a-9313-2d9c03be6fea Inactive Id Scanning Model
77365cfa-7021-4cb7-a9b2-dc9823cde772 Inactive ImageDescription model
aef1bdd2-2a74-4f74-b4eb-9dfa22e35ded Inactive Invoice Model
5ed4d0fd-e9d4-4026-b09b-71f83ea90c60 Inactive Invoice Processing Model
c8425db7-c5a7-4226-b38e-c93a044c0fe1 Inactive KeyPhraseExtraction model
17a6f893-5b0b-4867-8fac-fb2eda9080b2 Inactive LanguageDetection model
046ab801-2756-e911-8194-000d3a6cd5a5 Inactive ObjectDetectionProposal model
892d3698-ba03-3d15-8e9e-843ca4ac5e7d Inactive PowerAppsAppCopilotModel
baa44529-bebe-49e6-837a-80bee63b0d2c Inactive Receipt Scanning Model
f1c549c2-a97e-47a5-b612-c5c2bab0f163 Inactive SentimentAnalysis model
7f8a7856-003a-3662-9871-0000d7674433 Inactive SimsModel
86419a67-205a-454f-b6fc-601394f2786d Inactive TextRecognition model
6225038a-8b5a-4913-bfd2-d8236f4102ba Inactive TextTranslation model
02e1fca3-232a-4f58-8c93-bdd8c9cd6de9 Inactive TextTranslationInternal model

Parametri facoltativi per copilot model list

--environment -env

Specifica l'oggetto Dataverse di destinazione. Il valore può essere un GUID o un URL https assoluto. Se non specificato, verrà usata l'organizzazione attiva selezionata per il profilo di autenticazione corrente.

pac copilot model predict

Invia testo o richiesta al modello di intelligenza artificiale

Parametri facoltativi per copilot model predict

--environment -env

Specifica l'oggetto Dataverse di destinazione. Il valore può essere un GUID o un URL https assoluto. Se non specificato, verrà usata l'organizzazione attiva selezionata per il profilo di autenticazione corrente.

--model-id -id

ID modello di AI Builder

--model-name -n

Nome completo o parziale del modello di intelligenza artificiale

--prompt -p

Richiesta di invio al modello di intelligenza artificiale

--text -t

Testo da inviare al modello di intelligenza artificiale

pac copilot model prepare-fetch

Accetta il file FetchXML dal modello LLM (Ai Large Language Model) e lo prepara per l'esecuzione nell'ambiente corrente.

Parametri obbligatori per copilot model prepare-fetch

--inputFile -i

File FetchXML di input proveniente in genere da AI LLM.

--outputFile -o

File FetchXML di output pronto per l'esecuzione nell'ambiente corrente.

Parametri facoltativi per copilot model prepare-fetch

--environment -env

Specifica l'oggetto Dataverse di destinazione. Il valore può essere un GUID o un URL https assoluto. Se non specificato, verrà usata l'organizzazione attiva selezionata per il profilo di autenticazione corrente.

pac copilot pack

Creare un pacchetto di un'area di lavoro dell'agente Copilot Studio in un file ZIP della soluzione.

pac copilot pack crea un pacchetto di un'area di lavoro agente in una soluzione .zip Dataverse che è possibile distribuire con pac solution import. Si tratta della forma autonoma del passaggio di creazione del pacchetto eseguito pac copilot init --environment automaticamente, quindi è possibile produrre la soluzione distribuibile come passaggio separato, ad esempio in una pipeline di compilazione. Funziona sia per le aree di lavoro classiche che per le aree di lavoro dell'agente create dall'interfaccia della riga di comando (CliCopilot).

Example

pac copilot pack `
   --publisher-prefix contoso `
   --project-dir contoso-support `
   --output-path out

Parametri obbligatori per copilot pack

--publisher-prefix -pp

Publisher prefisso di personalizzazione per la soluzione.

Parametri facoltativi per copilot pack

--output-path -op

Percorso di output per il file ZIP della soluzione. Il valore predefinito è la directory corrente.

--project-dir -pd

Directory dell'area di lavoro dell'agente da creare in un pacchetto. Il valore predefinito è la directory corrente.

--solution-name -sn

Nome univoco della soluzione. Se omesso, derivato dal nome dello schema dell'agente.

Remarks

• È un'operazione locale. Pack legge l'area di lavoro e scrive una soluzione .zip. Non richiede l'autenticazione e nessun ambiente, quindi è possibile eseguirlo in una pipeline di compilazione.
• Il prefisso dell'autore deve essere valido. --publisher-prefix deve essere un prefisso di personalizzazione ben formato o il pacchetto si interrompe prima di scrivere qualsiasi elemento.
• Nome e output della soluzione. Se si omette --solution-name, il nome univoco della soluzione viene derivato dal nome dello schema dell'agente. L'oggetto .zip viene scritto nella directory corrente, a meno che non si imposti --output-path.
• Il pacchetto non viene distribuito. Produce la soluzione, ma non la importa. Seguilo con pac solution import per distribuire l'agente, quindi pac copilot clone se vuoi un'area di lavoro connessa alla sincronizzazione.

pac copilot publish

Pubblicare un Copilot personalizzato

Parametri obbligatori per copilot publish

--bot -id

L'ID o lo schema copilot (nome univoco trovato in Dettagli bot o nome file in Esplora soluzioni).

Parametri facoltativi per copilot publish

--environment -env

Specifica l'oggetto Dataverse di destinazione. Il valore può essere un GUID o un URL https assoluto. Se non specificato, verrà usata l'organizzazione attiva selezionata per il profilo di autenticazione corrente.

pac copilot pull

Eseguire il pull delle modifiche remote da Copilot Studio e unire con l'area di lavoro locale.

Il pac copilot pull comando recupera lo stato del server corrente dell'agente e lo unisce nell'area di lavoro locale usando un merge a tre vie. Questo processo garantisce che le modifiche sul lato server e i file locali non modificati rimangano intatti. Eseguirlo prima di iniziare la modifica ed eseguirlo di nuovo prima di eseguire il push delle modifiche.

Example

Eseguire il comando dall'interno della cartella dell'area di lavoro:

pac copilot pull

In alternativa, puntarlo in un'area di lavoro altrove su disco:

pac copilot pull --project-dir contoso-support

Parametri facoltativi per copilot pull

--project-dir -pd

Percorso della directory del progetto. Il valore predefinito è la directory di lavoro corrente.

Remarks

• Eseguirlo all'interno di un'area di lavoro di sincronizzazione. Il pull comando funziona solo in una cartella creata da pac copilot clone o pac copilot init. Legge l'ambiente di destinazione e l'agente dai metadati di sincronizzazione dell'area di lavoro, motivo per cui non esiste alcun --environment argomento. Se l'esecuzione viene eseguita in un'altra posizione, l'operazione ha esito negativo e viene visualizzato un errore "Area di lavoro non trovata".
• Scrive nei file locali. Il pull unisce le modifiche remote nell'area di lavoro e scarica i file di knowledge base. Eseguire il commit o il backup del lavoro locale a cui ci si preoccupa prima di eseguire il pull.
• Accedere prima con pac auth create.

pac copilot push

Eseguire il push delle modifiche all'area di lavoro locale in Copilot Studio.

pac copilot push invia le modifiche nell'area di lavoro locale all'agente in Dataverse. Confronta i file con l'ultimo stato del server noto, carica solo ciò che è stato modificato, inclusi i file di conoscenza, i flussi cloud e i riferimenti alle connessioni, e segnala gli elementi di cui è stato eseguito il push.

Example

Eseguirlo dall'interno della cartella dell'area di lavoro:

pac copilot push

In alternativa, puntarlo in un'area di lavoro altrove su disco:

pac copilot push --project-dir contoso-support

Parametri facoltativi per copilot push

--project-dir -pd

Percorso della directory del progetto. Il valore predefinito è la directory di lavoro corrente.

Remarks

• Eseguirlo all'interno di un'area di lavoro di sincronizzazione. Come pull, push funziona solo in una cartella creata da pac copilot clone o pac copilot init. Legge l'ambiente di destinazione dai metadati di sincronizzazione dell'area di lavoro. Non c'è argomento --environment .
• Eseguire prima il pull se si verifica un conflitto. Se lo stesso elemento è stato modificato sia in locale che nel server, il push si arresta e chiede di eseguire pac copilot pull prima di riprovare. Questo processo impedisce a un push di sovrascrivere automaticamente una modifica lato server non visualizzata.
• Nessuna modifica locale è un no-op. Se il push non trova nulla da inviare, segnala che e si esce senza toccare l'ambiente.
• Un push riuscito modifica l'agente attivo nell'ambiente di destinazione.
• Accedere prima con pac auth create.

pac copilot quarantine

Stato di quarantena dell'agente copilota.

Parametri obbligatori per copilot quarantine

--bot-id -id

L'ID del copilota per mettere in quarantena/smettere la quarantena.

Parametri facoltativi per copilot quarantine

--environment -env

Ambiente (ID, ID organizzazione, URL, nome univoco o nome parziale).

--status -s

Valore dello stato di quarantena. vero = quarantena, falso = sbloccato. il valore predefinito è true.

Questo parametro non richiede alcun valore. È un cambio.

pac copilot status

Eseguire il polling dello stato di distribuzione di un copilota specificato nell'ambiente Dataverse corrente o di destinazione.

Example

Questo comando esegue il polling dello stato di distribuzione di un copilota specificato nell'ambiente Dataverse corrente o di destinazione.

pac copilot status `
   --environment 2e250e7a-5607-4fea-aa4e-1aeb7bf79118 `
   --bot-id 9ee3f7aa-ab79-4cf6-a726-d85c8c18cc3e

Il comando restituisce un output simile al seguente:

Connected as user@contoso.org
Connected to... Contoso Organization
Virtual Agent New Bot German with ID 9ee3f7aa-ab79-4cf6-a726-d85c8c18cc3e has been provisioned.

Parametri obbligatori per copilot status

--bot-id -id

ID di un copilota (Chatbot).

Parametri facoltativi per copilot status

--environment -env

Specifica l'oggetto Dataverse di destinazione. Il valore può essere un GUID o un URL https assoluto. Se non specificato, verrà usata l'organizzazione attiva selezionata per il profilo di autenticazione corrente.

Autenticazione e ambiente per i comandi di sincronizzazione

I clonecomandi , pull, pushe init --environment comunicano tutti con un ambiente Dataverse, quindi hanno bisogno di un profilo di autenticazione. Accedere prima con pac auth create.

• clone, pulle push richiedono un profilo attivo. pac copilot init è necessario solo uno quando si passa --environment; senza di esso, init esegue lo scaffolding dei file in locale e non richiede l'accesso.
• pull e push leggere l'ambiente di destinazione dai metadati di sincronizzazione dell'area di lavoro, quindi non accettano un --environment argomento. clone e init fare.
• pac copilot pack è puramente locale. Legge e scrive solo i file, quindi non richiede l'autenticazione e nessun ambiente.

pull e push funzionano solo all'interno di un'area di lavoro creata da clone o init. I metadati di sincronizzazione scritti quando l'area di lavoro viene creata è ciò che indica a quali agenti e ambiente comunicare, quindi l'esecuzione di tali metadati non riesce rapidamente con un errore "area di lavoro non trovata".

Vedere anche

Microsoft Power Platform gruppi di comandi dell'interfaccia della riga di comando
Panoramica dell'interfaccia della riga di comando di Microsoft Power Platform