プラグインまたはエージェントの監視、更新、廃止

監視、フィードバック、サポートの証拠を使用して、プラグインまたはエージェントを修正、更新、引き渡し、または廃止するかどうかを決定します。 リリース前に変更をテストし、目的のユーザーに結果を確認します。

ビルダーはソリューションを保守およびテストします。 Microsoft 365 管理者は、必要に応じて組織のロールアウトとアクセス アクションを完了します。 サービス所有者は、使用するコネクタ、リモート MCP サーバー、ID、外部サービスを管理します。 これらの責任は自動的に一緒に転送されません。

タスクを選択する

必要な作業にはセクションを使用します。 監視、サポート、引き渡し、廃止では、更新ワークフローに従う必要はありません。

必要な操作 次から始める
導入、フィードバック、またはタスクの成果を確認します 使用状況とタスクの成果を監視する
ユーザーの問題を調査する ユーザーのサポートと問題の調査
ソリューションを変更してリリースする プラグインまたはエージェントを更新する
メンテナンス責任を転送する 所有権とサポートを引き渡す
配布またはアクセスの終了 プラグインまたはエージェントを廃止する

始める前に

識別:

  • 現在のプラグインまたはエージェントの ID とバージョン。
  • 影響を受けるユーザーと Microsoft 365 エクスペリエンス。
  • タスクおよび関連する接続またはサービスに責任を持つ所有者。

スタンドアロン エージェントの場合は、オーサリング製品でサポートされている監視とリリースの手順を使用します。 プラグイン パッケージの手順が適用されると想定しないでください。

使用状況とタスクの成果を監視する

レポート期間、バージョン、対象ユーザー、代表的なタスクを選択します。 アクティビティを所有する製品の監視エクスペリエンスを使用します。

監視対象 どこから始めるべきか 留意すべきスコープ
エージェントビルダーに組み込まれたエージェント エージェント ビルダーでエージェントを監視する エージェントの [モニター ] タブでは、その使用状況とフィードバックについて説明します。 フィードバックの可視性には別の前提条件があります。
標準ハーネスを使用する Copilot Studio エージェント Copilot Studio でエージェントのパフォーマンスを監視する そのエージェントでサポートされている分析を使用します。同じレポートがエージェント ビルダーやその他のビルド パスにあると想定しないでください。
プラグイン アクセス、ユーザー タスク、および失敗 プラグインを監視する パッケージの可用性、代表的なタスクの結果、ユーザー フィードバック、サポート ケースを確認します。
Microsoft 365 の使用状況と監査アクティビティ チェック対象の選択 各レポートを対象となるアクティビティに使用します。 監査イベントでは、タスクが成功したことや応答が正しかったことが確立されません。
コネクタまたはリモート MCP サービス エラーとサービスの監視ガイダンスを調査する 接続状態、ソースのアクセス許可、エンドポイントの正常性、ログ、エラーをサービス所有者に確認してください。 パッケージの可用性は、ランタイムの正常性を証明しません。

テレメトリまたはレポートのカバレッジがプラグインとエージェントのビルド パス間で共有されると想定しないでください。 含まれるエージェントのレポートは、そのエージェントを対象としており、必ずしもプラグインのすべての機能を対象としているわけではありません。

導入、タスクの成功、応答の品質、サインインまたはツールの失敗、およびサポートの量の変化を記録します (利用可能な証拠がそれらの結論を裏付ける場合)。 代表的なタスクとユーザー フィードバック、および使用状況を比較します。

ユーザーのサポートと問題の調査

問題ごとに、影響を受けるバージョン、製品、対象ユーザー、予想される結果、確認された結果、関連するエラーの詳細をキャプチャします。 所有者の割り当てと次のアクション。

  • 可用性、インストール、ポリシー、または保留中のアクセス要求を調査するよう管理者に依頼します。
  • ビルダーまたはエージェントの所有者に、指示、知識、ツールの選択、または回帰を調査するよう依頼します。
  • 認証、同意、ソース アクセス、およびランタイム エラーを調査するように ID、接続、またはサービス所有者に依頼します。

