pac copilot
Herramientas y utilidades para la administración de copilotos
Comandos
| Command | Description |
|---|---|
| crear copiloto pac | Crea un nuevo copiloto usando un archivo de plantilla existente como referencia. |
| plantilla de extracción de copiloto pac | Extrae un archivo de plantilla de un copiloto existente en un entorno. |
| extracto-traducción de pac copilot | Extrae el archivo que incluye contenido localizado para uno o más bots. |
| lista de copilotos de pac | Lista de copilotos en el entorno de Dataverse actual o de destino. |
| traducción y fusión de copilotos pac | Combina archivos que incluyen contenido localizado para uno o más bots. |
| Lista de modelos de copiloto pac | Modelos de AI Builder en el entorno actual. |
| modelo de copiloto pac predictivo | Envía texto o una solicitud al modelo de IA |
| modelo de copiloto pac preparar-buscar | Toma el archivo FetchXML del modelo grande de lenguaje (LLM) IA y lo prepara para su ejecución en el entorno actual. |
| pac copiloto publicar | Publicar un Copilot personalizado |
| Estado de copiloto de pac | Sondee el estado de implementación de un copiloto especificado en el entorno de Dataverse actual o de destino. |
pac copilot create
Crea un nuevo copiloto usando un archivo de plantilla existente como referencia.
Parámetros requeridos para create del copiloto
--displayName
El nombre del nuevo copiloto
--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 create del copiloto
--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.
Ejemplo
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 requeridos para extract-template del copiloto
--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 extract-template del copiloto
--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.
pac copilot extract-translation
Extrae el archivo que incluye contenido localizado para uno o más bots.
Ejemplo
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 extract-translation del copiloto
--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 list
Lista de copilotos en el entorno de Dataverse actual o de destino.
Ejemplo
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 list del copiloto
--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 merge-translation
Combina archivos que incluyen contenido localizado para uno o más bots.
Ejemplo
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 del comando merge-translation
Parámetros opcionales para merge-translation del copiloto
--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.
Ejemplo
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 model list del copiloto
--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 model predict del copiloto
--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 requeridos para model prepare-fetch del copiloto
--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 model prepare-fetch del copiloto
--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 publish
Publicar un Copilot personalizado
Parámetros requeridos para la publicación del copiloto
--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 la publicación del copiloto
--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 status
Sondee el estado de implementación de un copiloto especificado en el entorno de Dataverse actual o de destino.
Ejemplo
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 requeridos para status del copiloto
--bot-id-id
El id. de un copiloto (bot de chat).
Parámetros opcionales para status del copiloto
--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.
Consulte también
Microsoft Power Platform Grupos de comandos de la CLI
Microsoft Power Platform Descripción general de CLI