> ## Documentation Index
> Fetch the complete documentation index at: https://cogno.studio/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Google ChatをCognoに接続する

> 組織のGoogle Workspaceを接続すると、CognoがGoogle Chatのスペースのメッセージを読み取ってタスクを作り、メンションされると返信します。

![Google Chat](https://mintcdn.com/genaxis/sHTMRk7Yufbb5vuT/images/integrations/google-chat.svg?fit=max\&auto=format\&n=sHTMRk7Yufbb5vuT\&q=85\&s=d37fc5b04dbf10154c57a2d01f5fa660)

> [!NOTE]
>
> **ベータ版。** この連携は利用できますが、メッセージからのタスク・コンテキスト抽出の精度はまだ検証できていません。粗さが残る前提でお使いいただき、気づいた点をお知らせください。

## 概要

| | |
| - | - |
| **方向** | 双方向 — CognoはCognoアプリが追加されたGoogle Chatのスペースのメッセージと、アプリに送られたダイレクトメッセージを読み取り、Projectが読むスペースとそのダイレクトメッセージにはエージェントがCognoアプリとして投稿・返信できます。 |
| **接続方法** | Google Workspace管理者によるGoogleへのサインインと、Google Workspace MarketplaceからのCognoアプリのインストール。 |
| **設定できる人** | 連携を管理する権限を持つCogno memberが開始し、Google Workspaceの管理者がサインインとアプリのインストールを行います。 |
| **必要なもの** | Google Workspaceの組織（個人のGoogleアカウントは不可）と、その管理者。 |

組織のGoogle Workspaceを接続すると、Cognoは追加されたスペースの会話を読み取り、ワークスペースのコンテキストとして使い、依頼やフォローアップをtaskに変えます。スペースでCognoアプリをメンションすると、Cognoはすぐに返信に取りかかります。

## 事前確認

* 組織でGoogle Workspaceを使っている。個人のGoogleアカウントでは接続できません。
* Google Workspaceの管理者が代わりにサインインし、Google Workspace Marketplaceから組織の全員を対象にアプリをインストールできる。
* 組織のGoogle Workspaceドメインが、別のCognoワークスペースに接続されていない。1つのドメインは1つのCognoワークスペースにつながります。

## CognoでGoogle Chatを接続する

接続は2段階で、どちらも同じGoogle Workspace管理者が行います。ページの **接続の流れ** にも表示されます。

**1. Google Chat連携を開く**

**連携** を開き、**Google Chat** を選択します。

**2. 管理者としてサインインする**

**Google Workspace 管理者としてサインイン** を押し、開いたウィンドウでGoogleへのサインインを完了します。Cognoはそのアカウントが Google Workspace の管理者であることを確認し、組織のドメインをこのCognoワークスペースに紐づけます。

**3. Cognoアプリをインストールする**

ページに **設定を完了する** が表示され、接続は **アプリのインストール待ち** になります。**Marketplace を開く** を押し、Google Workspace Marketplaceから組織の全員を対象にCognoアプリをインストールします。

**4. Google Chatからの通信を待つ**

Google ChatからCognoに通信が届くと、ページは自動で更新されます。接続行に組織のドメインと、管理者のアドレスの **でサインイン済み** が表示され、**接続済み** になります。

## スペースにCognoを追加する

Cognoが自分でスペースに参加することはできません。Google Chatで、読み取らせたいスペースにCognoアプリを追加してください。追加されるとアプリはスペースで自己紹介し、Cognoはすぐにそのスペースのメッセージを受け取り始めます。

Google Chatページの **スペース** セクションには、Cognoアプリが追加されているスペースが、種類（**スペース** または **グループチャット**）と最終更新日とともに並びます。アプリが外されたスペースには **削除済み**、組織外の人が参加できるスペースには **外部ユーザー参加可** が付きます。GoogleがCognoに読み取りを許可しないスペースには、理由とともに **読み取り不可** が付きます。アプリとのダイレクトメッセージは一覧に出ません。

## Cognoが読むもの

* **読む:** Cognoアプリが参加しているスペースの新しいメッセージと、組織内の人がアプリに送ったダイレクトメッセージ。
* **外部ユーザーが参加できるスペース:** Googleが許可すれば、ほかのスペースと同じく、組織外のゲストのメッセージも含めて読みます。スペースを所有する組織がCognoアプリを承認していれば読み取れ、そうでなければGoogleが拒否し、そのスペースには **読み取り不可** が付きます。Cognoは約30分ごと、またアプリが追加し直されるたびにGoogleへ再度問い合わせます。
* **読まない:** Cognoアプリを含まないダイレクトメッセージと、アプリが参加していないスペース。
* **無視する:** Chatアプリが送ったメッセージ（Cogno自身のものを含む）。

組織外のゲストはディレクトリにいないため、そのメッセージにはGoogle Chatが送る氏名とメールアドレス（あれば）が付き、Cogno memberには紐づきません。

## Projectでスペースを選ぶ

Projectは、絞り込むまでCognoが読むすべてのスペースを読みます。Projectが一部のスペースだけを読むようにすると、ほかのスペースのメッセージからはそのProjectのAttentionやtaskは作られません。

**1. Projectの連携を開く**

Projectの設定を開き、**Projectの連携** の **Google Chat** の行を表示します。

**2. スペースを選ぶ**

**スペース** で、このProjectが読むスペースだけをオンにします。一覧に出るのは、アプリがまだ参加していて、GoogleがCognoに読み取りを許可しているスペースだけです。すべてオンに戻すと、あとから追加されたスペースも含めてすべてを読みます。

## Cognoをメンションする・使い方を聞く

* Cognoが読むスペースで **Cognoアプリを@メンション** すると、Cognoはそれを依頼として扱い、すぐにRunを開始して返信します。
* アプリに **`help`**（または `/help`、`ヘルプ`、`使い方`）と送ると、使い方の説明と、各Projectが読むスペースを選べるCognoへのリンクが返ります。
* **アプリにダイレクトメッセージを送る** と、Cognoは@メンションと同じく依頼として扱います。アプリは **受け取りました。対応して、ここで返信します。** と答え、Runがそのダイレクトメッセージで返信します。依頼はGoogle ChatをオフにしていないProjectに届き、複数ある場合はCognoが依頼に合うProjectを選びます。すべてのProjectがGoogle Chatをオフにしている場合は、アプリがその旨を伝えます。

アプリは、話しかけた人の言語設定に合わせて日本語または英語で返信します。誰もCognoをメンションしていなくても、会話で共有された計画・ToDo・質問にはCognoが応答することがあり、ルーティンを止める・変える依頼は必ず処理されます。同じスレッドへのフォローアップは、2つ目の応答を始めずに、進行中の応答に加わります。

## エージェントのアクセスを設定する

Google Chatページの **エージェントツール** で、この接続を通じてエージェントが行える操作を設定します。**Read Google Chat** は、Projectのスペースに保存されたメッセージの検索、スペースの最近のメッセージとスレッド全体の読み取り、スペース一覧、組織のディレクトリにいる人の検索を行います。読み取れるのは、スペースを接続してからCognoが保存した内容のうち、Projectが読むスペースだけです。初期状態は **許可** です。**Google Chatに送信** は、CognoアプリとしてProjectのスペースと、アプリに送られたダイレクトメッセージに投稿し、スレッドに返信します。初期状態は **許可** なので、@メンションやダイレクトメッセージには返信されます。

禁止するには **ブロック**、対話実行中に承認してから実行するには **確認**、承認を求めず実行するには **許可** を選びます。変更は次の実行から反映され、接続を解除するとすぐに利用できなくなります。エージェントが投稿できるのは、アプリがまだ参加していてProjectが読むスペースと、ProjectがGoogle Chatをオフにしていない場合の、アプリと組織内の人とのダイレクトメッセージだけです。チャットへの返信は短く保たれます。12行を超える投稿は、全文を求められた場合を除き拒否され、何も送信されません。そのためCognoは結論を先に書き、長い一覧は画像または上位3件にまとめ、詳細はTaskに残します。

**Projectの連携** の行は、最初ワークスペースの設定に従います。Projectでさらに制限することはできますが、ワークスペースが許可する範囲を広げることはできません。

## メンバー

Google Chatは発言者を内部IDでしか伝えないため、Cognoは組織のディレクトリから氏名とメールアドレスを読み取ります。メールアドレスがこのワークスペースのCognoアカウントと一致した人は自動で紐づきます。Cognoは接続時と1日4回これを更新します。

**メンバーの対応づけ** を開くと結果を確認でき、**メンバーを同期** ですぐに更新したり、Cogno **member** を手動で対応づけたりできます。

## 接続を解除する

接続行の **⋯** メニューから **接続を解除** を選び、確認します。CognoアプリはGoogle Workspace側に残ります。削除するには、Google Workspaceの管理者が管理コンソールから行ってください。

## よくある状態

| 状態 | 意味 | 次の対応 |
| - | - | - |
| **個人の Google アカウントでサインインしています。** | 個人のGoogleアカウントでサインインした | 組織のGoogle Workspaceアカウントでサインインする |
| **このアカウントは Google Workspace の管理者ではありません。** | サインインしたアカウントが管理者ではない | 管理者アカウントでもう一度サインインする |
| **Google から確認済みの本人情報が返されませんでした。** | Googleがアカウントを確認できなかった | Google Workspaceアカウントでもう一度サインインする |
| **… は別の Cogno ワークスペースに接続済みです。** | ドメインがすでに別のCognoワークスペースにつながっている | 先にそちらで接続を解除してから、もう一度サインインする |
| **Freeプランで連携できるサービスは3件までです。** | ワークスペースがFreeプランの上限に達している | Businessへアップグレードする |
| 接続が **アプリのインストール待ち** のまま | 管理者はサインインしたが、Google ChatからCognoにまだ通信が届いていない | **Marketplace を開く** からCognoアプリをインストールする。ページは自動で更新される |
| **接続に使った Google へのサインインの有効期限が切れています。** | 管理者のサインインが切れた。接続はしばらく動作する | Google Workspace管理者がもう一度 **Google Workspace 管理者としてサインイン** を押す |
| **スペース** に **スペースはまだありません。** と表示される | Cognoアプリがどのスペースにも追加されていない | Google ChatでスペースにCognoアプリを追加する |
| スペースに **外部ユーザー参加可** が付いている | 組織外の人が参加できるスペース | 対応は不要。Googleが許可すれば、ゲストのメッセージも含めてCognoが読む |
| スペースに **読み取り不可** が付いている | Googleがまだスペースのメッセージを渡していない。スペースを所有する組織のGoogle Workspace管理者が、Google Workspace MarketplaceからCognoアプリをインストールしていない | その管理者がMarketplaceからCognoアプリをインストールする。Cognoは自動で再度問い合わせる |
| スペースに **削除済み** が付いている | Cognoアプリがスペースから外された | 読み取らせたい場合はGoogle Chatでアプリを追加し直す |
| メッセージは届くのにAttentionやtaskが出ない | すべてのProjectがGoogle Chatをほかのスペースに絞っている | **Projectの連携** でそのスペースをProjectに対してオンにする |

## 参照URL

* [Google Workspace Marketplace](https://workspace.google.com/marketplace)
* [Google Chat apps](https://developers.google.com/workspace/chat)

## 関連docs

* [連携](/docs/ja/integrations.md)
* [トラブルシューティング](/docs/ja/troubleshooting.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.