Publier un assistant dans le centre d’administration Microsoft

Utilisez la commande a365 publish pour empaqueter votre assistant, puis téléchargez le package au Centre d’administration Microsoft 365. Après publication, vous pouvez créer des instances d’assistant au sein de votre organisation et gérer l’assistant.

Configuration requise

Avant de commencer, assurez-vous que vous avez les éléments suivants.

Comptes et autorisations requis

  • Locataire Microsoft 365 avec l’un des rôles suivants (requis pour l’étape de téléversement vers le Centre d’administration) :

    • Administrateur général

Outils requis

Étapes de configuration requises

Avant de publier, suivez ces étapes :

  1. Créer une Blueprint d’assistant - Suivez l’étape de configuration pour créer votre Blueprint d’assistant.
  2. Assistant testé localement : vérifiez que votre assistant fonctionne correctement avec Agents Playground (voir Tester des assistants localement).
  3. Préparer les fichiers de configuration : vérifiez que a365.config.json et a365.generated.config.json sont à jour.

Commande Publier

Exécutez la commande a365 publish :

a365 publish

Remarque

L’exécution de a365 publish -h affiche toutes les options que cette commande prend en charge.

Qu’est-ce que signifie la commande ?

  1. Mise à jour du manifeste - Mises à jour manifest.json avec votre ID de blueprint d’assistant.
  2. Créer un package - Packages manifest.json et icônes dans manifest.zip.
  3. Instructions d’impression - Affiche les instructions étape par étape pour le téléchargement via le Centre d’administration Microsoft 365.

Remarque

La commande a365 publish fonctionne aussi bien pour les assistants que pour les coéquipiers IA. Pour les assistants provisionnés à l’aide de --agent-name (sans configuration), assurez-vous que a365.generated.config.json existe dans votre répertoire de travail avant d’exécuter a365 publish, car la commande lit l’ID du blueprint à partir de ce fichier.

Télécharger vers le centre d’administration

Lorsque a365 publish est terminé, suivez les instructions affichées pour télécharger votre assistant :

  1. Accédez à Centre d’administration Microsoft 365.
  2. Accédez à Assistants>Tous les assistants.
  3. Sélectionnez Charger un assistant personnalisé.
  4. Téléversez le fichier manifest.zip depuis le dossier manifest de votre projet.

Pour plus d’aide, consultez Télécharger des assistants dans le Centre d’administration Microsoft 365.

Vérifiez la réussite de la publication

Utilisez la liste de contrôle suivante pour vérifier que votre assistant a été publié avec succès :

✅ La publication via la CLI réussit
✅ manifest dossier créé avec manifest.json et manifest.zip
✅ L’assistant apparaît dans le centre d’administration Microsoft

Sortie CLI

Vous voyez ces messages de sortie lorsque la commande « publish » réussit :

✅ Manifest updated successfully
✅ manifest.zip created successfully
✅ Instructions de téléversement étape par étape affichées

Si la commande échoue, vérifiez les messages d’erreur et assurez-vous d’avoir terminé la mise en place du blueprint.

Erreurs possibles :

Erreur Phase de résolution
Agent blueprint ID not found Exécutez a365 setup pour terminer la configuration du blueprint.
Permissions missing Relancez la configuration avec la commande a365 setup permissions.

Suivez ces étapes en cas d’échec de publication.

Fichiers manifestes

Vous pouvez tester les fichiers suivants dans le dossier manifest en utilisant la commande PowerShell Test-Path.

# Check manifest folder and contents exists
Test-Path <deploymentProjectPath>/manifest/
Test-Path <deploymentProjectPath>/manifest/manifest.json
Test-Path <deploymentProjectPath>/manifest/manifest.zip
# All should return: True

Remarque

Si vous ne voyez pas ces fichiers, essayez d’exécuter la commande « a365 publish » à nouveau.

L’assistant apparaît dans le centre d’administration

Remarque

Après le téléchargement, il peut falloir 5 à 10 minutes pour que votre assistant apparaisse dans le Centre d’administration et Teams. Ce délai est normal.

Confirmez que l’assistant est présent en suivant ces étapes :

  1. Accédez à Centre d’administration Microsoft 365.
  2. Accédez à Assistants>Tous les assistants.
  3. Votre assistant apparaît dans la liste.

Le tableau suivant montre les détails que vous pouvez trouver :

Champ À vérifier
Nom Nom de votre assistant (issu de manifest.json)
Version Numéro de version (par exemple, 1.0.0)
Éditeur Nom de votre organisation
Disponibilité Disponibles/Tous les utilisateurs

Voir aussi

Étapes suivantes

Après avoir publié votre assistant, créez une instance afin de pouvoir la configurer et l’utiliser dans votre tenant.

Création d’une instance d’assistant

Résolution des problèmes

Problèmes courants lors de la publication d’assistants dans le Centre d’administration Microsoft 365.

Astuce

Le Guide de dépannage Agent 365 contient des recommandations générales de dépannage, les meilleures pratiques et des liens vers du contenu de dépannage pour chaque étape du cycle de développement de l’Agent 365.

Échec de la commande Publier

Symptômes :

  • Erreur pendant a365 publish
  • manifest.zip n’est pas créé

Origine :

  • Le programme d’installation n’est pas terminé
  • Erreurs de validation du manifeste
  • Autorisations insuffisantes

Solution :

  1. Vérifiez que l’installation est terminée.

    Get-Content a365.generated.config.json | ConvertFrom-Json | Select-Object agentBlueprintId

  2. Exécutez la commande « publish » et suivez les requêtes.

Échecs de téléchargement dans le centre d’administration

Symptômes :

  • Erreur lors de l’envoi de manifest.zip dans le Centre d’administration Microsoft 365
  • L’assistant n’apparaît pas après le téléchargement

Origine :

  • Autorisations insuffisantes dans le centre d’administration
  • Invalide ou obsolète manifest.zip

Solution :

  1. Assurez-vous d’avoir le rôle d’Administrateur global.
  2. Exécutez à nouveau a365 publish pour générer un nouveau manifest.zip.
  3. Essayez de téléverser à nouveau en suivant les étapes de téléchargement.

Pour plus d’aide, consultez Télécharger des assistants dans le Centre d’administration Microsoft 365.

  • Last updated on