Tools

Reaktionen

Der Agent fügt Emoji-Reaktionen mit der Aktion react des Tools message hinzu und entfernt sie. Das Verhalten variiert je nach Kanal.

Funktionsweise

json
{  "action": "react",  "messageId": "msg-123",  "emoji": "thumbsup"}
  • emoji ist beim Hinzufügen einer Reaktion erforderlich.
  • Setzen Sie emoji auf eine leere Zeichenfolge (""), um die Reaktion(en) des Bots auf Kanälen zu entfernen, die dies unterstützen.
  • Setzen Sie remove: true, um ein bestimmtes Emoji zu entfernen (erfordert einen nicht leeren Wert für emoji).
  • Auf Kanälen mit Statusreaktionen ermöglicht trackToolCalls: true bei einer Reaktion, dass die Laufzeit diese mit einer Reaktion versehene Nachricht für nachfolgende Reaktionen zum Werkzeugfortschritt während desselben Durchlaufs wiederverwendet.

Verhalten nach Kanal

Discord und Slack
  • Ein leerer Wert für emoji entfernt alle Reaktionen des Bots auf die Nachricht.
  • remove: true entfernt nur das angegebene Emoji.
Nextcloud Talk
  • Nur das Hinzufügen von Reaktionen: emoji ist erforderlich und darf nicht leer sein.
  • Das Entfernen von Reaktionen ist noch nicht mit einem Löschaufruf verbunden; remove: true wird stattdessen mit einem ausdrücklichen Fehler abgelehnt, anstatt ohne Rückmeldung wirkungslos zu bleiben.
  • Erfordert, dass der Talk-Bot mit der Funktion reaction registriert ist (siehe Dokumentation zum Nextcloud-Talk-Kanal).
Telegram
  • Ein leerer Wert für emoji entfernt die Reaktionen des Bots.
  • remove: true entfernt ebenfalls Reaktionen, erfordert für die Werkzeugvalidierung jedoch weiterhin einen nicht leeren Wert für emoji.
WhatsApp
  • Ein leerer Wert für emoji entfernt die Reaktion des Bots.
  • remove: true wird intern einem leeren Emoji zugeordnet (erfordert im Werkzeugaufruf weiterhin emoji).
  • WhatsApp verfügt pro Nachricht über einen Reaktionsplatz für den Bot; das Senden einer neuen Reaktion ersetzt die bisherige, statt mehrere Emojis zu stapeln.
Zalo Personal (zalouser)
  • Erfordert sowohl zum Hinzufügen als auch zum Entfernen einen nicht leeren Wert für emoji.
  • remove: true entfernt diese bestimmte Emoji-Reaktion.
Feishu/Lark
  • Verwendet dieselbe Aktion react wie andere Kanäle (Hinzufügen/Entfernen/Auflisten über Nachrichtenreaktions-IDs), kein separates Tool.
  • Das Hinzufügen erfordert einen nicht leeren Wert für emoji (wird einem Feishu-emoji_type zugeordnet, z. B. SMILE, THUMBSUP, HEART).
  • remove: true erfordert einen nicht leeren Wert für emoji und entfernt die eigene Reaktion des Bots, die diesem Emoji-Typ entspricht.
  • Ein leerer Wert für emoji mit clearAll: true entfernt alle Reaktionen des Bots auf die Nachricht.
Signal
  • Benachrichtigungen über eingehende Reaktionen werden durch channels.signal.reactionNotifications gesteuert: "off" deaktiviert sie, "own" (Standardwert) erzeugt Ereignisse, wenn Benutzer auf Bot-Nachrichten reagieren, "all" erzeugt Ereignisse für alle Reaktionen und "allowlist" erzeugt Ereignisse nur für Absender in channels.signal.reactionAllowlist.
iMessage
  • Ausgehende Reaktionen sind iMessage-Tapbacks (love, like, dislike, laugh, emphasize und question); emoji muss einem dieser Typen zugeordnet werden, um eine Reaktion hinzuzufügen.
  • remove: true ohne einen erkannten Tapback-Typ entfernt alle Tapback-Typen; mit einem erkannten Typ wird nur dieser entfernt.

Reaktionsstufe

Die kanalspezifische Einstellung reactionLevel begrenzt, wie häufig der Agent eigene Reaktionen sendet. Werte: off, ack, minimal oder extensive.

Verwandte Themen

  • Agent Send – das Tool message, das react enthält
  • Kanäle – kanalspezifische Konfiguration
Was this useful?
On this page

On this page