pac copilot

Ferramentas e utilidades para a xestión de copilotos.

Os initcomandos , clone, pull, push, e pack permiten manter un axente de Copilot Studio como un conxunto de ficheiros no disco, editalo localmente e sincronizalo cun entorno Dataverse.

Un bucle típico é así:

1. Comeza un espazo de traballo. Acompaña un axente novo con pac copilot init, ou descarga un existente con pac copilot clone. De calquera xeito, obtés un espazo de traballo local que leva os metadatos de sincronización dos que dependen os outros comandos.
2. Tira antes de editar. pac copilot pull Baixa os cambios remotos e combínaos nos teus ficheiros locais, así que comezas desde o estado actual do servidor.
3. Empurra cando remates. pac copilot push Envía os cambios locais de volta. Se o mesmo obxecto cambiou no servidor mentres tanto, o push para e pídeche que tires primeiro.
4. Paquete para despregamento. pac copilot pack Converte un espazo de traballo nunha solución .zip que podes despregar con pac solution import.

Para pasar de nada a un axente en directo nun só paso, pac copilot init --environment andamios, empaqueta, importas e conecta o espazo de traballo por ti. Os comandos individuais permítenche controlar cada parte do bucle por si só.

Comandos

pac copilot clone

Clona un axente de Copilot Studio nun directorio local de espazo de traballo.

pac copilot clonedescarga un axente existente de Copilot Studio nun directorio local de espazo de traballo, xunto cos metadatos de sincronización nos pac copilot pull que dependen.pac copilot push Os ficheiros do axente escríbense nun subcartafol chamado polo seu nome de visualización.

Exemplo

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

Parámetros requiridos para copilot clone

--bot -id

O ID do Copilot ou o nome do esquema (nome único que se atopa nos detalles do bot ou o nome do ficheiro no explorador de solucións).

Parámetros opcionais para copilot clone

--component-collection -cc

ID de colección de compoñentes para clonar. Repíteo por varios.

--display-name -dn

Nome de mostrar do axente (usado para nomear cartafoles).

--environment -env

Especifica o Dataverse de destino. O valor pode ser un Guid ou un URL https absoluto. Cando non se especifique, utilizarase a organización activa seleccionada para o perfil de autenticación actual.

--output-dir -od

Carpeta raíz para a saída do clon. Por defecto o directorio actual.

Observacións

• --botacepta un ID de Copilot ou nome de esquema. Pasa ou ben o ID do Copilot (un GUID) ou o nome do esquema do axente. O comando resolve un nome de esquema contra o entorno obxectivo.
• A subcarpeta de destino debe estar baleira. Clone escribe nunha carpeta nomeada segundo o nome de visualización (sanitizado) do axente baixo --output-dir. Se esa carpeta xa contén ficheiros, clone para en vez de sobrescribilos. Úsase --display-name para escoller outro nome de carpeta.
• Clonando coleccións de compoñentes. Para baixar as coleccións de compoñentes xunto co axente, pasa un ou máis IDs de colección con --component-collection, separados por puntos e coma.
• Clone require un perfil autenticado (pac auth create) e resolve o entorno desde --environment, ou desde a organización do perfil activo cando o omites.

pac copilot create

Crea un novo copiloto usando un ficheiro modelo existente como referencia.

Parámetros requiridos para copilot create

--displayName

O nome de visualización do novo copiloto

--schemaName

O nome do esquema (nome único) do novo copiloto.

--solution -s

Nome da solución.

--templateFileName

Ficheiro yaml fonte que contén o modelo de copiloto que foi extraído usando o comando extract-template.

Parámetros opcionais para copilot create

--environment -env

Especifica o Dataverse de destino. O valor pode ser un Guid ou un URL https absoluto. Cando non se especifique, utilizarase a organización activa seleccionada para o perfil de autenticación actual.

pac copilot delete

Elimina un Copilot personalizado.

Parámetros requiridos para copilot delete

--bot -id

O ID do Copilot ou o nome do esquema (nome único que se atopa nos detalles do bot ou o nome do ficheiro no explorador de solucións).

Parámetros opcionais para copilot delete

--confirm -y

Requírese para confirmar a eliminación do copiloto.

Este parámetro non precisa de valor. É un cambio.

--environment -env

