Tools

Reaktionen

Der Agent kann Emoji-Reaktionen auf Nachrichten mit dem message-Tool und der Aktion react hinzufügen und entfernen. Das Reaktionsverhalten variiert je nach Kanal und Transport.

Funktionsweise

json
{  "action": "react",  "messageId": "msg-123",  "emoji": "thumbsup"}
  • emoji ist erforderlich, wenn eine Reaktion hinzugefügt wird.
  • Setzen Sie emoji auf eine leere Zeichenkette (""), um die Reaktion(en) des Bots zu entfernen.
  • Setzen Sie remove: true, um ein bestimmtes Emoji zu entfernen (erfordert ein nicht leeres emoji).
  • Auf Kanälen, die Statusreaktionen unterstützen, erlaubt trackToolCalls: true bei einer Reaktion der Runtime, diese reagierte Nachricht für nachfolgende Fortschrittsreaktionen von Tools während desselben Durchlaufs zu verwenden.

Kanalverhalten

Discord und Slack
  • Ein leeres emoji entfernt alle Reaktionen des Bots auf der Nachricht.
  • remove: true entfernt nur das angegebene Emoji.
Google Chat
  • Ein leeres emoji entfernt die Reaktionen der App auf der 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 wird noch nicht unterstützt; Aufrufe mit remove: true (oder leerem emoji) werden mit einem klaren Fehler abgelehnt, statt stillschweigend ohne Wirkung zu bleiben.
  • Erfordert, dass der Talk-Bot mit der Funktion reaction registriert ist (siehe Nextcloud Talk-Kanaldokumentation).
Telegram
  • Ein leeres emoji entfernt die Reaktionen des Bots.
  • remove: true entfernt ebenfalls Reaktionen, erfordert für die Tool-Validierung aber weiterhin ein nicht leeres emoji.
WhatsApp
  • Ein leeres emoji entfernt die Bot-Reaktion.
  • remove: true wird intern auf ein leeres Emoji abgebildet (erfordert weiterhin emoji im Tool-Aufruf).
  • WhatsApp hat pro Nachricht einen Reaktionsplatz für den Bot; Statusreaktionsaktualisierungen ersetzen diesen Platz, statt mehrere Emojis zu stapeln.
Zalo Personal (zalouser)
  • Erfordert ein nicht leeres emoji.
  • remove: true entfernt diese bestimmte Emoji-Reaktion.
Feishu/Lark
  • Verwenden Sie das Tool feishu_reaction mit den Aktionen add, remove und list.
  • Hinzufügen/Entfernen erfordert emoji_type; Entfernen erfordert zusätzlich reaction_id.
Signal
  • Eingehende Reaktionsbenachrichtigungen werden über channels.signal.reactionNotifications gesteuert: "off" deaktiviert sie, "own" (Standard) gibt Ereignisse aus, wenn Benutzer auf Bot-Nachrichten reagieren, und "all" gibt Ereignisse für alle Reaktionen aus.
iMessage
  • Ausgehende Reaktionen sind iMessage-Tapbacks (love, like, dislike, laugh, emphasize und question).
  • Eingehende Tapback-Benachrichtigungen werden über channels.imessage.reactionNotifications gesteuert: "off" deaktiviert sie, "own" (Standard) gibt Ereignisse aus, wenn Benutzer auf vom Bot verfasste Nachrichten reagieren, und "all" gibt Ereignisse für alle Tapbacks von autorisierten Absendern aus.

Reaktionsstufe

Die kanalspezifische reactionLevel-Konfiguration steuert, wie umfassend der Agent Reaktionen verwendet. Werte sind typischerweise off, ack, minimal oder extensive.

Legen Sie reactionLevel für einzelne Kanäle fest, um abzustimmen, wie aktiv der Agent auf jeder Plattform auf Nachrichten reagiert.

Verwandte Themen

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

On this page