API または MCP アクションのサインイン エラーの場合は、 プラグイン認証のトラブルシューティングを使用します。 タスクと依存関係のチェックの場合は、[ エラーの調査] を使用します。

影響を受けるユーザーに修正プログラムを確認し、結果を記録します。 修正された構成または成功したツール呼び出しは、それだけでは、ユーザーの完全なタスクが機能したとは限りません。

プラグインまたはエージェントを更新する

ソリューションを変更する必要がある場合は、このワークフローに従います。 構成されたプラグインのパッケージ手順を使用します。 スタンドアロン エージェントについては、オーサリング製品のリリース手順を使用します。

更新の前に

保有者:

  • 証拠、ユーザー フィードバック、サポート ケース、または計画された改善の監視。
  • 代表的なタスクと受け入れ基準。
  • ソースと影響を受ける機能へのアクセス。
  • 現在のバージョン、対象ユーザー、配布ルートを含む公開レコード。
  • 接続、ID、またはサービス変更の所有者。

ベースラインを確立する

  1. 対処したい問題または改善を述べます。
  2. 影響を受けるパッケージまたはエージェントのバージョン、ユーザー、エクスペリエンス、機能、依存関係を特定します。
  3. 代表的なタスクと測定可能な受け入れ基準を定義します。
  4. 現在のバージョンに対してタスクを実行し、結果を記録します。
  5. organizationがプラグインを管理している場合は、その現在のステータス、ユーザーの可用性、およびインストール状態を Agents>Tools>Plugins に記録します。 エージェントに適用可能なコントロールについては、[ エージェント>すべてのエージェント>レジストリ] を使用します。
  6. 現在の動作と更新された動作を比較するために必要な証拠を保持します。

エージェントを含むプラグインの場合は、「 エージェント評価の概要 」を使用して、応答の品質、指示、知識、またはツールの使用が変更の一部である場合の評価を設計します。 評価は、プレリリースの証拠を提供し、使用シグナル、ユーザー フィードバック、エージェントと依存関係の変更によって発生した問題など、デプロイ後の品質の問題を調査するのに役立ちます。

エージェント評価は、すべてのプラグインに必要なわけではありません。 機能テスト、パッケージ検証、または完全なユーザー エクスペリエンスのテストに代わるものではありません。

展開された宣言型エージェントの場合は、ガイド付きwiqd agent evalワークフローを使用します。 直接コマンド ラインまたはパイプライン制御については、「Microsoft 365 Copilot 評価 CLI の概要」を参照してください。

変更を適用してテストする

機能、統合、またはソースを変更する必要がある場合は、 Build に戻るか再利用 します。 リリース候補を準備して検証する必要がある場合は、 パッケージ & テスト に戻ります。 影響を受ける依存関係とサポートされるエクスペリエンスをスコープ内に保持します。

  1. ソースまたは影響を受ける機能を更新します。
  2. 変更が必要になった場合は、個別に運用されているサービスまたは構成を更新します。
  3. 変更された各機能と影響を受ける依存関係をテストします。
  4. ベースライン タスクと評価を再度実行します。
  5. 結果を受け入れ基準と比較します。
  6. リリース パッケージを作成する前に回帰を調査します。

変更がコネクタ、リモート MCP サーバー、ID、アクセス許可、または外部サービスに影響を与える場合は、その依存関係の所有者が関与します。 パッケージの変更によって、個別に運用されるサービスが更新されるとは想定しないでください。

パッケージの作成と検証

スタンドアロン エージェントの場合は、オーサリング製品のバージョン管理、テスト、および公開手順に従います。 次のパッケージ手順は、構成されたプラグインに適用されます。

  1. 新しいパッケージ バージョンを割り当て、公開方法の ID 要件をチェックします。
  2. プラグイン パッケージを作成します。
  3. リリースする予定の正確なパッケージを検証してテストします。
  4. 必要なサインイン、同意、接続、外部サービスをテストします。
  5. サポートするすべての Microsoft 365 エクスペリエンスでパッケージをテストします。
  6. 既知の制限事項、必要な構成、文書化された回復オプションを記録します。