Especifica o Dataverse de destino. O valor pode ser un Guid ou un URL https absoluto. Cando non se especifique, utilizarase a organización activa seleccionada para o perfil de autenticación actual.

pac copilot extract-template

Extrae un ficheiro modelo dun copiloto existente nun ambiente.

Exemplo

Este comando extrae un ficheiro modelo dun copiloto existente nun ambiente.

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

O comando devolve unha saída como a seguinte para un copiloto usando os idiomas inglés e alemán:

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

Parámetros requiridos para copilot extract-template

--bot -id

O ID do Copilot ou o nome do esquema (nome único que se atopa nos detalles do bot ou o nome do ficheiro no explorador de solucións).

--templateFileName

Localización do ficheiro yaml no que escribir o modelo do copiloto.

Parámetros opcionais para copilot extract-template

--environment -env

Especifica o Dataverse de destino. O valor pode ser un Guid ou un URL https absoluto. Cando non se especifique, utilizarase a organización activa seleccionada para o perfil de autenticación actual.

--overwrite -o

Permite sobrescribir o ficheiro de datos de saída se xa existe.

Este parámetro non precisa de valor. É un cambio.

--templateName

Nome do modelo ou 'kickStartTemplate' se non se especifica o nome.

--templateVersion

Versión do modelo en formato X.X.X ou 1.0.0 se non se especifica a versión.

pac copilot extract-translation

Extrae o ficheiro que contén contido localizado para un ou máis bots.

Exemplo

Este comando extrae un ficheiro que contén contido localizado para un ou máis copilotos.

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

O comando devolve unha saída como a seguinte:

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

Parámetros opcionais para copilot extract-translation

--all -a

Escribe ficheiros de localización para todos os idiomas soportados. Por defecto, só se escribe o idioma principal.

Este parámetro non precisa de valor. É un cambio.

--bot -id

O ID do Copilot ou o nome do esquema (nome único que se atopa nos detalles do bot ou o nome do ficheiro no explorador de solucións).

--environment -env

Especifica o Dataverse de destino. O valor pode ser un Guid ou un URL https absoluto. Cando non se especifique, utilizarase a organización activa seleccionada para o perfil de autenticación actual.

--format

Formato de ficheiro no que escribir ficheiros localizados, xa sexa "resx" ou "json". O valor predeterminado é "resx".

--outdir

O directorio de saída no que escribir.

--overwrite -o

Permite sobrescribir o ficheiro de datos de saída se xa existe.

Este parámetro non precisa de valor. É un cambio.

--sourcedir -src

Directorio de solucións fonte. Cando se especifica, ignorará o ambiente conectado ao buscar bots e no seu lugar buscará contido no cartafol da solución.

pac copilot init

Crea un novo espazo de traballo de axente de Copilot Studio a partir dunha plantilla.

pac copilot initEstrutura un novo espazo de traballo de axente de Copilot Studio a partir dunha plantilla. Funciona nun dos dous modos, e a presenza de --environment decide cal modo usar:

• Andamios locais — non --environment. Escribe os ficheiros plantilla no directorio do proxecto e para. O comando non crea nada en Dataverse e non require iniciar sesión. Usa este modo cando queiras crear localmente e conectarte a un entorno máis adiante.
• Bootstrap — --environment proporcionado. Estrutura os ficheiros, impácaos nunha solución, importa esa solución ao entorno e conecta o espazo de traballo co axente recentemente creado. Este modo é o camiño dun só paso desde a nada ata un axente en directo e listo para sincronización, e require un perfil autenticado.

Exemplos

Estrutura un espazo de traballo localmente:

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

Andamiar e crear un axente en directo nun só paso:

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

Estrutura un axente creado por CLI (CliCopilot) nun cartafol específico:

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

Parámetros requiridos para copilot init

--name -n

Nome para mostrar o axente.

--publisher-prefix -pp

Prefixo de personalización do Publisher para a solución.

Parámetros opcionais para copilot init

--authoring-mode -am

O axente que crea a forma para andamiar (por defecto: 'clásico'). Usa 'cli-copilot' para apoiar un axente CliCopilot creado por CLI.

--environment -env

Especifica o Dataverse de destino. O valor pode ser un Guid ou un URL https absoluto. Cando non se especifique, utilizarase a organización activa seleccionada para o perfil de autenticación actual.

--instructions -ins

Instrucións do sistema de axentes.

