Copilot Studioのエージェントがテストでは動くのにTeams・公開チャネルで応答しないとき、認証と公開状態を切り分ける

テストとTeams公開channelの差をagent/version/user/認証/会話で比較し、共有・公開反映・対応場所を切り分けます。

AIものさし編集部

Copilot Studioのテストでは答えるのにTeams等の公開channelで応答しない場合、同じagentの同じ公開バージョン・利用者・channelを比べます。makerのテスト成功は、利用者への共有、アプリの利用許可、公開反映、必要な認証やknowledgeへのアクセスまで保証しません。

この記事は公開経路の診断です。agent公開、Teams appの追加・無効化、channel切替、再認証、scopeや共有変更は実施していません。比較表は設計例で、実tenantの応答成功を測定したものではありません。

agent IDと、最後に公開した内容を確認する

environment、agent ID、公開日時、channel、利用者、conversation IDとerror時刻を記録します。テスト中の未公開変更と、Teamsで利用される公開内容を区別します。同名copyや別environmentのアプリを開いていないかも確認します。

Teams接続の公式資料(新しいタブで開く)は、利用前に少なくとも一度の公開が必要で、更新後の内容が進行中の会話へ直ちに現れないことを説明しています。公開したつもりで日時を確認しないまま、認証設定を変更し続けないようにします。

表は横にスクロールできます

比較する条件テスト側公開channel側
agentID・environment実際に追加されたapp
バージョン現在の編集中定義最後の公開内容
identitymaker実際の利用者
会話新しいテストsession既存または新規conversation
resourcemakerの取得条件利用者のアクセス条件

発見・追加・会話・knowledgeを別々に診断する

appが見つからない、追加できない、起動しても返答しない、特定の質問だけ無回答は別の問題です。組織がPower Platform appをTeamsへ追加できる設定か、利用者にagentが共有されているか、対象channelが接続済みかを確認します。makerへの共同編集権限と、利用者が会話できる範囲を混同しません。

appを開けるなら、簡単な挨拶等の非機密な質問と、knowledgeを必要とする質問を分けます。前者が返り後者だけ失敗するなら、channel全体の無応答と同じ修正にはしません。生成回答の引用だけが描画されない場合も、何も返らない場合と分けて確認します。

channelに対応した認証と、利用場所を確認する

認証設定の公式資料(新しいタブで開く)で、対象channelが対応する認証optionを確認します。現行資料はTeams + Microsoft 365 channelにAuthenticate with Microsoftを案内しています。他channelのmanual認証例を、そのまま同じ構成へ移しません。利用中のagent方式と実際の設定画面も照合します。

認証の保存と公開反映は別です。また、optionを替えると既存topicの認証変数が使えなくなる場合があります。認証なしに変更して通すのではなく、必要なuser identity、resource、topic変数、公開版の対応を整理します。秘密値やaccess tokenを会話のdebug出力へ表示しません。

Teamsでは1:1、group chat、channelを別に検証します。公式接続資料は、end-user認証が必要なSharePoint等のknowledgeをgroup chat/channelで使えない制約を説明しています。1:1で成功した結果を、すべての会話場所へ適用しないようにします。複数利用者のデータを共有空間へ出さないための境界として扱います。

公開直後の既存会話と、構成の更新問題を分ける

公開内容の反映を比べるときは、元のconversation IDと時刻を保存し、新しい会話条件で確認します。公式資料にはStart overで新しい会話へ進む案内がありますが、進行中の業務状態を失わないよう、必要な記録を先に残します。

同じ公開後にSystemErrorが出る場合、Teamsが古い構成を保持する既知問題も公式資料にあります。ただし、すべてのSystemErrorをその原因と断定しません。公開バージョン、起動条件、errorとconversation IDを確認し、必要なら管理者と公式の更新手順を計画します。診断の最初に全利用者のappを無効化したり、channelを切断して作り直したりしないようにします。

表は横にスクロールできます

観察確認する境界すぐにしない変更
app追加前で拒否共有・組織app方針agent全体の再作成
古い回答だけ返る公開内容と会話全cacheの削除
1:1成功・group失敗channelの認証制約SharePoint権限の一括拡大
特定knowledgeだけ無回答user権限・検索・source推測で回答を補完
SystemErrorID・公開時刻・構成既知問題と即断

利用者の一連の仕事で受入確認する

許可された検証では、maker以外の対象userが正しいappへ到達し、対応channelで必要な認証と質問を完了できるかを確認します。閲覧できないsourceへの質問や未対応場所では、許可外の情報を出さず、適切な不足案内になることも条件にします。

変更前の公開バージョン、channel設定、認証方式、共有範囲を保存します。失敗した差分を戻す場合も、既存会話と外部toolの処理が残るかを確認します。完了記録には、回復したuser/channel/質問、確認した公開版、残った制約、実際に試していない経路を残します。