pac copilot

Herramientas y utilidades para la administración de copilot.

Los initcomandos , clone, pull, pushy pack permiten mantener un agente de Copilot Studio como un conjunto de archivos en el disco, editarlo localmente y sincronizarlo con un entorno de Dataverse.

Un bucle típico tiene este aspecto:

1. Inicie un área de trabajo. Aplique scaffolding a un agente nuevo con pac copilot inito descargue uno existente con pac copilot clone. En cualquier caso, obtenga un área de trabajo local que lleve los metadatos de sincronización de los que dependen los demás comandos.
2. Extraiga antes de editar. pac copilot pull reduce los cambios remotos y los combina en los archivos locales, por lo que se inicia desde el estado actual del servidor.
3. Cuando haya terminado. pac copilot push devuelve los cambios locales. Si el mismo elemento cambió en el servidor mientras tanto, la inserción se detiene y le pide que extraiga primero.
4. Paquete para la implementación. pac copilot pack convierte un área de trabajo en una solución .zip que puede implementar con pac solution import.

Para pasar de nada a un agente activo en un solo paso, pac copilot init --environment scaffoldings, paquetes, importaciones y conecta el área de trabajo automáticamente. Los comandos individuales permiten controlar cada parte del bucle por sí solo.

Commands

pac copilot clone

Clone un agente de Copilot Studio en un directorio del área de trabajo local.

pac copilot clonedescarga un agente de Copilot Studio existente en un directorio del área de trabajo local, junto con los metadatos de sincronización que pac copilot pull y pac copilot push se basan en . Los archivos del agente se escriben en una subcarpeta denominada después de su nombre para mostrar.

Example

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

Parámetros necesarios para copilot clone

--bot -id

El id. o el nombre de esquema del copiloto (nombre único que se encuentra en Detalles del bot o nombre de archivo en el explorador de soluciones).

Parámetros opcionales para copilot clone

--component-collection -cc

Identificador de colección de componentes que se va a clonar. Repita la repetición para varios.

--display-name -dn

Nombre para mostrar del agente (se usa para la nomenclatura de carpetas).

--environment -env

Especifica el Dataverse de destino. El valor puede ser una URL de Guid o HTTPS absoluta. Si no se especifica, se utilizará la organización activa seleccionada para el perfil de autenticación actual.

--output-dir -od

Carpeta raíz para la salida clonada. El valor predeterminado es el directorio actual.

Remarks

• --botacepta un identificador de Copilot o un nombre de esquema. Pase el identificador de Copilot (un GUID) o el nombre de esquema del agente. El comando resuelve un nombre de esquema en el entorno de destino.
• La subcarpeta de destino debe estar vacía. Clone las escrituras en una carpeta denominada después del nombre para mostrar del agente (saneado) en --output-dir. Si esa carpeta ya contiene archivos, el clon se detiene en lugar de sobrescribirlos. Use --display-name para elegir otro nombre de carpeta.
• Clonación de colecciones de componentes. Para reducir las colecciones de componentes junto con el agente, pase uno o varios identificadores de colección con --component-collection, separados por punto y coma.
• Clonar requiere un perfil autenticado (pac auth create) y resuelve el entorno de --environment, o de la organización del perfil activo al omitirlo.

pac copilot create

Crea un nuevo copiloto usando un archivo de plantilla existente como referencia.

Parámetros necesarios para copilot create

--displayName

El nombre para mostrar del copiloto nuevo

--schemaName

El nombre de esquema (nombre único) del nuevo copiloto.

--solution -s

Nombre de la solución.

--templateFileName

Archivo yaml de origen que contiene la plantilla de copiloto que se extrajo mediante el comando extract-template.

Parámetros opcionales para copilot create

--environment -env

Especifica el Dataverse de destino. El valor puede ser una URL de Guid o HTTPS absoluta. Si no se especifica, se utilizará la organización activa seleccionada para el perfil de autenticación actual.

pac copilot delete

Elimine un Copilot personalizado.

Parámetros necesarios para copilot delete

--bot -id

El id. o el nombre de esquema del copiloto (nombre único que se encuentra en Detalles del bot o nombre de archivo en el explorador de soluciones).

Parámetros opcionales para copilot delete

--confirm -y

Necesario para confirmar la eliminación del copiloto.

Este parámetro no requiere ningún valor. Es un modificador.

--environment -env

