Tools
リアクション
エージェントは、message ツールと react アクションを使って、メッセージに絵文字リアクションを追加および削除できます。リアクションの動作はチャンネルとトランスポートによって異なります。
仕組み
{ "action": "react", "messageId": "msg-123", "emoji": "thumbsup"}- リアクションを追加する場合、
emojiは必須です。 - ボットのリアクションを削除するには、
emojiを空文字列（""）に設定します。 - 特定の絵文字を削除するには、
remove: trueを設定します（空でないemojiが必要です）。 - ステータスリアクションをサポートするチャンネルでは、リアクションの
trackToolCalls: trueにより、ランタイムは同じターン中の後続ツール進行状況リアクションに、そのリアクション済みメッセージを使用できます。
チャンネルの動作
Discord and Slack
- 空の
emojiは、メッセージ上のボットのリアクションをすべて削除します。 remove: trueは、指定された絵文字だけを削除します。
Google Chat
- 空の
emojiは、メッセージ上のアプリのリアクションを削除します。 remove: trueは、指定された絵文字だけを削除します。
Nextcloud Talk
- リアクションの追加のみ:
emojiは必須で、空でない必要があります。 - リアクション削除はまだサポートされていません。
remove: true（または空のemoji）を指定した呼び出しは、何もせずに成功扱いにするのではなく、明確なエラーで拒否されます。 - Talk ボットが
reaction機能付きで登録されている必要があります（Nextcloud Talk チャンネルドキュメントを参照）。
Telegram
- 空の
emojiは、ボットのリアクションを削除します。 remove: trueもリアクションを削除しますが、ツール検証のために空でないemojiが引き続き必要です。
- 空の
emojiは、ボットのリアクションを削除します。 remove: trueは内部的に空の絵文字へマッピングされます（ツール呼び出しでは引き続きemojiが必要です）。- WhatsApp にはメッセージごとにボットリアクション枠が1つあります。ステータスリアクション更新は、複数の絵文字を積み重ねるのではなく、その枠を置き換えます。
Zalo Personal (zalouser)
- 空でない
emojiが必要です。 remove: trueは、その特定の絵文字リアクションを削除します。
Feishu/Lark
add、remove、listアクションを指定してfeishu_reactionツールを使用します。- 追加/削除には
emoji_typeが必要です。削除にはreaction_idも必要です。
Signal
- 受信リアクション通知は
channels.signal.reactionNotificationsで制御されます:"off"は通知を無効化し、"own"（デフォルト）はユーザーがボットメッセージにリアクションしたときにイベントを発行し、"all"はすべてのリアクションについてイベントを発行します。
iMessage
- 送信リアクションは iMessage のタップバック（
love、like、dislike、laugh、emphasize、question）です。 - 受信タップバック通知は
channels.imessage.reactionNotificationsで制御されます:"off"は通知を無効化し、"own"（デフォルト）はユーザーがボット作成メッセージにリアクションしたときにイベントを発行し、"all"は承認済み送信者からのすべてのタップバックについてイベントを発行します。
リアクションレベル
チャンネルごとの reactionLevel 設定は、エージェントがどの程度広くリアクションを使うかを制御します。値は通常、off、ack、minimal、または extensive です。
- Telegram reactionLevel —
channels.telegram.reactionLevel - WhatsApp reactionLevel —
channels.whatsapp.reactionLevel
個別のチャンネルで reactionLevel を設定し、各プラットフォームでエージェントがメッセージにどの程度積極的にリアクションするかを調整します。
関連
Was this useful?
