通知と配信

Anyyは常駐Gatewayを通じて、即時通知やユーザー向けメッセージを発行できます。配信はルートを認識します。アシスタントが宛先にできるのは、現在のユーザーや現在のChannel会話の信頼された起点であり、任意の外部連絡先ではありません。

2つのメッセージ操作

操作	内容とルーティング
通知（notify_user）	テキストと任意のタイトル。deliveryでGateway、信頼された起点、指定Channelの既定紐付けを選択可能。添付入力はない
メッセージ（send_message）	テキストと対応添付。targetはcurrent_userかoriginのみ。deliveryやChannel選択入力はない

send_messageのcurrent_userはランタイムの現在のルートを使います。通常のDashboard/TUI要求はGatewayへ、信頼されたChannel会話は通常その起点へ返信します。明示的なoriginには信頼されたChannelメタデータが必要です。別プラットフォームの既定紐付けを選ぶものではありません。

両操作は監査されます。送信は非冪等なので、再試行すると重複メッセージが生じる場合があります。

チャット履歴の通知

会話に紐付いた独立したシステム通知は、別の会話へ移動して戻ったり、ページを再読み込みしたりしても表示されます。Agentの返信に変わらず、System notificationカードのまま保持されます。古い通知は会話履歴とともに読み込まれ、再接続しても同じ通知がもう1つ作られることはありません。

これらのシステムカードはPiの会話メッセージとは別の表示記録です。モデルのコンテキストに入らず、選択した会話の分岐も変えません。添付付きメッセージには既存の会話表示が使われる場合があり、それを独立システムカードとして二重表示しません。

Anyyは発行前に、保護された通知本文に専用の永続的な所有記録を与えます。これは配信再試行ペイロードとは別です。完了配信の再試行ペイロードを消しても会話履歴は消えません。会話を削除すると、通知履歴も会話とともに削除されます。

これは現在の実装で保存された通知に適用されます。正確な本文がすでに解放された古い通知を、ジョブの状態や要約から確実に復元することはできません。Heartbeat通知など、セッションに紐付かないProfile全体のライブイベントは、この会話ごとの履歴保証の対象外です。

配信先

予約ジョブとテキスト通知は以下のルーティング用語を使います。noneはDashboard/CLIのスケジューラー管理で使えますが、notify_userの配信先としては受け付けません。これらはsend_messageのtarget値ではありません。

対象	意味
gateway	常駐Gatewayイベントストリームに発行
origin	現在のChannel会話の信頼された起点へ返す
current_user_default	現在ユーザーの既定紐付けを解決。notify_userではdelivery.channelが必須（例：telegram）
none	ユーザー向け結果を配信しない

Anyyはプラットフォーム名を任意の受信者アドレスとして扱いません。設定・認可済みのChannel紐付けでルートを解決する必要があります。

送信を依頼する

例：

When this check finishes, notify me with the title “Backup verified” and a one-line result.

Send this summary back to the current Channel conversation.

設定済みの既定紐付けへのテキスト通知なら、次のように依頼します。

Notify my default Telegram binding with a short text summary of this result.

添付の場合は、レポートArtifactが利用可能な、信頼されたTelegram会話で依頼します。

Reply to this Telegram conversation with the generated report as an attachment.

前者はnotify_userでdelivery: { target: "current_user_default", channel: "telegram" }を使えます。添付要求は信頼された起点へのsend_messageを使います。現在のインターフェースでは、Dashboardから任意に選んだ既定Telegram紐付けにレポートを添付できません。

信頼された起点や既定紐付けがない場合、Anyyは受信者を推測せず、ルートが利用不可と報告します。

受領記録と配信状態

発行成功は、Anyyがイベントを受理し、配信パイプラインへ送出したことを示します。それだけでTelegram、メール、SMSなど外部サービスの最終受領を証明するものではありません。

メッセージ送信では、後からアダプターの配信進捗を反映する受領記録が作られる場合があります。アダプターの能力は異なり、確認応答を報告するものも、送出だけを報告するものもあります。Channelの健全性だけでなく、元会話のシステムカード、バックグラウンドの子、Cron履歴を確認します。実行完了と外部配信は別の状態です。

状況を確認せずに再試行しない

成否不明の送信を再試行する前に、受領記録やChannelの健全性を確認します。最初の送信がプロバイダーに届いて確認が遅れただけの場合、2回目は重複します。

添付ファイル

send_messageの添付は現在のセッション範囲で利用可能であり、現在／信頼された起点のChannelがそのメディア種別に対応を宣言している必要があります。notify_userは既定Channel紐付けを選ぶ場合もテキスト専用です。未対応添付は黙って捨てずに拒否されます。

既定ルートを設定する

Dashboard → Channelまたはanyy setup channelで接続し、送信者アクセスポリシー／ペアリングを確認してテストします。その後、予約ジョブでcurrent_user_defaultと配信チャンネルを選べます。

メッセージングプラットフォームと予約自動化を参照してください。

トラブルシューティング

問題	対処
既定ルートがない	現在ユーザーのChannel紐付けを設定・検証
起点への配信が使えない	信頼されたChannel会話から依頼
発行成功なのに外部メッセージがない	受領記録、Gateway状態、Channel doctor出力を確認
メッセージが重複する	自動再試行を止め、前の受領記録／イベントを確認
添付が拒否される	選択Channelが対応するメディア種別を使用