--project-dir -pd

Directorio obxectivo para o espazo de traballo do axente. Por defecto o directorio actual.

--schema-name -sn

Nome completo do esquema do axente. Anula a derivación predeterminada ({publisher-prefix}_{sanitized-name}). Usei as-is sen modificacións.

--template -t

Nome do perfil da plantilla (por defecto, mínimo). Por defecto é 'predeterminado'.

Observacións

• O directorio do proxecto debe estar baleiro. init Non pasa por riba de ficheiros existentes, así que apunta --project-dir a unha carpeta nova ou baleira.
• Derivación do nome do esquema. Cando omites --schema-name, o nome do esquema do axente constrúese como {publisher-prefix}_{sanitized-name}. Pass --schema-name para definilo explicitamente; o valor úsase as-is.
• Bootstrap funciona para ambos modos de autoría. init --environment Arranca un axente en directo nun só paso para o modo clásico predeterminado e para --authoring-mode cli-copilot. Como alternativa a un axente CliCopilot, podes andamiar localmente (non --environment), logo executar pac copilot pack e pac solution import logo despregalo ti mesmo.
• Bootstrap crea obxectos do lado do servidor. En modo arranque, init importa unha solución e crea o axente no entorno de destino. Se un axente co mesmo nome de esquema xa existe, init para e apunta a pac copilot clone que te conectes co axente existente en vez diso.
• Un ambiente novo pode tardar en aceptar a primeira importación. Un ambiente recentemente creado pode tardar un ou dous minutos en quentarse. Un bootstrap inicial pode fallar con "As operacións asincrónicas están actualmente desactivadas para esta organización." Agarda un momento e volve executalo.
• --template (default ou minimal) aplícase só ao modo clásico de autoría.

pac copilot list

Lista de copilots no entorno actual ou de destino de Dataverse.

Exemplo

Este comando lista todos os copilots na contorna actual ou de destino de Dataverse.

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

O comando devolve unha saída como a seguinte:

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

Parámetros opcionais para copilot list

--environment -env

Especifica o Dataverse de destino. O valor pode ser un Guid ou un URL https absoluto. Cando non se especifique, utilizarase a organización activa seleccionada para o perfil de autenticación actual.

pac copilot mcp

Información sobre o servidor local MCP (Model Context Protocol).

Exemplo

pac copilot mcp --run

Parámetros opcionais para copilot mcp

--run -r

Executa o servidor local MCP (Model Context Protocol).

Este parámetro non precisa de valor. É un cambio.

Observacións

Aprende a usar a CLI de Power Platform cun servidor MCP integrado

pac copilot merge-translation

Fusionar ficheiros que conteñan contido localizado para un ou máis bots.

Exemplo

Este comando fusiona ficheiros que conteñen contido localizado para un ou máis copilotos.

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

O comando devolve unha saída como a seguinte ao actualizar o idioma alemán:

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.

Aprende sobre como xestionar erros a partir do comando merge-translation

Parámetros opcionais para copilot merge-translation

--environment -env

Especifica o Dataverse de destino. O valor pode ser un Guid ou un URL https absoluto. Cando non se especifique, utilizarase a organización activa seleccionada para o perfil de autenticación actual.

--file -f

Lista de ficheiros que conteñen traducións. Os patróns globais están soportados.

--solution -s

Nome da solución.

--sourcedir -src

Directorio de solucións fonte. Cando se especifica, ignorará o ambiente conectado ao buscar bots e no seu lugar buscará contido no cartafol da solución.

--verbose

Emite máis información de diagnóstico durante a importación/exportación de datos

Este parámetro non precisa de valor. É un cambio.

--whatif

Non executa o comando, pero mostra os detalles do que sucedería.

Este parámetro non precisa de valor. É un cambio.

Erros de tradución de fusión

Baseándose no exemplo anterior, se existe un erro no ficheiro usado para actualizar o copiloto, a saída parece así:

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.

A --verbose bandeira engade detalles sobre o erro:

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

Modelos de construción de intelixencia artificial no entorno actual.

Exemplo

Este comando enumera todos os modelos de AI Builder.

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

O comando devolve unha saída como a seguinte:

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

Parámetros opcionais para copilot model list

--environment -env

