Foundry ポータルでエージェントをMicrosoft 365 CopilotおよびMicrosoft Teamsに発行する

エージェントをビルドしてテストした後は、多くの場合、エージェントが既に機能しているサーフェス内の他のユーザーとエージェントを共有する必要があります。 Microsoft Foundry エージェントを Microsoft 365 Copilot と Teams に発行すると、Microsoft 365 Copilot と Teams の UI から、自分や他のユーザーがそのエージェントとやり取りしたり、見つけたりできるようになります。エージェントの安定したエンドポイントを公開するため、エンドユーザーは常に一貫性のあるエージェントと対話しながら、エンドポイント経由でトラフィックを受信する新しいエージェントバージョンをシームレスにロールアウトします。

この記事では、Foundry ポータルからエージェントを発行する方法について説明します。

警告

Microsoft 365および Teams にエージェントを発行すると、それらのサービスは、エージェントの発行と使用に関連する特定のデータを処理して格納します。このデータは、Microsoft 365および Teams に適用される用語、コンプライアンスコミットメント、データ所在地コミットメント、およびデータ処理プラクティスに従います。

このデータには、エージェントの名前、アイコン、説明など、エージェントを発行するために必要なデータを含めることができます。また、組織内のユーザーが Microsoft 365 および Teams からエージェントにクエリを送信したときにエージェントによって提供される応答に含まれるデータも含まれます。

エージェントを Microsoft 365 および Teams に発行する前に、結果として得られるデータフローと処理が組織のコンプライアンス、データ所在地、ガバナンスの要件と一致しているかどうかを評価します。

メモ

Foundry ポータルからの発行は、パブリックネットワークアクセスを無効にするプロジェクトではサポートされていません。これらのエージェントを発行するには、REST API を使用し、 enable_m365_public_endpointでソース IP でフィルター処理されたパブリックアクティビティプロトコルルートを有効にします。要求は、Azure Bot ServiceまたはMicrosoft 365ソース範囲から送信され、構成された承認要件を満たしている必要があります。詳細については、「REST API を使用してエージェントをMicrosoft 365 CopilotおよびMicrosoft Teamsに発行する」を参照してください。

前提条件

Microsoft Foundry ポータルへのアクセス。
テスト済みで、公開したいエージェントバージョンを含む Foundry プロジェクト。
次のロールの割り当て:
- Azure Bot Service リソース (Microsoft.BotService/botServices/write) を作成し、発行先のリソースグループでそのチャネル (Microsoft.BotService/botServices/channels/write) を設定するアクセス許可。 Azure Bot Service 共同作成者ロールは、これらのアクセス許可のみを付与します。より広範な 共同作成者 ロールまたは 所有者 ロールも機能します。 Foundry のロールには、これらのアクセス許可は付与されません。詳細については、Azure Bot Serviceセットアップに関するページを参照してください。
- エージェントを作成、管理、および発行するための Foundry プロジェクトスコープの Foundry ユーザー ロール。
  
  重要
  
  Foundry RBAC ロールの名前が最近変更されました。 Foundry User, Foundry Owner, Foundry Account Owner、および Foundry Project Manager は、以前は、AZURE AI ユーザー、Azure AI 所有者、Azure AI アカウント所有者、および AZURE AI Project Manager という名前でした。名前の変更がロールアウトされている間、以前の名前が表示される場合があります。ロール ID とコアアクセス許可は、名前の変更によって変更されません。
- 詳細については、 Foundry ポータルのロールベースのアクセス制御に関するページを参照してください。
発行する前に、Foundry ポータルでエージェントを十分にテストします。正しく応答し、ツールが期待どおりに動作するかどうかを確認します。
コンシューマーが Microsoft 365 と Teams でやり取りする際に使用する、アクティブなエージェントのバージョンを選択します。
必要なAzureリソースプロバイダーがサブスクリプションに登録されていることを確認します。発行プロセスにより、Azure Bot Service リソースが作成されます。これには、Microsoft.BotService プロバイダーが必要です。

