Tools

リアクション

エージェントは、react アクションを指定した message ツールを使用して、メッセージに絵文字リアクションを追加および削除できます。リアクションの動作は、チャンネルとトランスポートによって異なります。

仕組み

{
  "action": "react",
  "messageId": "msg-123",
  "emoji": "thumbsup"
}
  • リアクションを追加するときは emoji が必須です。
  • ボットのリアクションを削除するには、emoji を空文字列("")に設定します。
  • 特定の絵文字を削除するには、remove: true を設定します(空でない emoji が必要です)。
  • ステータスリアクションをサポートするチャンネルでは、リアクションで trackToolCalls: true を指定すると、ランタイムは同じターン中の後続ツール 進捗リアクションに、そのリアクションされたメッセージを使用できます。

チャンネルの動作

Discord と Slack
  • 空の emoji は、メッセージ上のボットのすべてのリアクションを削除します。
  • remove: true は、指定した絵文字だけを削除します。
Google Chat
  • 空の emoji は、メッセージ上のアプリのリアクションを削除します。
  • remove: true は、指定した絵文字だけを削除します。
Telegram
  • 空の emoji は、ボットのリアクションを削除します。
  • remove: true もリアクションを削除しますが、ツール検証のために空でない emoji が必要です。
WhatsApp
  • 空の emoji は、ボットのリアクションを削除します。
  • remove: true は内部的に空の絵文字にマップされます(ツール呼び出しでは引き続き emoji が必要です)。
Zalo Personal(zalouser)
  • 空でない emoji が必要です。
  • remove: true は、その特定の絵文字リアクションを削除します。
Feishu/Lark
  • addremovelist アクションを指定して feishu_reaction ツールを使用します。
  • 追加/削除には emoji_type が必要です。削除には reaction_id も必要です。
Signal
  • 受信リアクション通知は channels.signal.reactionNotifications で制御されます。"off" は無効化し、"own"(デフォルト)はユーザーがボットのメッセージにリアクションしたときにイベントを発行し、"all" はすべてのリアクションについてイベントを発行します。

リアクションレベル

チャンネルごとの reactionLevel 設定は、エージェントがどの程度広くリアクションを使用するかを制御します。値は通常 offackminimal、または extensive です。

個別のチャンネルで reactionLevel を設定し、各プラットフォームでエージェントがメッセージにどの程度積極的にリアクションするかを調整します。

関連