Especifica o Dataverse de destino. O valor pode ser un Guid ou un URL https absoluto. Cando non se especifique, utilizarase a organización activa seleccionada para o perfil de autenticación actual.

pac copilot model predict

Envía texto ou solicitude ao modelo de IA

Parámetros opcionais para copilot model predict

--environment -env

Especifica o Dataverse de destino. O valor pode ser un Guid ou un URL https absoluto. Cando non se especifique, utilizarase a organización activa seleccionada para o perfil de autenticación actual.

--model-id -id

Id do modelo de AI Builder

--model-name -n

Nome do modelo de IA completo ou parcial

--prompt -p

Solicitude de envío ao modelo de IA

--text -t

Texto para enviar ao modelo de IA

pac copilot model prepare-fetch

Toma o ficheiro FetchXML do AI Large Language Model (LLM) e prepárao para a súa execución no ambiente actual.

Parámetros requiridos para copilot model prepare-fetch

--inputFile -i

Ficheiro FetchXML de entrada que normalmente provén de AI LLM.

--outputFile -o

Saída do ficheiro FetchXML que está listo para executarse no ambiente actual.

Parámetros opcionais para copilot model prepare-fetch

--environment -env

Especifica o Dataverse de destino. O valor pode ser un Guid ou un URL https absoluto. Cando non se especifique, utilizarase a organización activa seleccionada para o perfil de autenticación actual.

pac copilot pack

Empaqueta un espazo de traballo de axente de Copilot Studio nun arquivo zip da solución.

pac copilot pack empaqueta un espazo de traballo de axente nunha solución .zip Dataverse que podes despregar con pac solution import. É a forma independente do paso de empaquetado que pac copilot init --environment se executa para ti, para que poidas producir a solución despregable como un paso separado — por exemplo, nun pipeline de compilación. Funciona tanto para espazos de traballo clásicos como para axentes creados por LI (CliCopilot).

Exemplo

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

Parámetros requiridos para copilot pack

--publisher-prefix -pp

Prefixo de personalización do Publisher para a solución.

Parámetros opcionais para copilot pack

--output-path -op

Ruta de saída para o ficheiro zip da solución. Por defecto o directorio actual.

--project-dir -pd

Directorio do espazo de traballo do axente para paquetar. Por defecto o directorio actual.

--solution-name -sn

Solución nome único. Se se omite, deriva do nome do esquema do axente.

Observacións

• É unha operación local. Pack le o espazo de traballo e escribe unha solución .zip. Non precisa autenticación nin ambiente, polo que é seguro executalo nunha pipeline de compilación.
• O prefixo editor debe ser válido. --publisher-prefix Debe haber un prefixo de personalización ben formado, ou que se paren antes de escribir nada.
• Nome e saída da solución. Se omites --solution-name, o nome único da solución deriva do nome do esquema do axente. O .zip está escrito no directorio actual a menos que configures --output-path.
• A mochila non se desprega. Produce a solución pero non a importa. Segue para pac solution import despregar o axente, e se pac copilot clone queres un espazo de traballo sincronizado para el.

pac copilot publish

Publicar un copiloto personalizado

Parámetros requiridos para copilot publish

--bot -id

O ID do Copilot ou o nome do esquema (nome único que se atopa nos detalles do bot ou o nome do ficheiro no explorador de solucións).

Parámetros opcionais para copilot publish

--environment -env

Especifica o Dataverse de destino. O valor pode ser un Guid ou un URL https absoluto. Cando non se especifique, utilizarase a organización activa seleccionada para o perfil de autenticación actual.

pac copilot pull

Extrae cambios remotos de Copilot Studio e mestúraos co espazo de traballo local.

O pac copilot pull comando obtén o estado actual do servidor do axente e mestúrao no teu espazo de traballo local mediante unha fusión a tres bandas. Este proceso garante que as edicións do lado do servidor e os teus ficheiros locais intactos permanezan intactos. Executa antes de comezar a editar, e volve executalo antes de enviar os cambios.

Exemplo

Executa o comando desde dentro da carpeta do espazo de traballo:

pac copilot pull

Ou apunta a un espazo de traballo noutro lugar do disco:

pac copilot pull --project-dir contoso-support

Parámetros opcionais para copilot pull

--project-dir -pd

Camiño ao directorio do proxecto. Por defecto é o directorio de traballo actual.

Observacións

