Tools

リアクション

エージェントは、message ツールの react アクションを使用して絵文字リアクションを追加および削除します。動作はチャンネルによって異なります。

仕組み

json

{  "action": "react",  "messageId": "msg-123",  "emoji": "thumbsup"}

リアクションを追加する場合、emoji は必須です。
対応しているチャンネルでボットのリアクションを削除するには、emoji を空文字列（""）に設定します。
特定の絵文字を1つ削除するには、remove: true を設定します（空でない emoji が必要です）。
ステータスリアクションに対応するチャンネルでは、リアクションで trackToolCalls: true を指定すると、ランタイムは同じターン中にそのリアクション対象メッセージを、以降のツール進行状況リアクションに再利用できます。

チャンネルごとの動作

Discord と Slack

空の emoji を指定すると、メッセージ上のボットのすべてのリアクションが削除されます。
remove: true を指定すると、指定した絵文字のみが削除されます。

Nextcloud Talk

リアクションの追加のみ対応しています。emoji は必須で、空にできません。
リアクションの削除はまだ削除呼び出しに接続されていません。remove: true は何もせずに暗黙的に処理されるのではなく、明示的なエラーで拒否されます。
reaction 機能を使用して登録された Talk ボットが必要です（Nextcloud Talk チャンネルのドキュメントを参照）。

Telegram

空の emoji を指定すると、ボットのリアクションが削除されます。
remove: true でもリアクションは削除されますが、ツールの検証では引き続き空でない emoji が必要です。

WhatsApp

空の emoji を指定すると、ボットのリアクションが削除されます。
remove: true は内部的に空の絵文字へマッピングされます（ツール呼び出しでは引き続き emoji が必要です）。
WhatsApp では、メッセージごとにボット用のリアクション枠が1つあります。新しいリアクションを送信すると、複数の絵文字が積み重なるのではなく、既存のリアクションが置き換えられます。

Zalo Personal (zalouser)

追加と削除のどちらにも、空でない emoji が必要です。
remove: true を指定すると、その特定の絵文字リアクションが削除されます。

Feishu/Lark

個別のツールではなく、他のチャンネルと同じ react アクションを使用します（メッセージリアクション ID を介した追加、削除、一覧取得）。
追加には空でない emoji が必要です（Feishu の emoji_type にマッピングされます。例：SMILE、THUMBSUP、HEART）。
remove: true には空でない emoji が必要で、その絵文字タイプに一致するボット自身のリアクションを削除します。
clearAll: true とともに空の emoji を指定すると、メッセージ上のボットのすべてのリアクションが削除されます。

Signal

受信リアクション通知は channels.signal.reactionNotifications で制御します。"off" は通知を無効にし、"own"（デフォルト）はユーザーがボットのメッセージにリアクションしたときにイベントを発行し、"all" はすべてのリアクションについてイベントを発行し、"allowlist" は channels.signal.reactionAllowlist に含まれる送信者についてのみイベントを発行します。

iMessage

送信リアクションは iMessage のタップバック（love、like、dislike、laugh、emphasize、question）です。リアクションを追加するには、emoji がこれらの種類のいずれかにマッピングされる必要があります。
認識されるタップバックの種類を指定せずに remove: true を使用すると、すべてのタップバックの種類が削除されます。認識される種類を指定すると、その種類のみが削除されます。

リアクションレベル

チャンネルごとの reactionLevel は、エージェントが自身のリアクションを送信する頻度を制限します。値：off、ack、minimal、extensive。

Telegram のリアクション通知 - channels.telegram.reactionLevel（デフォルト：minimal）
WhatsApp のリアクションレベル - channels.whatsapp.reactionLevel（デフォルト：minimal）
Signal のリアクション - channels.signal.reactionLevel（デフォルト：minimal）

関連項目

エージェント送信 - react を含む message ツール
チャンネル - チャンネル固有の設定

Was this useful?

On this page

On this page