Partager via

Publier l’agent vers Microsoft admin Center

Important

Vous devez faire partie du programme Frontier en version préliminaire pour obtenir un accès anticipé à Microsoft Agent 365. Frontier vous connecte directement aux dernières innovations d’IA de Microsoft. Les versions préliminaires Frontier sont soumises aux conditions existantes de vos contrats clients qui régissent les versions préliminaires. Comme ces fonctionnalités sont encore en cours de développement, leur disponibilité et leurs capacités peuvent évoluer au fil du temps.

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

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

    • Administrateur général
    • Administrateur d’ID d’agent

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

Note

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 - Mises à jourmanifest.json avec l’ID de blueprint 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

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 Charger 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

Note

Si vous ne voyez pas ces fichiers, essayez de relancer la a365 publish commande .

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

Note

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 au centre d’administration Microsoft 365.
  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 :

Terrain 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

Résolution des problèmes

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

Conseil / Astuce

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.

    a365 config display -g
# Check for: agentBlueprintId

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

Échec du chargement dans le Centre d’administration

Symptômes :

  • Erreur lors du manifest.zip chargement dans le Centre d’administration Microsoft 365
  • 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 ou Administrateur d’ID d’agent.
  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 Charger des agents dans le Centre d’administration Microsoft 365.

  • Last updated on