Azure CLIを使用する場合は、プロバイダーを次の場所に登録できます。
```
az provider register --namespace Microsoft.BotService
```

アクティブなエージェントのバージョンを選択する

アクティブなバージョンは、エージェントの安定したエンドポイントがコンシューマーに提供するバージョンであるため、公開する前に確認してください。エージェントのバージョンとその他の設定の詳細については、「エージェントエンドポイントと設定の構成」を参照してください。

ファウンドリーポータル
REST API

2 つのエントリポイントのいずれかからアクティブなバージョンを設定します。

[詳細] タブから

エージェントを開き、[ 詳細 ] タブを選択します。
エージェントの構成で、[アクティブなバージョン] の横にある [編集] を選択します。
[ 常に最新のものを使用] を選択するか、特定のバージョンを選択します。

[発行] ボタンから

Microsoft Foundry ポータルで、Publish を選択します。
[ アクティブなバージョン] の横にある矢印を選択します。
[ 常に最新のものを使用] を選択するか、特定のバージョンを選択します。

特定のバージョンにトラフィックをピン留めするには、エージェントの version_selectorを更新します。 agent_version を、提供したいバージョンに設定します。

PATCH {{endpoint}}/agents/{{agent_name}}?api-version=v1
Authorization: ******
Content-Type: application/merge-patch+json

{
  "agent_endpoint": {
    "version_selector": {
      "version_selection_rules": [
        {
          "type": "FixedRatio",
          "agent_version": "2",
          "traffic_percentage": 100
        }
      ]
    }
  }
}

発行するとどうなりますか?

エージェントを発行すると、Foundry は次の手順を実行します。

表示名、説明、バージョンなど、送信するプロパティを検証します。
Teams アプリマニフェストを .zip パッケージとしてコンパイルします。詳細については、「Microsoft Teamsのアプリマニフェストスキーマ」を参照してください。
マニフェストをユーザーに代わってMicrosoft 365 Copilotおよび Teams エージェントカタログに送信します。
エージェントが Microsoft 365 および Teams とメッセージを交換する必要があるactivity プロトコルを有効にします。
選択したスコープに基づいてエージェントを呼び出すことができるユーザーを制御する承認スキーム ( BotServiceRbac または BotServiceTenant) を有効にします。

エージェントを表示して呼び出しできるユーザー

選択したスコープによって、Microsoft 365 Copilot および Teams ストアでそのエージェントを誰が検索できるかなどの可視性が決まります。 Foundry は、エージェントを 呼び出 すことができるユーザーを制御する、一致する承認スキームを設定します。

自分のみ（Foundry ポータル）または publishScopeShared に設定（REST API）すると、BotServiceRbac が有効になり、管理者の承認は不要です。エージェントはストアではあなただけに表示されます。 Teams チャットに追加すると、プロジェクトで必要な Foundry アクセス許可を持つ参加者が使用できます。
組織内のユーザー (Foundry ポータル) または publishScope を Tenant に設定した場合 (REST API): BotServiceTenant が有効になり、Microsoft 365 管理センターで管理者の承認が必要です。承認後、エージェントは 組織によって構築された下にテナント内のすべてのユーザーに対して表示され、テナント内のすべてのユーザーがエージェントを検出して使用できます。

Microsoft 365と Teams に発行する

ポータルから発行すると、Foundry のMicrosoft 365発行 API が呼び出され、Teams アプリパッケージがビルドされます。代わりに REST API を使用して発行する (たとえば、パブリックネットワークアクセスを無効にするプロジェクトから発行する) には、「REST API を使用してエージェントをMicrosoft 365 CopilotおよびMicrosoft Teamsに発行する」を参照してください。この記事では、プライベートネットワークエージェントに対してソース IP でフィルター処理されたパブリックアクティビティプロトコルルートを有効にする方法についても説明します。