検証したパッケージとは異なるパッケージを公開しないでください。

更新プログラムの公開とロールアウト

製品と流通ルートの更新手順を選択します。 公開ルートは、共有、organization submission、および Marketplace 公開を区別します。

配布ルート 文書化されたガイダンスまたは制限事項 行動者
Cowork を通じて共有されるプラグイン 既に共有されているプラグインの新しいバージョンについては、文書化された アップロードと再共有の手順 に従ってください。 この手順は、一般的なレジストリの置換ではなく、Cowork の共有に適用されます。 プラグインの所有者
Work IQ Dev Tools を使用した組織アプリ カタログの提出 「承認済みの更新プログラムを organization app カタログに送信する」に従ってください。 リリース ターゲットの既存の ID と環境状態を保持し、更新されたリリースをテストし、 wiqd plugin publish付きで送信し、管理者の承認を取得します。 プラグインの所有者と管理者
手動によるレジストリ アップロードまたはその他の直接共有方法 リリース前に製品固有の既存アイテムの更新手順を確認してください。 この記事では、ツール、レジストリ パッケージの手動交換手順については説明しません。 新しいアップロードによって既存のエントリが置き換えられたり、可用性設定が保持されたりすると想定しないでください。 プラグインの所有者と管理者
Microsoft Marketplace 発行されたオファーで使用されるオファーの種類の更新ガイダンスに従ってください。 プラグインを Microsoft Marketplace に公開するからリンクされたパートナー センター ガイダンスから始めます。 お客様に更新プログラムを案内する前に、必要なレビューと公開を完了します。 必要に応じてパブリッシャーと顧客管理者

WIQD 更新の場合は、確立されたリソース ID とパブリケーション ID を保持します。 再プロビジョニングでは既存の環境 ID が使用され、カタログの承認前に現在のユーザーが使用しているリソースを変更できます。 その影響を念頭に置いて変更をテストします。 プロジェクトの公開ライフサイクルを 、既存のプロジェクトの WIQD ガイダンスと照合します。CLI を更新しても、プロジェクト ファイルは更新されません。

wiqd plugin publish --package-file を通じてキャプチャされた ZIP ではなく、プロジェクトと環境を送信します。 申請を通じて承認済みのソースと環境の状態を修正し、送信されたバージョンを確認します。 パッケージの検証だけでは、公開によってそれらの正確なバイト数が送信されることを証明することはできません。

更新手順が文書化されたルートの場合:

  1. テストされたバージョンの確認済みの公開または共有手順を使用し、それが送信、公開、共有、拒否、またはブロックされたかどうかを記録します。
  2. 管理者またはロールアウトの所有者に、正確なバージョン、対象ユーザー、必要な構成、既知の制限事項、サポート連絡先を伝えます。
  3. 該当する手順のみを完了して、 更新されたプラグインまたはエージェントを利用できるようにします。 承認、割り当て、およびインストールの要件は、メソッドと organization の設定によって異なります。
  4. 必要に応じて、個別に制御されるエージェント、接続、ID、リモート MCP サーバー、または外部サービスを更新します。
  5. 各オーディエンスにどのバージョンが届いたかを確認します。

ロールバックを想定しない復旧の計画

管理者は Microsoft 365 管理センターでプラグインをブロックおよびブロック解除できます。 プラグインの ブロック解除 アクションを使用してブロックを削除し、目的のユーザーのアクセスを確認します。 その他の可用性、インストール、アクセス許可、接続要件は引き続き適用されます。 ブロックを解除しても、以前のパッケージ バージョンは復元されず、サービスの変更も元に戻されません。

現在のガイダンスでは、一般的なプラグイン パッケージ バージョンのロールバック手順は文書化されていません。 製品固有のロールバック操作は、製品が文書化している場合にのみ使用してください。

リリースの前に、文書化されたリカバリ オプションとその前提条件を記録するか、プロシージャのギャップと失敗したロールアウトの責任者を記録します。

