Nota
O acceso a esta páxina require autorización. Pode tentar iniciar sesión ou modificar os directorios.
O acceso a esta páxina require autorización. Pode tentar modificar os directorios.
Ferramentas e utilidades para a xestión do copiloto
Comandos
| Comando | Descripción |
|---|---|
| Creación do copiloto PAC | Crea un novo copiloto usando un ficheiro modelo existente como referencia. |
| Modelo de extracción do copiloto pac | Extrae un ficheiro modelo dun copiloto existente nun ambiente. |
| Extracto-tradución do copiloto PAC | Extrae o ficheiro que contén contido localizado para un ou máis bots. |
| Lista de copiloto do PAC | Lista de copilots no entorno actual ou de destino de Dataverse. |
| Copiloto PAC MCP | Información sobre o servidor local MCP (Model Context Protocol). |
| Traslación de fusións do copiloto PAC | Fusionar ficheiros que conteñan contido localizado para un ou máis bots. |
| Lista de modelos de copiloto PAC | Modelos de construción de intelixencia artificial no entorno actual. |
| Modelo de COPID PAC Predict | Envía texto ou solicitude ao modelo de IA |
| Prepare-fetch do modelo de copiloto PAC | Toma o ficheiro FetchXML do AI Large Language Model (LLM) e prepárao para a súa execución no ambiente actual. |
| Publicación de COPID PAC | Publicar un copiloto personalizado |
| Estado do copiloto PAC | Enquisa o estado de implementación dun copiloto especificado no entorno actual ou de destino de Dataverse. |
Creación do copiloto PAC
Crea un novo copiloto usando un ficheiro modelo existente como referencia.
Parámetros necesarios para a creación do copiloto
--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 a creación do copiloto
--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.
Modelo de extracción do copiloto pac
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 o modelo de extracción do copiloto
--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 o modelo de extracción do copiloto
--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.
Extracto-tradución do copiloto PAC
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 a tradución de extractos do copiloto
--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.
Lista de copiloto do PAC
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 a lista de copiloto
--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.
Copiloto PAC MCP
Información sobre o servidor local MCP (Model Context Protocol).
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.
Traslación de fusións do copiloto PAC
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 a tradución de fusión do copiloto
--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.
Lista de modelos de copiloto PAC
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 a lista de modelos de copiloto
--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.
Modelo de COPID PAC Predict
Envía texto ou solicitude ao modelo de IA
Parámetros opcionais para a predición do modelo copiloto
--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
Prepare-fetch do modelo de copiloto PAC
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 o modelo copiloto 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 o modelo de copiloto 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.
Publicación de COPID PAC
Publicar un copiloto personalizado
Parámetros necesarios para a publicación do copiloto
--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 a publicación do copiloto
--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.
Estado do copiloto PAC
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 necesarios para o estado do copiloto
--bot-id
-id
Identificación dun copiloto (chatbot).
Parámetros opcionais para o estado do copiloto
--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.
Consulte tamén
Grupos de comandos da CLI de Microsoft Power Platform
Visión xeral da CLI de Microsoft Power Platform