マルチチャンネル概要

Triggerfishはあなたの既存のメッセージングプラットフォームに接続します。すでにコミュニケーションしている場所 — ターミナル、Telegram、Slack、Discord、WhatsApp、Webウィジェット、またはメール — どこでもエージェントと話せます。すべてのチャンネルは独自の分類レベル、オーナーアイデンティティチェック、ポリシー強制を持ちます。

チャンネルの仕組み

すべてのチャンネルアダプターは同じインターフェースを実装します：connect、disconnect、 send、onMessage、status。チャンネルルーターはすべてのアダプターの上に位置し、メッセージ配信、分類チェック、リトライロジックを処理します。

チャンネルルーター: すべてのチャンネルアダプターが中央の分類ゲートを通じてGatewayサーバーに流れる

メッセージが任意のチャンネルに到着すると、ルーターは：

コードレベルのアイデンティティチェックを使用して送信者（オーナーまたは外部）を識別します — LLMの解釈ではありません
メッセージにチャンネルの分類レベルをタグ付けします
強制のためにポリシーエンジンに転送します
エージェントのレスポンスを同じチャンネルを通じてルーティングします

チャンネル分類

各チャンネルには、それを通じて流れるデータを決定するデフォルトの分類レベルがあります。ポリシーエンジンはライトダウン禁止ルールを強制します：特定の分類レベルのデータは、より低い分類のチャンネルに流れることができません。

チャンネル	デフォルト分類	オーナー検出
CLI	`INTERNAL`	常にオーナー（ターミナルユーザー）
Telegram	`INTERNAL`	TelegramユーザーIDの一致
Signal	`PUBLIC`	オーナーになれない（アダプターはあなたの電話）
Slack	`PUBLIC`	OAuth経由のSlackユーザーID
Discord	`PUBLIC`	DiscordユーザーIDの一致
WhatsApp	`PUBLIC`	電話番号の一致
WebChat	`PUBLIC`	オーナーになれない（訪問者）
Email	`CONFIDENTIAL`	メールアドレスの一致

完全に設定可能すべての分類はtriggerfish.yamlで設定可能です。セキュリティ要件に

基づいて任意のチャンネルを任意の分類レベルに設定できます。

yaml

channels:
  telegram:
    classification: CONFIDENTIAL
  slack:
    classification: INTERNAL

有効な分類

任意のメッセージの有効な分類は、チャンネル分類と受信者分類の最小値です：

チャンネルレベル	受信者レベル	有効なレベル
INTERNAL	INTERNAL	INTERNAL
INTERNAL	EXTERNAL	PUBLIC
CONFIDENTIAL	INTERNAL	INTERNAL
CONFIDENTIAL	EXTERNAL	PUBLIC

これは、チャンネルがCONFIDENTIALとして分類されていても、そのチャンネルの外部受信者へのメッセージはPUBLICとして扱われることを意味します。

チャンネル状態

チャンネルは定義された状態を経由します：

UNTRUSTED — 新しいまたは不明なチャンネルはここから始まります。データは入出力しません。分類するまでチャンネルは完全に分離されます。
CLASSIFIED — チャンネルには分類レベルが割り当てられ、アクティブです。メッセージはポリシールールに従って流れます。
BLOCKED — チャンネルは明示的に無効化されています。メッセージは処理されません。

UNTRUSTEDチャンネル UNTRUSTEDチャンネルはエージェントからどんなデータも

受け取れず、エージェントのコンテキストにデータを送れません。これは提案ではなく、ハードなセキュリティ境界です。 :::

チャンネルルーター

チャンネルルーターはすべての登録済みアダプターを管理し、以下を提供します：

アダプター登録 — チャンネルIDでチャンネルアダプターを登録および登録解除
メッセージ配信 — アウトバウンドメッセージを正しいアダプターにルーティング
指数バックオフ付きリトライ — 失敗した送信は増加する遅延（1秒、2秒、4秒）で最大3回リトライ
バルク操作 — ライフサイクル管理のためのconnectAll()とdisconnectAll()

yaml

# ルーターのリトライ動作は設定可能
router:
  maxRetries: 3
  baseDelay: 1000 # ミリ秒

Ripple：タイピングとプレゼンス

Triggerfishはそれをサポートするチャンネル全体でタイピングインジケーターとプレゼンス状態を中継します。これはRippleと呼ばれます。

チャンネル	タイピングインジケーター	既読確認
Telegram	送受信	あり
Signal	送受信	—
Slack	送信のみ	—
Discord	送信のみ	—
WhatsApp	送受信	あり
WebChat	送受信	あり

エージェントのプレゼンス状態：idle、online、away、busy、processing、 speaking、error。

メッセージの分割

プラットフォームにはメッセージ長の制限があります。Triggerfishは各プラットフォームの制約に収まるように長いレスポンスを自動的に分割し、読みやすさのために改行またはスペースで分割します：

チャンネル	最大メッセージ長
Telegram	4,096文字
Signal	4,000文字
Discord	2,000文字
Slack	40,000文字
WhatsApp	4,096文字
WebChat	無制限

次のステップ

使用するチャンネルを設定します：

CLI — 常に利用可能、セットアップ不要
Telegram — @BotFatherでボットを作成
Signal — signal-cliデーモン経由でリンク
Slack — ソケットモードでSlackアプリを作成
Discord — Discordボットアプリケーションを作成
WhatsApp — WhatsApp Business Cloud API経由で接続
WebChat — サイトにチャットウィジェットを埋め込む
Email — IMAPとSMTPリレー経由で接続

マルチチャンネル概要 ​

チャンネルの仕組み ​

チャンネル分類 ​

有効な分類 ​

チャンネル状態 ​

チャンネルルーター ​

Ripple：タイピングとプレゼンス ​

メッセージの分割 ​

次のステップ ​