Especifica el Dataverse de destino. El valor puede ser una URL de Guid o HTTPS absoluta. Si no se especifica, se utilizará la organización activa seleccionada para el perfil de autenticación actual.

pac copilot extract-template

Extrae un archivo de plantilla de un copiloto existente en un entorno.

Example

Este comando extrae un archivo de plantilla de un copiloto existente en un entorno.

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

El comando devuelve un resultado como el siguiente para un copiloto que utiliza los idiomas inglés y 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 necesarios para copilot extract-template

--bot -id

El id. o el nombre de esquema del copiloto (nombre único que se encuentra en Detalles del bot o nombre de archivo en el explorador de soluciones).

--templateFileName

Ubicación del archivo yaml en el que se va a escribir la plantilla de copiloto.

Parámetros opcionales para copilot extract-template

--environment -env

Especifica el Dataverse de destino. El valor puede ser una URL de Guid o HTTPS absoluta. Si no se especifica, se utilizará la organización activa seleccionada para el perfil de autenticación actual.

--overwrite -o

Permita la sobrescritura del archivo de datos de salida si ya existe.

Este parámetro no requiere ningún valor. Es un modificador.

--templateName

Nombre de la plantilla o 'kickStartTemplate' si no se especifica el nombre.

--templateVersion

Versión de la plantilla en formato X.X.X o 1.0.0 si no se especifica la versión.

pac copilot extract-translation

Extrae el archivo que incluye contenido localizado para uno o más bots.

Example

Este comando extrae un archivo que contiene contenido localizado para uno o más copilotos.

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

El comando devuelve una salida como la siguiente:

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 opcionales para copilot extract-translation

--all -a

Escriba archivos de localización para todos los idiomas admitidos. De forma predeterminada, solo se escribe el idioma principal.

Este parámetro no requiere ningún valor. Es un modificador.

--bot -id

El id. o el nombre de esquema del copiloto (nombre único que se encuentra en Detalles del bot o nombre de archivo en el explorador de soluciones).

--environment -env

Especifica el Dataverse de destino. El valor puede ser una URL de Guid o HTTPS absoluta. Si no se especifica, se utilizará la organización activa seleccionada para el perfil de autenticación actual.

--format

El formato de archivo en el que escribir archivos localizados, ya sea 'resx' o 'json'. La opción predeterminada es 'resx'.

--outdir

El directorio de salida en el que se va a escribir.

--overwrite -o

Permita la sobrescritura del archivo de datos de salida si ya existe.

Este parámetro no requiere ningún valor. Es un modificador.

--sourcedir -src

Directorio de solución de origen. Cuando se especifica, ignorará el entorno conectado al buscar bots y, en su lugar, buscará contenido en la carpeta de la solución.

pac copilot init

Cree un área de trabajo del agente de Copilot Studio a partir de una plantilla.

pac copilot initaplica scaffolding a un nuevo área de trabajo del agente de Copilot Studio desde una plantilla. Se ejecuta en uno de los dos modos y la presencia de --environment decide qué modo usar:

• Scaffold local : no --environment. Escribe los archivos de plantilla en el directorio del proyecto y se detiene. El comando no crea nada en Dataverse y no requiere inicio de sesión. Use este modo cuando quiera crear localmente y conectarse a un entorno más adelante.
• Bootstrap : --environment suministrado. Aplica scaffolding a los archivos, los empaqueta en una solución, importa esa solución en el entorno y conecta el área de trabajo al agente recién creado. Este modo es la ruta de acceso de un solo paso de nada a un agente activo, listo para sincronización y requiere un perfil autenticado.

Examples

Aplicar scaffolding a un área de trabajo localmente:

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

Aplicar scaffolding y arrancar un agente activo en un entorno en un solo paso:

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

Aplicar scaffolding a un agente creado por la CLI (CliCopilot) en una carpeta específica:

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

Parámetros necesarios para copilot init

--name -n

Nombre para mostrar del agente.

--publisher-prefix -pp

Publisher prefijo de personalización para la solución.

Parámetros opcionales para copilot init

--authoring-mode -am

Forma de creación del agente en scaffolding (valor predeterminado: "clásico"). Use "cli-copilot" para aplicar scaffolding a un agente de CliCopilot creado por la CLI.

--environment -env

Especifica el Dataverse de destino. El valor puede ser una URL de Guid o HTTPS absoluta. Si no se especifica, se utilizará la organización activa seleccionada para el perfil de autenticación actual.

--instructions -ins

