Publier l’agent dans Microsoft Centre d’administration

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

Prerequisites

Avant de commencer, assurez-vous d’avoir les éléments suivants.

Comptes et autorisations requis

  • Client Microsoft 365 avec l’un des rôles suivants (nécessaire pour l’étape de chargement dans le Centre d’administration) :

    • Administrateur général

Outils requis

Étapes de configuration requises

Avant de publier, procédez comme suit :

  1. Créer le plan d’agent - Suivez l’étape de configuration pour créer votre plan d’agent.
  2. Agent de test localement : vérifiez que votre agent fonctionne correctement à l’aide d’Agents Playground (voir Agents de test localement).
  3. Préparer les fichiers de configuration - Vérifiez a365.config.json et a365.generated.config.json êtes à jour.

Commande de publication

Exécutez la a365 publish commande :

a365 publish

Remarque

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

Ce que fait cette commande :

  1. Mettre à jour le manifeste - Met à jour manifest.json avec l’ID de plan de votre agent.
  2. Créer un package - Packages manifest.json et icônes dans manifest.zip.
  3. Instructions d'impression : affiche des instructions pas à pas pour le chargement via le centre d'administration Microsoft 365.

Remarque

La a365 publish commande fonctionne à la fois pour les agents et les collègues d’IA. Pour les agents approvisionnés à l’aide --agent-name (sans configuration), vérifiez a365.generated.config.json qu’il existe dans votre répertoire de travail avant d’exécuter a365 publish, car la commande lit l’ID de blueprint à partir de ce fichier.

Téléverser dans le centre d’administration

Une fois a365 publish terminé, suivez les instructions imprimées pour charger votre agent :

  1. Accédez au Centre d’administration de Microsoft 365.
  2. Accédez à Agents>Tous les agents.
  3. Sélectionnez Charger un agent personnalisé.
  4. Chargez le manifest.zip fichier à partir du manifest dossier de votre projet.

Pour plus d’informations, consultez Importer des agents dans le Centre d'administration Microsoft 365.

Vérifier la réussite de la publication

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

✅ La publication CLI réussit
✅ manifest dossier créé avec manifest.json et manifest.zip
✅ L’agent s’affiche dans le Centre d’administration Microsoft

Sortie CLI

Vous voyez ces messages de sortie lorsque la commande de publication réussit :

✅ Manifest updated successfully
✅ manifest.zip created successfully
✅ Instructions de chargement pas à pas imprimées

Si la commande échoue, passez en revue les messages d’erreur et vérifiez que vous avez terminé la configuration du blueprint.

Erreurs possibles :

Erreur Étape à résoudre
Agent blueprint ID not found Exécutez a365 setup pour terminer la configuration du blueprint.
Permissions missing Relance la configuration avec la a365 setup permissions commande.

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

Fichiers manifestes

Vous pouvez tester les fichiers suivants dans le manifest dossier à l’aide de 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 de relancer la a365 publish commande .

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

Remarque

Après le chargement, l’affichage de votre agent dans le Centre d’administration et Teams peut prendre 5 à 10 minutes . Ce délai est normal.

Vérifiez que l’agent est présent en procédant comme suit :

  1. Accédez à Microsoft 365 admin center.
  2. Accédez à Agents>Tous les agents.
  3. Votre agent apparaît dans la liste.

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

Champ Que vérifier
Nom Nom de votre agent (demanifest.json)
Version Numéro de version (par exemple, 1.0.0)
Publisher Nom de votre organisation
Disponibilité Disponible/Tous les utilisateurs

Voir aussi

Étapes suivantes

Après avoir publié votre agent, créez une instance pour pouvoir la configurer et l’utiliser dans votre locataire.

Créer une instance d’agent

Dépannage

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

Conseil

Le Guide de dépannage de l’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.

Échecs de la commande Publish

Symptômes :

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

Causes racine :

  • La mise en place n’est pas terminée
  • Erreurs de validation manifeste
  • Autorisations insuffisantes

Solution:

  1. Vérifiez que la configuration est terminée.

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

  2. Exécutez la commande publish et suivez les consignes.

Échec du chargement dans le Centre d’administration

Symptômes :

  • Erreur lors du chargement de manifest.zip dans le Microsoft 365 admin center
  • L’agent n’apparaît pas après le chargement

Causes racine :

  • Autorisations insuffisantes dans le Centre d’administration
  • Non valide ou obsolète manifest.zip

Solution:

  1. Vérifiez que vous disposez du rôle Administrateur général.
  2. Réexécutez a365 publish pour générer un nouveau manifest.zip.
  3. Réessayez de charger en suivant les étapes de chargement.

Pour plus d’aide, consultez Télécharger des agents au centre d'administration de Microsoft 365.

  • Last updated on