Partage via

pac copilot

  • Article

Outils et utilitaires pour la gestion du copilote

Commandes

Command Description
création du copilote pac Crée un copilote à l’aide d’un fichier de modèle existant comme référence.
modèle d’extraction du copilote pac Extrait un fichier de modèle à partir d’un copilote existant dans un environnement.
extrait-traduction du copilote pac Extrait un fichier contenant du contenu localisé pour un ou plusieurs bots.
liste des copilotes du pac Liste de copilotes dans l’environnement Dataverse actuel ou cible.
fusion-traduction du copilote pac Fusionne des fichiers contenant du contenu localisé pour un ou plusieurs bots.
liste des modèles de copilote pac Modèles AI Builder dans l’environnement actuel.
modèle de copilote pac prédire Envoie du texte ou une invite au modèle d’IA
préparation-extraction du modèle de copilote pac Prend le fichier FetchXML du grand modèle de langage (LLM) d’IA et le prépare pour l’exécution dans l’environnement actuel.
copilote pac publier Publier un Copilot personnalisé
statut de copilote pac Interrogez le statut de déploiement d’un copilote spécifié dans l’environnement Dataverse actuel ou cible.

pac copilot create

Crée un copilote à l’aide d’un fichier de modèle existant comme référence.

Paramètres obligatoires pour copilot create

--displayName

Le nom complet du nouveau copilote

--schemaName

Nom du schéma (nom unique) du nouveau copilote.

--solution-s

Nom de la solution.

--templateFileName

Fichier yaml source contenant le modèle de copilote qui a été extrait à l’aide de la commande extract-template.

Paramètres facultatifs pour copilot create

--environment-env

Spécifie le Dataverse cible. La valeur peut être un GUID ou une URL https absolue. Lorsque la valeur n’est pas spécifiée, l’organisation active sélectionnée pour le profil d’authentification actuel sera utilisée.

pac copilot extract-template

Extrait un fichier de modèle à partir d’un copilote existant dans un environnement.

Exemple

Cette commande extrait un fichier de modèle d’un copilote existant dans un environnement.

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

La commande renvoie une sortie similaire à la suivante pour un copilote en utilisant les langues anglaise et allemande :

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

Paramètres obligatoires pour copilot extract-template

--bot-id

ID du copilote ou nom de schéma (nom unique trouvé dans les détails de bot ou nom de fichier dans l’explorateur de solutions).

--templateFileName

Emplacement du fichier yaml vers lequel écrire le modèle de copilote.

Paramètres facultatifs pour copilot extract-template

--environment-env

Spécifie le Dataverse cible. La valeur peut être un GUID ou une URL https absolue. Lorsque la valeur n’est pas spécifiée, l’organisation active sélectionnée pour le profil d’authentification actuel sera utilisée.

--overwrite-o

Autoriser le remplacement du fichier de données de sortie s’il existe déjà.

Ce paramètre ne requiert aucune valeur. C’est un commutateur.

pac copilot extract-translation

Extrait un fichier contenant du contenu localisé pour un ou plusieurs bots.

Exemple

Cette commande extrait un fichier contenant du contenu localisé pour un ou plusieurs copilotes.

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

La commande renvoie une sortie similaire à la suivante :

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

Paramètres facultatifs pour copilot extract-translation

--all-a

Écrivez des fichiers de localisation pour toutes les langues prises en charge. Par défaut, seule la langue principale est écrite.

Ce paramètre ne requiert aucune valeur. C’est un commutateur.

--bot-id

ID du copilote ou nom de schéma (nom unique trouvé dans les détails de bot ou nom de fichier dans l’explorateur de solutions).

--environment-env

Spécifie le Dataverse cible. La valeur peut être un GUID ou une URL https absolue. Lorsque la valeur n’est pas spécifiée, l’organisation active sélectionnée pour le profil d’authentification actuel sera utilisée.

--format

Le format de fichier dans lequel écrire les fichiers localisés, « resx » ou « json ». La valeur par défaut est « resx ».

--outdir

Répertoire de sortie dans lequel écrire.

--overwrite-o

Autoriser le remplacement du fichier de données de sortie s’il existe déjà.

Ce paramètre ne requiert aucune valeur. C’est un commutateur.

--sourcedir-src

Répertoire de la solution source. Lorsqu’il est spécifié, ce paramètre ignore l’environnement connecté lors de la recherche de bots et, à la place, recherche du contenu dans le dossier de la solution.

pac copilote list

Liste de copilotes dans l’environnement Dataverse actuel ou cible.

Exemple

Cette commande répertorie tous les copilotes dans l’environnement Dataverse actuel ou cible.

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

La commande renvoie une sortie similaire à la suivante :

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

Paramètres facultatifs pour copilot list

--environment-env

Spécifie le Dataverse cible. La valeur peut être un GUID ou une URL https absolue. Lorsque la valeur n’est pas spécifiée, l’organisation active sélectionnée pour le profil d’authentification actuel sera utilisée.