Instrucciones del sistema del agente.

--project-dir -pd

Directorio de destino para el área de trabajo del agente. El valor predeterminado es el directorio actual.

--schema-name -sn

Nombre completo del esquema del agente. Invalida la derivación predeterminada ({publisher-prefix}_{sanitized-name}). Se usa as-is sin modificaciones.

--template -t

Nombre del perfil de plantilla (valor predeterminado, mínimo). El valor predeterminado es "default".

Remarks

• El directorio del proyecto debe estar vacío. init no aplica scaffolding a los archivos existentes, por lo que apunta --project-dir a una carpeta nueva o vacía.
• Derivación de nombres de esquema. Cuando se omite --schema-name, el nombre del esquema del agente se compila como {publisher-prefix}_{sanitized-name}. Pase --schema-name para establecerlo explícitamente; el valor se usa as-is.
• Bootstrap funciona para ambos modos de creación. init --environment arranca un agente activo en un paso para el modo clásico predeterminado y para --authoring-mode cli-copilot. Como alternativa a un agente de CliCopilot, puede aplicar scaffolding localmente (sin --environment), y luego ejecutarlo pac copilot pack seguido de pac solution import para implementarlo usted mismo.
• Bootstrap crea objetos del lado servidor. En el modo de arranque, init importa una solución y crea el agente en el entorno de destino. Si ya existe un agente con el mismo nombre de esquema, init se detiene y le apunta a pac copilot clone conectarse al agente existente en su lugar.
• Un entorno nuevo puede ser lento para aceptar la primera importación. Un entorno recién creado puede tardar un minuto o dos en calentarse. Un arranque anticipado puede producir un error con "Las operaciones asincrónicas están deshabilitadas actualmente para esta organización". Espere un momento y ejecútelo de nuevo.
• --template (default o minimal) solo se aplica al modo de creación clásico.

pac copilot list

Lista de copilotos en el entorno de Dataverse actual o de destino.

Example

Este comando enumera todos los copilotos en el entorno Dataverse actual o de destino.

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

El comando devuelve una salida como la siguiente:

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 opcionales para copilot list

--environment -env

Especifica el Dataverse de destino. El valor puede ser una URL de Guid o HTTPS absoluta. Si no se especifica, se utilizará la organización activa seleccionada para el perfil de autenticación actual.

pac copilot mcp

Información sobre el servidor LOCAL MCP (Protocolo de contexto de modelo).

Example

pac copilot mcp --run

Parámetros opcionales para copilot mcp

--run -r

Ejecute el servidor local MCP (Protocolo de contexto de modelo).

Este parámetro no requiere ningún valor. Es un modificador.

Remarks

Aprenda a usar la CLI de Power Platform con un servidor MCP integrado

pac copilot merge-translation

Combina archivos que incluyen contenido localizado para uno o más bots.

Example

Este comando combina los archivos que contienen contenido localizado para uno o más copilotos.

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

El comando devuelve un resultado como el siguiente al actualizar el 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.

Obtenga información sobre cómo gestionar errores desde el comando merge-translation

Parámetros opcionales para copilot merge-translation

--environment -env

Especifica el Dataverse de destino. El valor puede ser una URL de Guid o HTTPS absoluta. Si no se especifica, se utilizará la organización activa seleccionada para el perfil de autenticación actual.

--file -f

La lista de archivos que contienen traducciones. Se admiten patrones globales.

--solution -s

Nombre de la solución.

--sourcedir -src

Directorio de solución de origen. Cuando se especifica, ignorará el entorno conectado al buscar bots y, en su lugar, buscará contenido en la carpeta de la solución.

--verbose

Genere más información de diagnóstico durante la importación y exportación de datos

Este parámetro no requiere ningún valor. Es un modificador.

--whatif

No ejecuta el comando, pero genera los detalles de lo que ocurriría si se ejecutara.

Este parámetro no requiere ningún valor. Es un modificador.

errores de merge-translation

Según el ejemplo anterior, si existe un error en el archivo utilizado para actualizar el copiloto, el resultado será el siguiente:

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.

La bandera --verbose añade detalles sobre el error:

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 AI Builder en el entorno actual.

Example

Este comando enumera todos los modelos AI Builder .

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

El comando devuelve una salida como la siguiente:

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 opcionales para copilot model list

--environment -env

Especifica el Dataverse de destino. El valor puede ser una URL de Guid o HTTPS absoluta. Si no se especifica, se utilizará la organización activa seleccionada para el perfil de autenticación actual.

