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 publier votre agent dans le centre d’administration Microsoft 365. Lorsque vous publiez votre agent, vous pouvez créer des instances d’agents au sein de votre organisation. Vous pouvez aussi facilement gouverner l’agent.

Prerequisites

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

Comptes et autorisations requis

  • Locataire Microsoft Entra avec l’un des rôles suivants :

    • Administrateur général
    • Administrateur d’ID d’agent
    • Développeur Agent ID

  • Abonnement Azure avec accès contributeur ou propriétaire

Outils requis

Étapes de configuration requises

Avant de publier, suivez ces étapes dans l’ordre :

  1. Créer le plan d’agent - Suivez l’étape de configuration pour créer votre plan d’agent.
  2. Tester l’agent localement - Vérifiez que votre agent fonctionne correctement en utilisant Agents Playground (voir Test agents localement)
  3. Préparez les fichiers de configuration - Assurez-vous a365.config.json et a365.generated.config.json soyez à jour

Commande Publish

Exécutez la a365 publish commande :

a365 publish

Note

Exécuter a365 publish -h affiche toutes les options et sous-commandes que cette commande supporte.

Ce que fait cette commande :

  1. Mise à jour du manifeste - Mises à jour manifest.json et agenticUserTemplateManifest.json avec votre ID de blueprint d’agent
  2. Invite de personnalisation - Ouvre votre éditeur par défaut pour personnaliser la version, les noms, les descriptions et les icônes
  3. Créer un package - Paquets manifest.json, icônes et modèle utilisateur agent dans manifest.zip
  4. Configurer les permissions - Ajoute les permissions API requises à une application cliente personnalisée
  5. Téléverser vers le service Titres - Publisse le package dans le centre d’administration Microsoft 365
  6. Configurer l’accès au titre - Configure l’accès pour tous les utilisateurs de votre locataire
  7. Configurer l’authentification du blueprint - Définir l’identité de la charge de travail et l’authentification à l’exécution
  8. Accorder les permissions Graph - Applique les permissions Microsoft Graph à l’agent blueprint

Personnaliser le manifeste

L’interface CLI s’interrompt lors de la publication pour vous permettre de personnaliser votre manifeste d’assistant :

=== MANIFEST UPDATED ===
Location: [path]\manifest\manifest.json

=== CUSTOMIZE YOUR AGENT MANIFEST ===
Please customize these fields before publishing:
  Version ('version')
    - Increment for republishing (e.g., 1.0.0 to 1.0.1)
    - REQUIRED: Must be higher than previously published version
  Agent Name ('name.short' and 'name.full')
    - Make it descriptive and user-friendly
    - Currently: [your-agent-name] Blueprint
    - IMPORTANT: 'name.short' must be 30 characters or less
  Descriptions ('description.short' and 'description.full')
    - Short: 1-2 sentences
    - Full: Detailed capabilities
  Developer Info ('developer.name', 'developer.websiteUrl', 'developer.privacyUrl')
    - Should reflect your organization details
  Icons
    - Replace 'color.png' and 'outline.png' with your custom branding

Open manifest in your default editor now? (Y/n):

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 Un dossier créé avec manifest.json et manifest.zip
✅ L’agent apparaît dans le registre du centre d’administration Microsoft
✅ Les identifiants d’identité fédérée existent

Sortie CLI

Vous devriez voir ces messages de sortie lorsque la publication réussit :

✅ Upload succeeded avec l’opérationId et le TienId
✅ Title access configured for all users
✅ Microsoft Graph permissions granted successfully
✅ Agent blueprint configuration completed successfully
✅ Publish completed successfully!

Si la publication échoue, examinez les messages d’erreur et assurez-vous que la configuration du blueprint a été terminée.

Erreurs possibles :

Erreur Étape à résoudre
Agent already exists Incrémentez le numéro de version dans manifest.json et republiez.
Permissions missing Relance la configuration avec la a365 setup permissions commande.

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

Fichiers manifestes

Les fichiers suivants sont créés dans le manifest dossier et vous pouvez les tester 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

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 publication, il peut falloir 5 à 10 minutes pour que votre agent apparaisse dans le centre d’administration et Teams. Ce délai est normal.

Vous pouvez confirmer que l’agent est présent en suivant ces étapes :

  1. Accédez à https://admin.cloud.microsoft/#/agents/all.
  2. Votre agent apparaît dans l’onglet Registre
  3. La disponibilité apparaît comme Tous les utilisateurs (la coche verte indique le succès)

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

Terrain Que vérifier
Nom Nom de votre agent (d’après manifest.json)
Version Numéro de version (par exemple, 1.0.0)
Publisher Nom de votre organisation
Disponibilité Disponible/Tous les utilisateurs

Identité fédérée créée

Vous pouvez voir l’enregistrement identité fédérée (FIC) créé dans Microsoft Entra.

  1. Aller dans Inscriptions >d’applications Application de plan directeur de votre agent
  2. Naviguer dans Certificats & secrets>Identifiants fédérés
  3. Vous voyez 2 FICs

Si vous ne voyez pas ces enregistrements, vérifiez les permissions de l’application Blueprint dans le portail Azure.

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.

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
  • L’agent n’apparaît pas dans le centre administratif

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.

  3. Lorsque vous le demandez, personnalisez le manifeste :

    • Mettre à jour le numéro de version (doit être unique lors de la republication)
    • Définir le nom de l’agent (30 caractères ou moins)
    • Mettre à jour les descriptions
    • Vérifiez les informations du développeur

  4. Tape continue ou c continue après personnalisation.

  • Last updated on