pac copilot merge-translation

Fusionne des fichiers contenant du contenu localisé pour un ou plusieurs bots.

Exemple

Cette commande fusionne des fichiers contenant du contenu localisé pour un ou plusieurs copilotes.

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

La commande renvoie une sortie similaire à la suivante lors de la mise à jour de la langue allemande :

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.

Découvrez comment gérer les erreurs à partir de la commande merge-translation

Paramètres facultatifs pour copilot merge-translation

--environment-env

Spécifie le Dataverse cible. La valeur peut être un GUID ou une URL https absolue. Lorsque la valeur n’est pas spécifiée, l’organisation active sélectionnée pour le profil d’authentification actuel sera utilisée.

--file-f

La liste de fichiers contenant des traductions. Les modèles Glob sont pris en charge.

--solution-s

Nom de la solution.

--sourcedir-src

Répertoire de la solution source. Lorsqu’il est spécifié, ce paramètre ignore l’environnement connecté lors de la recherche de bots et, à la place, recherche du contenu dans le dossier de la solution.

--verbose

Générer plus d’informations de diagnostic pendant l’importation ou l’exportation de données

Ce paramètre ne requiert aucune valeur. C’est un commutateur.

--whatif

N’exécute pas la commande, mais extrait les détails de ce qui se va se produire.

Ce paramètre ne requiert aucune valeur. C’est un commutateur.

Erreurs de merge-translation

En fonction de l’exemple ci-dessus, s’il existe une erreur dans le fichier utilisé pour mettre à jour le copilote, la sortie ressemble à ce qui suit :

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.

L’indicateur --verbose ajoute des détails sur l’erreur :

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

Modèles AI Builder dans l’environnement actuel.

Exemple

Cette commande répertorie tous les modèles AI Builder.

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

La commande renvoie une sortie similaire à la suivante :

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

Paramètres facultatifs pour copilot model list

--environment-env

Spécifie le Dataverse cible. La valeur peut être un GUID ou une URL https absolue. Lorsque la valeur n’est pas spécifiée, l’organisation active sélectionnée pour le profil d’authentification actuel sera utilisée.

pac copilot model predict

Envoie du texte ou une invite au modèle d’IA

Paramètres facultatifs pour copilot model predict

--environment-env

Spécifie le Dataverse cible. La valeur peut être un GUID ou une URL https absolue. Lorsque la valeur n’est pas spécifiée, l’organisation active sélectionnée pour le profil d’authentification actuel sera utilisée.

--model-id-id

ID du modèle AI Builder

--model-name-n

Nom complet ou partiel du modèle IA

--prompt-p

Invite à envoyer au modèle d’IA

--text-t

Texte à envoyer au modèle d’IA

pac copilot model prepare-fetch

Prend le fichier FetchXML du grand modèle de langage (LLM) d’IA et le prépare pour l’exécution dans l’environnement actuel.

Paramètres obligatoires pour copilot model prepare-fetch

--inputFile-i

Fichier FetchXML d’entrée qui provient généralement du LLM d’AI.

--outputFile-o

Fichier FetchXML de sortie qui est prêt à s’exécuter dans l’environnement actuel.

Paramètres facultatifs pour copilot model prepare-fetch

--environment-env

Spécifie le Dataverse cible. La valeur peut être un GUID ou une URL https absolue. Lorsque la valeur n’est pas spécifiée, l’organisation active sélectionnée pour le profil d’authentification actuel sera utilisée.

pac copilot publish

Publier un Copilot personnalisé

Paramètres obligatoires pour copilot publish

--bot-id

ID du copilote ou nom de schéma (nom unique trouvé dans les détails de bot ou nom de fichier dans l’explorateur de solutions).

Paramètres facultatifs pour copilot publish

--environment-env

Spécifie le Dataverse cible. La valeur peut être un GUID ou une URL https absolue. Lorsque la valeur n’est pas spécifiée, l’organisation active sélectionnée pour le profil d’authentification actuel sera utilisée.

pac copilot status

Interrogez le statut de déploiement d’un copilote spécifié dans l’environnement Dataverse actuel ou cible.

Exemple

Cette commande interroge le statut de déploiement d’un copilote spécifié dans l’environnement Dataverse actuel ou cible.

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

La commande renvoie une sortie similaire à la suivante :

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

Paramètres obligatoires pour copilot status

--bot-id-id

ID d’un copilote (chatbot).

Paramètres facultatifs pour copilot status

--environment-env

Spécifie le Dataverse cible. La valeur peut être un GUID ou une URL https absolue. Lorsque la valeur n’est pas spécifiée, l’organisation active sélectionnée pour le profil d’authentification actuel sera utilisée.

Voir aussi

Microsoft Power Platform Groupes de commandes CLI
Microsoft Power Platform Présentation de la CLI