• Executa dentro dun espazo de traballo sincronizado. O pull comando só funciona nunha carpeta creada por pac copilot clone ou pac copilot init. Le o entorno de destino e o axente dos metadatos de sincronización do espazo de traballo, por iso non --environment hai discusión. Se o executas noutro lugar, falla cun erro de "espazo de traballo non atopado".
• Escribe nos teus ficheiros locais. Pull fusiona cambios remotos no espazo de traballo e descarga ficheiros de coñecemento. Comprométete ou respalda traballos locais que che importen antes de retirar.
• Inicia sesión primeiro con pac auth create.

pac copilot push

Empuxa os cambios do espazo de traballo local a Copilot Studio.

pac copilot push envía os cambios no teu espazo de traballo local de volta ao axente en Dataverse. Compara os teus ficheiros co último estado coñecido do servidor, sobe só o que cambiou - incluíndo ficheiros de coñecemento, fluxos na nube e referencias de conexión - e informa do que enviou.

Exemplo

Executa desde dentro da carpeta do espazo de traballo:

pac copilot push

Ou apunta a un espazo de traballo noutro lugar do disco:

pac copilot push --project-dir contoso-support

Parámetros opcionais para copilot push

--project-dir -pd

Camiño ao directorio do proxecto. Por defecto é o directorio de traballo actual.

Observacións

• Executa dentro dun espazo de traballo sincronizado. Por exemplo pull, push só funciona nunha carpeta creada por pac copilot clone ou pac copilot init. Le o entorno destino a partir dos metadatos de sincronización do espazo de traballo. Non hai --environment discusión.
• Tira primeiro se hai un conflito. Se o mesmo elemento cambiou tanto localmente como no servidor, o push detense e pídeche que executes pac copilot pull antes de probar de novo. Este proceso evita que un push sobrescriba silenciosamente un cambio do lado do servidor que non viste.
• Non ter cambios locais é un no-op. Se o push non atopa nada que enviar, informa e sae sen tocar o ambiente.
• Un impulso exitoso muta o axente vivo no ambiente obxectivo.
• Inicia sesión primeiro con pac auth create.

pac copilot quarantine

Estado de corentena do axente copiloto.

Parámetros requiridos para copilot quarantine

--bot-id -id

O ID do copiloto para poñer en corentena/des-corentena.

Parámetros opcionais para copilot quarantine

--environment -env

Entorno (ID, ID da organización, url, nome único ou nome parcial).

--status -s

Valor de estado de corentena. verdadeiro = corentena, falso = descorentena. Por defecto é verdadeiro.

Este parámetro non precisa de valor. É un cambio.

pac copilot status

Enquisa o estado de implementación dun copiloto especificado no entorno actual ou de destino de Dataverse.

Exemplo

Este comando sonda o estado de despregamento dun copiloto especificado no ambiente actual ou de destino de Dataverse.

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

O comando devolve unha saída como a seguinte:

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

Parámetros requiridos para copilot status

--bot-id -id

Identificación dun copiloto (chatbot).

Parámetros opcionais para copilot status

--environment -env

Especifica o Dataverse de destino. O valor pode ser un Guid ou un URL https absoluto. Cando non se especifique, utilizarase a organización activa seleccionada para o perfil de autenticación actual.

Autenticación e ambiente para os comandos de sincronización

Os clonecomandos , pull, push, e init --environment comunícanse todos cun entorno Dataverse, polo que necesitan un perfil de autenticación. Inicia sesión primeiro con pac auth create.

• clone, pull, e push requiren un perfil activo. pac copilot init Só se necesita un cando aprobas --environment; sen el, init os andamios pasan arquivos localmente e non precisan iniciar sesión.
• pull e push ler o entorno obxectivo dos metadatos sincronizados do espazo de traballo, para que non acepten un --environment argumento. clone E init faino.
• pac copilot pack é puramente local. Só le e escribe ficheiros, polo que non necesita autenticación nin entorno.

pull e push só funcionan dentro dun espazo de traballo creado por clone ou init. Os metadatos de sincronización escritos cando se crea o espazo de traballo son os que lles indican con que axente e entorno deben comunicarse, así que executalos noutro lugar falla rápido cun erro de "espazo de traballo non atopado".

Ver tamén

Microsoft Power Platform Grupos de Mando CLI
Microsoft Power Platform Visión xeral da CLI