pac copilot model predict

Envía texto o una solicitud al modelo de IA

Parámetros opcionales para copilot model predict

--environment -env

Especifica el Dataverse de destino. El valor puede ser una URL de Guid o HTTPS absoluta. Si no se especifica, se utilizará la organización activa seleccionada para el perfil de autenticación actual.

--model-id -id

Id. de modelo de AI Builder

--model-name -n

Nombre total o parcial del modelo de IA

--prompt -p

Solicitud que se va a enviar al modelo de IA

--text -t

Texto que se va a enviar al modelo de IA

pac copilot model prepare-fetch

Toma el archivo FetchXML del modelo grande de lenguaje (LLM) IA y lo prepara para su ejecución en el entorno actual.

Parámetros necesarios para copilot model prepare-fetch

--inputFile -i

Introduzca el archivo FetchXML que generalmente proviene del LLM IA.

--outputFile -o

Archivo de salida de FetchXML que está listo para ejecutarse en el entorno actual.

Parámetros opcionales para copilot model prepare-fetch

--environment -env

Especifica el Dataverse de destino. El valor puede ser una URL de Guid o HTTPS absoluta. Si no se especifica, se utilizará la organización activa seleccionada para el perfil de autenticación actual.

pac copilot pack

Empaquete un área de trabajo del agente de Copilot Studio en un archivo ZIP de solución.

pac copilot pack empaqueta un área de trabajo del agente en una solución .zip de Dataverse que puede implementar con pac solution import. Es la forma independiente del paso de empaquetado que pac copilot init --environment se ejecuta automáticamente, por lo que puede generar la solución implementable como un paso independiente, por ejemplo, en una canalización de compilación. Funciona tanto para áreas de trabajo del agente clásicas como para las creadas por la CLI (CliCopilot).

Example

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

Parámetros necesarios para copilot pack

--publisher-prefix -pp

Publisher prefijo de personalización para la solución.

Parámetros opcionales para copilot pack

--output-path -op

Ruta de acceso de salida para el archivo ZIP de la solución. El valor predeterminado es el directorio actual.

--project-dir -pd

Directorio del área de trabajo del agente que se va a empaquetar. El valor predeterminado es el directorio actual.

--solution-name -sn

Nombre único de la solución. Si se omite, se deriva del nombre del esquema del agente.

Remarks

• Es una operación local. Pack lee el área de trabajo y escribe una solución .zip. No necesita autenticación ni entorno, por lo que es seguro ejecutarse en una canalización de compilación.
• El prefijo del publicador debe ser válido. --publisher-prefix debe ser un prefijo de personalización bien formado o dejar de empaquetar antes de escribir nada.
• Nombre y salida de la solución. Si omite --solution-name, el nombre único de la solución se deriva del nombre del esquema del agente. .zip se escribe en el directorio actual a menos que establezca --output-path.
• Pack no se implementa. Genera la solución, pero no la importa. Síguelo con pac solution import para implementar el agente y, después pac copilot clone , si desea un área de trabajo conectada a la sincronización.

pac copilot publish

Publicar un Copilot personalizado

Parámetros necesarios para copilot publish

--bot -id

El id. o el nombre de esquema del copiloto (nombre único que se encuentra en Detalles del bot o nombre de archivo en el explorador de soluciones).

Parámetros opcionales para copilot publish

--environment -env

Especifica el Dataverse de destino. El valor puede ser una URL de Guid o HTTPS absoluta. Si no se especifica, se utilizará la organización activa seleccionada para el perfil de autenticación actual.

pac copilot pull

Extraiga cambios remotos de Copilot Studio y combine con el área de trabajo local.

El pac copilot pull comando captura el estado actual del servidor del agente y lo combina en el área de trabajo local mediante una combinación triple. Este proceso garantiza que las modificaciones del lado servidor y los archivos locales intactos permanezcan intactos. Ejecútelo antes de empezar a editarlo y vuelva a ejecutarlo antes de insertar los cambios.

Example

Ejecute el comando desde dentro de la carpeta del área de trabajo:

pac copilot pull

O bien, apunte a un área de trabajo en otro lugar del disco:

pac copilot pull --project-dir contoso-support

Parámetros opcionales para copilot pull

--project-dir -pd

Ruta de acceso al directorio del proyecto. El valor predeterminado es el directorio de trabajo actual.