パッケージを置き換えても、外部サービス、接続、ID、データ、またはアクセス許可の変更は自動的に復元されません。 これらの依存関係を個別に計画します。

更新プログラムの検証

  1. サポートされている各エクスペリエンスで、目的のユーザーを使用して代表的なタスクをテストします。
  2. ユーザーが期待どおりのバージョンを受け取ったことを確認します。
  3. サインイン、同意、接続、ツール呼び出し、外部サービスが機能することを確認します。
  4. プラグインがorganizationで管理される場合、そのステータス、ユーザーの可用性、およびインストール状態が Agents>Tools>Plugins の意図した対象ユーザーと一致チェック。 代替バージョンがまだ使用中かどうかを確認します。
  5. 変更を承認するために使用した評価を繰り返します。
  6. ロールアウト後に使用シグナル、フィードバック、エラー、サポート ケースを確認します。
  7. 更新プログラムが受け入れ基準を満たしていない場合は、ロールアウトを一時停止し、失敗を記録し、責任所有者を関与させます。 リカバリ操作は、製品が文書化している場合にのみ使用してください。

対象ユーザーが正しいバージョンを持ち、そのアクセス設定が意図したロールアウトと一致し、代表的なタスクが受け入れ基準を満たし、すべての未解決の問題に所有者と次のアクションがある場合、更新が完了します。

更新を記録する

記録:

  • 以前のパッケージまたはエージェントのバージョンと更新されたバージョン。
  • 変更、理由、影響を受ける機能、依存関係。
  • ベースライン、評価、検証、およびユーザー テストの結果。
  • 発行方法、対象ユーザー、ロールアウト状態、該当するレジストリ状態。
  • 構成またはサービスの変更。
  • 既知の制限事項、文書化された回復オプションまたは手順のギャップ、およびサポート オーナー。

所有権とサポートを引き渡す

現在の所有者が役割を離れる前に、次の所有者に次の命令を付与します。

  • ソース、パッケージ、またはエージェント ID、現在のバージョン、リリース レコード、および公開ルート。
  • 監視の場所、代表的なテスト、既知の問題、オープンなサポート ケース。
  • 対象ユーザー、管理連絡先、必要な接続、外部サービス所有者。
  • ギャップを含む、文書化された更新、回復、および廃止の手順。

Agent Builder または Copilot Studio に組み込まれた共有エージェントの場合は、その手順が適用される場合は、[エージェントに新しい所有者を割り当てる] を使用します。 エージェントビルダーは、 所有者の追加もサポートしています。 変更を加える前に、前の所有者のアクセスへの影響を確認してください。

これらはエージェントの所有権手順であり、外部プラグインパッケージの一般的な転送手順ではありません。 ソース アクセス、公開アクセス、接続、資格情報、サービスの責任を個別に確認します。 次の所有者に、ソリューションの監視、保守、およびサポートができることを確認してもらいます。

プラグインまたはエージェントを廃止する

使用しなくなったソリューションは廃止します。 すべての顧客に対する配布を終了するか、または organization 内でのみアクセスを削除するかを決定します。これらのスコープは異なります。

  1. アクティブなバージョン、ユーザー、公開と共有の場所、共有される依存関係を特定します。
  2. ユーザーとサポート チームに、交換や廃止日を通知します。
  3. サポートされているルートを介した配布とアクセスを停止し、必要に応じて管理者のインストールを削除します。
  4. 他のソリューションで使用されるリソースを維持しつつ、サービス所有者にプラグイン固有のアクセスとリソースを削除してもらいます。
  5. 以前に承認されたユーザーで結果を確認し、保持リソース、例外、所有者を記録します。

パッケージを廃止するには、「 プラグインを廃止する」を参照してください。 スタンドアロン エージェントの場合は、 エージェントの削除などの該当する製品手順を使用します。 エージェントまたはパッケージを削除すると、すべての接続、アクセス許可、または外部サービスが取り消されると想定しないでください。