概要
CognoはMicrosoft Teamsのリソース固有の同意（RSC）を使用します。Cognoを追加すると、そのTeam、グループチャット、または会議チャットだけが許可され、組織内のすべての会話が許可されるわけではありません。その後、取り込むチャネルと含める対象チャットを選びます。Projectへの割り当てはあとから行えます。
人同士の1対1チャットには対応していません。2名以上のグループチャットと会議チャットは、その会話にCognoを追加すると利用できます。
始める前に
- Microsoft 365管理者に、組織内でCognoをどの方法で配布するか確認します。組織のアプリカタログから利用できる場合と、限定導入用にCogno提供のパッケージを管理者がアップロードする場合があります。
- 対象Microsoftテナントのメンバーである職場または学校アカウントを使用します。個人用Microsoftアカウントとゲストのみのアカウントでは本人確認を完了できません。
- 対象Cogno Workspaceで連携を管理できることを確認します。
- 接続する各Teamまたはチャットに現在参加していることを確認します。
Microsoft TeamsでCognoを利用可能にする
Microsoft 365管理者が次のいずれかを実施します。自社で利用できる方法が分からない場合は、Cogno担当者へお問い合わせください。確認できない提供元のパッケージはアップロードしないでください。方法1：組織のアプリカタログを使う
1
Teamsのアプリ一覧を開く
Microsoft Teams管理センターでTeams apps→Manage appsを開きます。
2
Cognoを探す
Cognoを検索します。App statusがUnblockedで、対象ユーザーがAvailable toに含まれることを確認します。
3
必要に応じてアクセスを調整する
Cognoがブロックされている、または対象ユーザーが利用できない場合は、組織のTeamsアプリ設定を更新してから続けます。
方法2：限定導入用のCognoパッケージをアップロードする
1
Cognoからパッケージをダウンロードする
CognoでIntegrations→Microsoft Teamsを開き、Download Teams appを選びます。接続済みのWorkspaceでは**⋯**メニューにもあります。パッケージはサインイン中のCogno環境向けに作られるため、接続するWorkspaceと必ず一致します。Open Teams admin centerで次の手順の画面を開けます。
2
アプリをアップロードする
Teams apps→Manage appsでActionsを開き、Upload new appを選んでパッケージを指定します。
3
利用可能な状態を確認する
Cognoを検索し、App statusがUnblockedで、対象ユーザーがAvailable toに含まれることを確認します。Microsoftによると、アップロードしたアプリが利用可能になるまで数時間かかる場合があります。
Teamの所有者またはチャットのメンバーは、アプリ追加時に要求権限を確認できます。これらの権限でテナント全体へのアクセスが許可されることはありません。
CognoでMicrosoft Teamsを接続する
Cognoはサインイン結果を処理する前に、1,000個を超えるフィールドや1 MiBを超えるフィールドを含むサインインコールバックフォームを拒否します。1
Microsoft Teamsの設定を開く
Cognoで対象Workspaceを開き、Integrationsへ移動してMicrosoft TeamsのConnectを選びます。設定途中の場合はResumeを選びます。
2
Microsoftへサインインする
メンバーの職場または学校アカウントでMicrosoftへのサインインを完了します。Cogno Desktopでは既定のブラウザが開き、完了後にアプリへ戻ります。自動で戻らない場合は完了ページのOpen Cognoを選びます。
3
管理者の承認を完了する
Admin approval requiredが表示されたらOpen admin approvalを選びます。別の人がMicrosoftテナント管理者の場合はCopy approval linkを選び、有効期限の短いリンクをその人へ送ります。Cognoが結果を自動確認します。
4
Teamを選ぶ
Team selection pendingでSelect a Teamを開き、Teamを1つ選んでConnect Teamを選びます。必要に応じてLoad more Teamsを使用します。
5
接続を確認する
Teamの行にTeam名、Microsoftテナント名、Connectedが表示されることを確認します。Microsoft TeamsでそのTeamにCognoを追加済みなら、行にCogno app addedも表示されます。同じWorkspaceに別のTeamを接続するにはAdd Teamを使用します。
チャネルの取り込みを開始または停止する
Channelsで、新しいメッセージをWorkspaceイベントにする各チャネルのスイッチをオンにします。ほかのチャネルへ影響を与えずに1つのチャネルを停止するにはスイッチをオフにします。
チャネルが8つを超えるとSearch channelsで検索できます。一覧を再読み込みするには**⋯メニューのRefresh channels and chats**、追加のチャネルを取得するにはLoad more channelsを使用します。状態の閲覧にはWorkspaceへのアクセス権、取り込みの変更には連携管理権限が必要です。
グループチャットまたは会議チャットを含める
1
会話にCognoを追加する
Microsoft Teamsでグループチャットまたは会議チャットを開き、アプリを追加してCognoを選びます。RSC権限を確認し、追加を完了します。接続コードは不要です。Cognoが設定手順つきの短いあいさつを投稿します。どの会話でも @Cogno help と送ると、もう一度表示されます。チャットをIncludeする前にCognoへメンションすると、Includeの手順を1回だけ返します。それ以降のメンションには、Includeするまで返事をしません。
2
Microsoftアカウントを確認する
CognoのMicrosoft Teams設定へ戻ります。求められた場合はVerify Microsoft accountを選び、対象チャットに参加しているアカウントでサインインします。Cognoが保存するのは確認済みアカウントの識別子で、Microsoftのアクセストークンやリフレッシュトークンではありません。
3
対象チャットを更新する
⋯メニューのRefresh channels and chatsを選びます。Chatsには、アプリが追加され、確認済みアカウントが現在参加しているチャットだけが表示されます。
4
チャットを含める
チャットのスイッチをオンにします。以後の新しいメッセージをWorkspaceイベントとして扱え、そのチャットはTeamのチャンネルと並んで各Projectに提示されます。新規メッセージイベントを停止するにはスイッチをオフにします。そのチャットを選択していたProjectは同時に利用できなくなります。
Projectで使うソースを選ぶ
Workspaceへの追加とProjectからのアクセスは別々に設定します。チャンネルもチャットも同じ仕組みです。- Cognoが参照してよい範囲はWorkspaceが決めます。連携 → Microsoft Teamsでチャンネルを取り込み、アプリを追加したチャットを含めます。
- そのうちどれを使うかは各Projectが決めます。Projectの連携設定でMicrosoft Teamsを有効にし、同じ一覧からチャンネルと含めたチャットを選びます。同じチャットを複数のProjectが選択できます。
- あるProjectでチャットの選択を外しても、他のProjectには影響しません。Workspaceで外すを選ぶと、すべてのProjectから同時に利用できなくなります。
エージェントの読み取りアクセスを管理する
接続のAgent toolsセクションにあるRead Microsoft Teamsで、次の7つの読み取り専用ツールを管理します。teams_search_messagesは最近保存されたチャネルメッセージを検索します。teams_read_fileは、そのmessage_idとattachment_idでファイルを1つ読みます。SharePointまたはOneDriveにリンクされたファイルはテキスト（プレーンテキスト、CSV、JSON、XMLなどとPDFのページテキスト）または画像そのものを返し、メッセージに貼り付けた画像は画像を返します。テキストは20,000文字、画像は1 MB、PDFは5 MBで打ち切り、それを超えるファイルやその他の種類は、内容を読まなかった旨の注記付きでメタデータだけを返します。リンクされたファイルを読むには、Teamを接続したMicrosoftアプリケーションにFiles.Read.AllまたはSites.Read.Allのアプリケーション権限が必要です。権限がない場合、ツールは空の結果を返さず、Microsoftがファイルの提供を拒否したことを報告します。読めるのは現在のProjectが選択したチャネルで共有されたファイルだけで、読んだ内容は保存されません。teams_list_channelsは現在のProjectが選択したチャネルとチャットを一覧表示します。teams_read_channelは一覧内の1つのソースをMicrosoftから直接、件数を制限して読みます。teams_read_threadは、ソースとスレッドの親メッセージを指定してMicrosoftからスレッドを直接読みます。チャネルでは親投稿と返信、チャットではそのメッセージとその前のメッセージを返します。検索結果には必要なソースと親メッセージが含まれます。teams_get_userはメッセージ系ツールが投稿者として返すIDから1人のTeamsユーザーを引き、表示名、対応づけたmember、その人をメンションする@名前のテキストを返します。teams_search_usersはTeamsの表示名またはCognoのメンバー名の一部からTeamsユーザーを探します。
attachment_id、名前、種類で列挙します。コメントなしで投稿されたファイルは[attachment: 名前]、メッセージに貼り付けた画像は[attachment: image]として表示されます。
確認なしで利用可能にするにはAllow、立ち会い実行時に許可を求めるにはAsk、無効にするにはBlockを選びます。3つのlive toolとteams_read_fileはToolCall時にMicrosoftへ問い合わせます。ユーザー系の2つのツールはメンバーの対応づけから答えるため、その接続で投稿またはメンションされたことのある人しか知りません。Microsoftのディレクトリは検索しません。すべてのツールは現在のProjectで選択したソースに制限され、テナント全体のチャット検索は提供しません。
メッセージを投稿・返信する
Microsoft Teamsに送信は、読み取り権限とは別にteams_send_messageとteams_send_fileを制御します。初期設定は許可で、Cognoはメンションされると返信できます。立ち会い実行時に承認するには確認、送信を止めるにはブロックを選びます。Projectではさらに厳しい設定にできます。
送信を有効にするには、対象TeamまたはチャットにCognoアプリが追加されている必要があります。ツールを有効にするためだけに既存アプリを更新する必要はありません。Projectで選択したチャンネルまたはグループ・会議チャットへCogno botとして投稿します。返信にはlive読み取りツールが返したルートメッセージを使います。本文の上限は10,000文字です。スレッドへの返信はチャンネルで利用できます。投稿にはTaskのファイルを1つ付けられます。1 MB以下のPNG・JPEG・GIFは投稿の中に表示され、それ以外のファイルは名前・サイズとCognoで開くボタンのカードになり、ファイルのあるTaskが開きます。テナント全体のSharePointへの書き込み権限が必要になるため、チャンネルのファイルタブには置きません。リアクション、編集、削除には対応していません。チャットへの返信は短く保たれます。12行を超える投稿は、全文を求められた場合を除き拒否され、何も送信されません。そのためCognoは結論を先に書き、長い一覧は画像または上位3件にまとめ、詳細はTaskに残します。
本文の@名前は、その接続のメンバーの対応づけでその名前（Teamsの表示名またはCognoのメンバー名）を持つユーザーがちょうど1人のとき、Teams上の実際のメンションになります。誰も持たない名前や複数人が持つ名前は、そのままテキストとして送られます。使うべき@名前はteams_get_userとteams_search_usersが返します。
チャンネルの読み取りはTeam接続時に承認されたMicrosoftアプリケーションを使い、別途botを追加する必要はありません。チャットの読み取りには、そのチャットへのアプリ追加とWorkspaceへの追加が必要です。接続済み、取り込み中、含めるだけではProjectからのアクセスは許可されず、Project自身の選択が必要です。
選択したチャンネルは、そのTeamにCognoアプリが追加されていなくても、保存済みメッセージを検索するソースとしてエージェントに表示されます。live会話ツールとメッセージ送信には、引き続き有効なアプリ追加が必要です。
Microsoftが送信を確認できなかった場合、Cognoは結果不明として自動再送を拒否します。別の送信を試す前にTeamsを確認してください。
チャットでCognoに依頼する
ワークスペースに追加され、Projectで選択されたグループチャットまたは会議チャットで**@Cognoをメンションすると、その会話で回答を依頼できます。CognoはTeamsのメンション自体を認識し、文字として入力した@Cognoは依頼として扱いません。Cognoは会話を読むためのProject Runをキューに入れます。Cognoはメンションに対して、その会話で必ず短くても返信します。Microsoft Teamsに送信の初期設定は許可です。接続またはProjectでブロック**にした場合、CognoはTeamsで返信できません。メンションが届いたことが分かるよう、Cognoはすぐに「👀 確認しています。」(Teamsクライアントの言語)と返し、回答はRunが終わってから続きます。Runは利用可能なEnvironmentを待つ場合もあります。個人との1対1チャットには対応していません。誰もCognoをメンションしていなくても、会話で共有された計画・ToDo・質問にはCognoが応答することがあり、ルーティンを止める・変える依頼は必ず処理されます。同じスレッドへのフォローアップは、2つ目の応答を始めずに、進行中の応答に加わります。Graph通知経由で受信したメッセージでは、新しく送信したメッセージ(チャネルのメッセージや返信を含む)へのメンションが依頼になります。既存メッセージの編集でメンションを追加しても、リアクションでも、新しい依頼にはなりません。
接続を検証する
1
識別しやすいメッセージを送る
取り込み中のチャネルまたは含めたチャットに、機密情報を含まない固有のテストメッセージを送ります。顧客の機密情報をテストに使わないでください。
2
ソースが有効か確認する
CognoのMicrosoft Teams設定で、チャネルがImportingまたはチャットがIncludedであることを確認します。
3
エージェントのアクセスを試す
ソースをテスト用Projectへ割り当て、Read Microsoft TeamsをAllowまたはAskにして、そのProjectのエージェントへ直近のTeamsメッセージを読むよう依頼します。エージェントには、そのProjectで選んだソースだけが表示されます。
接続を解除する
Connected TeamsでTeamを選び、その行の**⋯メニューからDisconnect**を選んでTeam名を確認します。Cognoはその接続の取り込みを停止します。ほかの接続済みTeamは有効なままです。よくある状態
参照URL
- Microsoft：Teams管理センターでアプリを管理する
- Microsoft：カスタムアプリをアップロードして管理する
- Microsoft：Teamsにアプリを追加する
- Microsoft：リソース固有の同意権限
- Microsoft：アプリへの同意を管理する