Telegram

TelegramエージェントをTriggerfishに接続して、Telegramを使用しているどのデバイスからでも対話できるようにします。アダプターはTelegram Bot APIと通信するために grammYフレームワークを使用します。

セットアップ

ステップ1：ボットを作成する

Telegramを開き@BotFatherを検索
/newbotを送信
ボットの表示名を選択（例：「My Triggerfish」）
ボットのユーザー名を選択（botで終わる必要があります、例：my_triggerfish_bot）
BotFatherがボットトークンを返信 — コピーしてください

トークンを秘密に保つボットトークンはボットの完全な制御を付与します。

ソースコントロールにコミットしたり公開したりしないでください。Triggerfishはそれを OSキーチェーンに保存します。 :::

ステップ2：TelegramユーザーIDを取得する

Triggerfishはメッセージがあなたからのものかどうかを確認するために数値のユーザーIDが必要です。Telegramのユーザー名は変更可能で、アイデンティティには信頼できません — 数値IDは永続的でTelegramのサーバーによって割り当てられるため、なりすましできません。

Telegramで@getmyid_botを検索
何かメッセージを送信
ユーザーIDを返信（8019881968のような数値）

ステップ3：チャンネルを追加する

対話型セットアップを実行します：

bash

triggerfish config add-channel telegram

ボットトークン、ユーザーID、分類レベルを入力するよう求められ、設定をtriggerfish.yamlに書き込み、デーモンの再起動を提案します。

手動で追加することもできます：

yaml

channels:
  telegram:
    # botTokenはOSキーチェーンに保存
    ownerId: 8019881968
    classification: INTERNAL

オプション	タイプ	必須	説明
`botToken`	string	はい	@BotFatherからのBot APIトークン
`ownerId`	number	はい	Telegramの数値ユーザーID
`classification`	string	いいえ	分類上限（デフォルト：`INTERNAL`）

ステップ4：チャットを始める

デーモンを再起動した後、TelegramでボットをOpenし/startを送信します。ボットが接続がライブであることを確認するためにあいさつを返します。その後、エージェントと直接チャットできます。

分類の動作

classification設定は上限です — オーナーの会話でこのチャンネルを通じて流れるデータの最大感度を制御します。すべてのユーザーに一様には適用されません。

メッセージごとの動作：

あなたがボットにメッセージを送る（あなたのユーザーIDがownerIdと一致）：セッションはチャンネル上限を使用します。デフォルトのINTERNALでは、エージェントがあなたに内部レベルのデータを共有できます。
他の誰かがボットにメッセージを送る：チャンネル分類に関係なく、そのセッションは自動的にPUBLICにtaintされます。ライトダウン禁止ルールが内部データがそのセッションに到達することを防ぎます。

これは単一のTelegramボットがオーナーと非オーナーの両方の会話を安全に処理することを意味します。アイデンティティチェックはLLMがメッセージを見る前にコードで行われます — LLMはそれに影響できません。

チャンネル分類	オーナーメッセージ	非オーナーメッセージ
`PUBLIC`	PUBLIC	PUBLIC
`INTERNAL`（デフォルト）	INTERNAL以下	PUBLIC
`CONFIDENTIAL`	CONFIDENTIAL以下	PUBLIC
`RESTRICTED`	RESTRICTED以下	PUBLIC

完全なモデルについては分類システムを、taintエスカレーションの仕組みについてはセッションとTaintをご覧ください。

オーナーアイデンティティ

Triggerfishは送信者の数値TelegramユーザーIDを設定されたownerIdと比較することでオーナーステータスを決定します。このチェックはLLMがメッセージを見る前にコードで行われます：

一致 — メッセージはオーナーとしてタグ付けされ、チャンネルの分類上限までデータにアクセスできます
不一致 — メッセージはPUBLIC taintでタグ付けされ、ライトダウン禁止ルールが分類されたデータがそのセッションに流れることを防ぎます

常にオーナーIDを設定する ownerIdなしでは、Triggerfishはすべての送信者を

オーナーとして扱います。ボットを見つけた人は誰でもチャンネルの分類レベルまでデータにアクセスできます。この理由からこのフィールドはセットアップ時に必須です。 :::

メッセージの分割

Telegramには4,096文字のメッセージ制限があります。エージェントがこれより長いレスポンスを生成すると、Triggerfishは自動的に複数のメッセージに分割します。チャンカーは読みやすさのために改行またはスペースで分割します — 単語や文章の途中で切ることを避けます。

サポートされるメッセージタイプ

Telegramアダプターは現在以下を処理します：

テキストメッセージ — 完全な送受信サポート
長いレスポンス — Telegramの制限に収まるように自動的に分割

タイピングインジケーター

エージェントがリクエストを処理しているとき、ボットはTelegramチャットに「typing...」を表示します。LLMがレスポンスを生成している間インジケーターが動き、返信が送信されるとクリアされます。

分類の変更

分類上限を上げたり下げたりするには：

bash

triggerfish config add-channel telegram
# プロンプトで既存の設定を上書きするよう選択

またはtriggerfish.yamlを直接編集します：

yaml

channels:
  telegram:
    # botTokenはOSキーチェーンに保存
    ownerId: 8019881968
    classification: CONFIDENTIAL

有効なレベル：PUBLIC、INTERNAL、CONFIDENTIAL、RESTRICTED。

変更後にデーモンを再起動：triggerfish stop && triggerfish start

Telegram ​

セットアップ ​

ステップ1：ボットを作成する ​

ステップ2：TelegramユーザーIDを取得する ​

ステップ3：チャンネルを追加する ​

ステップ4：チャットを始める ​

分類の動作 ​

オーナーアイデンティティ ​

メッセージの分割 ​

サポートされるメッセージタイプ ​

タイピングインジケーター ​

分類の変更 ​