Remarks

• Ejecútelo dentro de un área de trabajo de sincronización. El pull comando solo funciona en una carpeta creada por pac copilot clone o pac copilot init. Lee el entorno de destino y el agente de los metadatos de sincronización del área de trabajo, por lo que no hay ningún --environment argumento. Si lo ejecuta en cualquier otro lugar, se produce un error de "área de trabajo no encontrada".
• Escribe en los archivos locales. La extracción combina cambios remotos en el área de trabajo y descarga archivos de conocimiento. Confirme o realice una copia de seguridad del trabajo local que le interesa antes de extraer.
• Inicie sesión primero con pac auth create.

pac copilot push

Inserte los cambios del área de trabajo local en Copilot Studio.

pac copilot push devuelve los cambios en el área de trabajo local al agente de Dataverse. Compara los archivos con el último estado de servidor conocido, solo carga lo que cambió, incluidos los archivos de conocimiento, los flujos de nube y las referencias de conexión, e informa de lo que insertó.

Example

Ejecútelo desde dentro de la carpeta del área de trabajo:

pac copilot push

O bien, apunte a un área de trabajo en otro lugar del disco:

pac copilot push --project-dir contoso-support

Parámetros opcionales para copilot push

--project-dir -pd

Ruta de acceso al directorio del proyecto. El valor predeterminado es el directorio de trabajo actual.

Remarks

• Ejecútelo dentro de un área de trabajo de sincronización. Al igual que pull, push solo funciona en una carpeta creada por pac copilot clone o pac copilot init. Lee el entorno de destino de los metadatos de sincronización del área de trabajo. No --environment hay ningún argumento.
• Tire primero si hay un conflicto. Si el mismo elemento cambió localmente y en el servidor, se detiene la inserción y le pide que se ejecute pac copilot pull antes de volver a intentarlo. Este proceso evita que una inserción sobrescriba de forma silenciosa un cambio del lado servidor que no vio.
• Ningún cambio local es un no-op. Si la inserción no encuentra nada que enviar, informa de que y sale sin tocar el entorno.
• Una inserción correcta muta el agente activo en el entorno de destino.
• Inicie sesión primero con pac auth create.

pac copilot quarantine

Estado de cuarentena del agente copiloto.

Parámetros necesarios para copilot quarantine

--bot-id -id

El ID del copiloto para poner en cuarentena/descuarentena.

Parámetros opcionales para copilot quarantine

--environment -env

Entorno (id., id. de organización, url, nombre único o nombre parcial).

--status -s

Valor de estado de cuarentena. verdadero = cuarentena, falso = descuarentena. El valor predeterminado es true.

Este parámetro no requiere ningún valor. Es un modificador.

pac copilot status

Sondee el estado de implementación de un copiloto especificado en el entorno de Dataverse actual o de destino.

Example

Este comando sondea el estado de implementación de un copiloto específico en el entorno Dataverse actual o de destino.

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

El comando devuelve una salida como la siguiente:

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 necesarios para copilot status

--bot-id -id

El id. de un copiloto (bot de chat).

Parámetros opcionales para copilot status

--environment -env

Especifica el Dataverse de destino. El valor puede ser una URL de Guid o HTTPS absoluta. Si no se especifica, se utilizará la organización activa seleccionada para el perfil de autenticación actual.

Autenticación y entorno para los comandos de sincronización

Todos clonelos comandos , pull, pushy init --environment hablan con un entorno de Dataverse, por lo que necesitan un perfil de autenticación. Inicie sesión primero con pac auth create.

• clone, pully push requieren un perfil activo. pac copilot init solo necesita uno cuando se pasa --environment; sin él, init aplica scaffolding a los archivos localmente y no necesita ningún inicio de sesión.
• pull y push lea el entorno de destino de los metadatos de sincronización del área de trabajo, por lo que no toman un --environment argumento. clone y init hacer.
• pac copilot pack es puramente local. Solo lee y escribe archivos, por lo que no necesita autenticación ni entorno.

pull y push solo funcionan dentro de un área de trabajo creada por clone o init. Los metadatos de sincronización escritos cuando se crea el área de trabajo son lo que les indica a qué agente y entorno comunicarse, por lo que ejecutarlos en cualquier otro lugar produce un error rápido con un error de "área de trabajo no encontrada".

Consulte también

Grupos de comandos de la CLI de Microsoft Power Platform
Visión general del CLI de Microsoft Power Platform