Microsoft 管理センターにエージェントを発行する

a365 publish コマンドを使用してエージェントをパッケージ化し、パッケージを Microsoft 365 管理センターにアップロードします。 発行後、組織内にエージェント インスタンスを作成し、エージェントを管理できます。

[前提条件]

始める前に、以下のアイテムを必ず用意してください。

必要なアカウントとアクセス許可

  • 次のいずれかの役割を持つ Microsoft 365 テナント (管理センターのアップロード手順に必要)。

    • グローバル管理者

必要なツール

必要なセットアップ手順

発行する前に、次の手順を実行します。

  1. エージェントブループリントを作成 - 設定ステップ に従ってエージェントブループリントを作成してください。
  2. エージェントをローカルでテスト する - Agents Playground を使用してエージェントが正しく動作することを確認します (「 エージェントをローカルでテストする」を参照)。
  3. 構成ファイルを準備 する - a365.config.json と a365.generated.config.json が最新であることを確認します。

公開コマンド

a365 publishコマンドを実行してください:

a365 publish

Note

a365 publish -hを実行すると、このコマンドでサポートされているすべてのオプションが表示されます。

このコマンドの効果:

  1. マニフェストの更新 - エージェントブループリント ID を使用して manifest.json を更新します。
  2. パッケージの作成 - manifest.json とアイコンを manifest.zipにパッケージ化します。
  3. Print 命令 - Microsoft 365 管理センター経由でアップロードする手順が表示されます。

Note

a365 publish コマンドは、エージェントと AI チームメイトの両方に対して機能します。 --agent-name (config-free) を使用してプロビジョニングされたエージェントの場合は、コマンドによってこのファイルからブループリント ID が読み取られますので、a365.generated.config.jsonを実行する前に、a365 publishが作業ディレクトリに存在することを確認してください。

管理センターへのアップロード

a365 publishが完了したら、印刷された手順に従ってエージェントをアップロードします。

  1. Microsoft 365管理センターに移動します。
  2. [エージェント>すべてのエージェント] に移動します。
  3. [ カスタム エージェントのアップロード] を選択します。
  4. プロジェクトのmanifest.zip フォルダーからmanifest ファイルをアップロードします。

詳細については、「 Microsoft 365 管理センターにエージェントをアップロードする」を参照してください。

成功した公開の確認

以下のチェックリストを使って、エージェントが正常にデプロイされていることを確認します:

✅ CLI の発行が成功する
✅ manifest manifest.jsonで作成されたフォルダーmanifest.zip
✅ Microsoft 管理センターにエージェントが表示される

CLI出力

発行コマンドが成功すると、次の出力メッセージが表示されます。

✅ Manifest updated successfully
✅ manifest.zip created successfully
✅ ステップ バイ ステップのアップロード手順が印刷されました

コマンドが失敗した場合は、エラー メッセージを確認し、ブループリントのセットアップが完了していることを確認します。

起こりうる誤り:

エラー 解決への一歩
Agent blueprint ID not found a365 setupを実行してブループリントのセットアップを完了します。
Permissions missing a365 setup permissionsコマンドでセットアップを再実行します。

出版が失敗した場合は 、以下のステップ に従ってください。

マニフェスト ファイル

Test-Path PowerShell コマンドを使用して、 manifest フォルダー内 の次の ファイルをテストできます。

# 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

これらのファイルが見当たらない場合は、もう一度 a365 publish コマンド を実行してみてください。

エージェントが管理センターに現れる

Note

アップロード後、エージェントが管理センターと Teams に表示されるまでに 5 ~ 10 分 かかる場合があります。 この遅延は正常です。

次の手順を使用して、エージェントが存在することを確認します。

  1. Microsoft 365管理センターに移動します。
  2. [エージェント>すべてのエージェント] に移動します。
  3. エージェントが一覧に表示されます。

以下の表は、どのような詳細が見つかるかを示しています。

フィールド チェックすべきこと
氏名 あなたのエージェント名 (manifest.jsonから)
Version バージョン番号 (例: 1.0.0)
Publisher あなたの組織名
可用性 利用可能/全ユーザー

関連情報

次のステップ

エージェントを公開した後、テナント内で設定・使用できるインスタンスを作成してください。

エージェントインスタンスを作成する

Troubleshooting

Microsoft 365 管理センターにエージェントを発行するときの一般的な問題。

Tip

Agent 365トラブルシューティングガイドには、Agent 365 の開発ライフサイクルの各段階に対応した高レベルのトラブルシューティング推奨事項、ベストプラクティス、トラブルシューティングコンテンツへのリンクが含まれています。

Publishコマンドが失敗します

症状：

  • a365 publish中にエラー
  • manifest.zip が作成されない

根本原因:

  • セットアップはまだ完了していません
  • マニフェスト検証エラー
  • アクセス許可が不十分です

Solution:

  1. セットアップが完了しているか確認してください。

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

  2. publishコマンドを実行し、プロンプトに従ってください。

管理センターでのアップロードが失敗する

症状：

  • Microsoft 365 管理センターで manifest.zip をアップロードするときのエラー
  • アップロード後にエージェントが表示されない

根本原因:

  • 管理センターのアクセス許可が不十分
  • 無効または古い manifest.zip

Solution:

  1. グローバル管理者ロールがあることを確認します。
  2. a365 publishをもう一度実行して、新しいmanifest.zipを生成します。
  3. アップロード手順に従って、もう一度 アップロードしてみてください。

詳細については、「 Microsoft 365 管理センターにエージェントをアップロードする」を参照してください。

  • Last updated on