Slackが選択肢にないとき — ワークスペースのSlackテナントの外にいるとき、Telegram上のグループとコラボしたいとき、チームのSlackとは別に軽量なモバイル向けDMチャネルが欲しいとき — Telegramが向いています。
ボットはあなたが用意します。各Telegramボットは、Okouワークスペース内の1つのエージェントに紐づきます。個人用ボットとチーム用ボットを別々のエージェントにルーティングし、それぞれ異なるスキルセットを持たせる、といった構成もできます。
接続する
- Telegramで**@BotFather**と会話します。
/newbotを実行し、ボットに名前を付け、BotFatherが渡すトークンをコピーします。 - OkouでOkouが使える場所を開き、Telegramを選びます。
- ボットトークンを貼り付け、どのエージェントにルーティングするかを選択します。
- （グループ利用の場合）BotFatherでボットのプライバシーモードを無効化します。
/setprivacy→ ボットを選択 → Disable。これをしないと、ボットは直接@メンションされたメッセージしか見えません。無効にすると、メンションやリプライ周辺のグループコンテキストを読めるようになります。 - Telegramを開き、ボットにメッセージを送ります。最初のメッセージでOkou上に連携セッションが開始されます。
TelegramでのOkouの使い方
主なパターンは2つです。
ボットにDMする。 Okouとのプライベートチャットのように振る舞います。メッセージ、ファイル、写真をOkouがすべて受け取ります。各DMスレッドはOkou上のセッションにマッピングされます。
ボットをグループに追加する。 プライバシーモードを無効にすると、ボットはメンションとリプライ周辺のメッセージを読みます。@メンションするか、ボットのメッセージにリプライすることで会話を継続します。グループの他メンバーには、Okouの推論内容は見えず、ボットが返した結果だけが見えます。
よくあるTelegramワークフロー
- モバイルでの受信箱トリアージ。 電車の中でボットにDMする。「#csの未読Slackを要約して。」Okouが数秒で返信します。
- ベンダーやパートナーのグループ。 社外メンバーがいるグループにボットを追加します。社内Slackを露出させずに、スケジュール調整、リマインダー、翻訳を任せられます。
- エージェントごとのボット。 リサーチ用ボットをリサーチエージェントに、個人用ボットを個人用エージェントに紐づけます。同じTelegramアプリ内で別のボット、別のエージェントとして動きます。
エージェントごとのルーティング
各ボットトークンは厳密に1つのエージェントに紐づきます。別のエージェントに答えさせたい場合は、BotFatherで2つ目のボットを作成して紐づけます。これは意図的な設計です。Telegramボットのアイデンティティは、そのサーフェスにおけるエージェントのアイデンティティそのものだからです。
ファイル対応
Telegramは写真、ボイスノート、ドキュメント、PDFに対応します。Okouはそれらをすべてセッション入力として取り込みます。Okouが生成した成果物の送信は、Telegramドキュメントまたは画像としてインラインで返されます。
よくある落とし穴
- グループでボットが返信しない。 プライバシーモードがまだ有効です。BotFatherで
/setprivacy→ Disableを再実行し、ボットを一度グループから外して再追加してください。 - 答えるエージェントが違う。 ボットトークンは1つのエージェントに紐づきます。変更するにはOkouが使える場所で紐づけを切り替えるか、別のボットを使います。
- ボットトークンの漏えい。 BotFatherで
/revokeを実行してローテーションし、Okouでトークンを更新します。旧トークンは即座に無効になります。