[詳細] タブから発行ダイアログを開くことができます ([チャネル] セクションで[Teams とMicrosoft 365 Copilot) または [発行] ボタンをクリックします。これらの手順では、[ 発行 ] ボタンを使用します。

Microsoft Foundry ポータルで、[発行] を選択し、[Teams とMicrosoft 365 Copilot] を選択します。

想定される結果: [Teams と Microsoft 365 に公開する] ダイアログが開きます。
Azure Bot Service リソースは自動的に作成されるか、既に存在する場合は読み取り専用として表示されます。

必要なメタデータを完了します。

フィールド	説明
名前	エージェントの表示名 (エージェントストアに表示されます)
発行バージョン	3 部構成のバージョン番号 (メジャー.マイナー.パッチ)
簡単な説明	エージェントが実行する内容の 1 文の説明
説明	エージェントの責任と実行できるアクションについて詳しい説明
開発者	自分の名前または組織名 ( [作成者] の下)

省略可能なメタデータを追加するには、[ その他] を展開し、次のフィールドに入力します。

フィールド	説明
開発者向け Web サイト	Web サイトの URL (HTTPS が必要)
使用条件	使用条件の URL (HTTPS が必要)
プライバシーに関する声明	プライバシーポリシーの URL (HTTPS が必要)

警告

メタデータフィールドにシークレット、API キー、機密情報を含めないでください。これらのフィールドはユーザーに表示されます。

[次へ: 発行オプション] を選択します。
発行方法を選択します。 Foundry からエージェントを直接発行するか、エージェントマニフェストをダウンロードしてカスタマイズしてから、Teams で手動でサイドロードすることができます。

直接発行

[発行] オプションで、[直接発行] タブを選択します。

予想される結果: [ このエージェントを使用できるユーザーの選択] セクションが表示されます。

[ このエージェントを使用できるユーザーの選択] で、スコープを選択します。

オプション	動作	管理者の承認	〜に最適です
あなただけ	すぐに使用できます。エージェントはエージェントストアのあなたのエージェントの下に表示されます。エージェントリンクを送信して他のユーザーと共有します。	必須ではありません	個人テスト、小規模チーム、パイロット
組織内のユーザー	エージェントは管理者の承認に申し込まれます。 Microsoft 365管理者が要求を確認し、アクセス権を割り当てます。承認されると、すべてのテナントユーザーに対して<貴社によって構築されたエージェントが表示されます。	必須	組織全体の配布、プロダクション環境へのデプロイ

あなただけ:

発行直後に使用可能 - 管理者の承認は必要ありません。
エージェントストアの [自分のエージェント] の下で最初にエージェントが見えるのはあなただけです。
エージェントリンクを送信して、特定のユーザーと共有します。

組織内のユーザー:

発行後、Microsoft 365管理者は、Microsoft 365 管理センターで要求を確認して承認する必要があります。
テナントユーザー全員が利用するエージェントストアの組織によって構築されたの下にエージェントが承認され次第表示されます。
テナント内のアプリポリシーは、エージェントにアクセスできるユーザーを制御します。
承認の状態を確認するには、Microsoft 365 管理センターに移動し、Requests でエージェントを探します。

Microsoft 365 Copilot のエージェントストアのスクリーンショット

発行を選択します。

予期される結果: [発行に成功しました ] ダイアログは、エージェントが正常に発行されたことを確認します。

ダウンロードしてカスタマイズする

配布する前にエージェントマニフェストをカスタマイズする場合:

[発行] オプションで、[ダウンロードしてカスタマイズ] タブを選択します。

期待される結果: タブには、ダウンロード後の手順と [ ZIP のダウンロード ] ボタンが表示されます。
[ ZIP のダウンロード] を選択します。

予想される結果: エージェントマニフェストを含む .zip ファイルがローカルコンピューターにダウンロードされます。
必要に応じて、ダウンロードしたパッケージ内のマニフェストをカスタマイズします。
Microsoft Teamsで、ダウンロードしたパッケージをアップロードします。
1. アプリ>>移動します。
2. [ カスタムアプリをアップロードする ] または [ アプリを組織に送信する ] を選択し、ダウンロードした .zip ファイルを選択します。

M365/Teams で公開されたエージェントを更新する

アクティブなエージェントのバージョンを更新する

新しいエージェントバージョンをロールアウトするには、Foundry ポータルでエージェントのバージョンセレクターを更新します。安定したエンドポイント URL は同じままです。M365/Teams に再発行する必要はありません。

M365/Teams でエンドユーザーメタデータを更新する

Teams と M365 (表示名、説明、URL) に表示されるメタデータを更新するには、Publish ドロップダウンで Update エージェント Teams とMicrosoft 365 Copilot表示プロパティを選択。更新されたフィールドは、既存の値を上書きします。変更されていないフィールドは繰り越されます。手動でインクリメントしない場合、バージョンは自動的にインクリメントされます。

制限

プロジェクトでパブリックネットワークアクセスを無効にする場合の要件など、エージェントの公開の制限については、「制限事項」を参照してください。

公開のトラブルシューティング

ポータルからの発行中に発生するエラーを解決するには、次の表を使用します。ストアで公開されているエージェントを検索し、チャット時にエラーを解決する方法など、より広範なトラブルシューティングについては、「トラブルシューティング」を参照してください。

症状:	原因	解決方法
エージェントの発行中にエラーが発生しました	無効なメタデータまたはバージョン	エージェントに一意の ID があることを確認します (`agent.identity` は null ではありません)。開発者名が 32 文字以下であることを確認します。
Azure Bot Serviceの作成が失敗する	アクセス許可がないか、未登録のプロバイダー	リソースを作成するアクセス許可があることを確認します。必要に応じて、`Microsoft.BotService`を登録します。
Azure ボットサービスフィールドでは、`403 AuthorizationFailed` に関する `Microsoft.BotService/botServices/write` エラーが表示されています	ID に、ターゲットリソースグループ内のAzure Bot Service リソースを作成または更新するアクセス許可がありません	bot serviceを含むリソースグループにAzure Bot Service共同作成者ロール (またはより広範な共同作成者ロールまたは所有者ロール) を割り当て、資格情報を更新して発行フローを再度開きます。

ポータルに [このエージェント] が表示されている場合は、Teams とMicrosoft 365 Copilotに発行できなくなった古い形式が使用されます。発行する新しい形式にアップグレードします。エージェントは、一般公開されている発行フローでは新しい発行をサポートしていない古いエージェントアプリケーション形式を使用します。エージェントを新しい形式にアップグレードし、発行します。古い形式の既存のエージェントは引き続き動作し、引き続き更新できます。「エージェントアプリケーションから新しいエージェントモデルへの移行」を参照してください。

Faq

[組織のスコープ] を選択した場合、エージェントはどこで承認できますか?

Microsoft 365 管理センターでエージェントを承認します。承認後、エージェントはエージェントストアの あなたの組織が作成 の下に表示されます。

エージェントを個々のスコープ (以前は共有スコープと呼ばられていた) に発行した場合、組織内の他のユーザーと共有するにはどうすればよいですか?

エージェントは、Microsoft 365 Copilotのエージェント ストアの [エージェント] の下に表示されます。組織内の選択したユーザーにエージェントリンクを送信して共有します。

エージェントが M365 に発行された場合、新しいエージェントバージョンを作成するとどうなりますか?

バージョンセレクターが [常に最新を使用 する] (既定値) に設定されている場合、新しいバージョンは M365 と Teams で自動的に機能します。特定のバージョンにピン留めする場合は、バージョンセレクターを更新して新しいバージョンを提供する必要があります。

フィードバック

このページはお役に立ちましたか?

Last updated on 2026-08-28