Tools

Reações

O agente adiciona e remove reações com emojis usando a ação react da ferramenta message. O comportamento varia conforme o canal.

Como funciona

json
{  "action": "react",  "messageId": "msg-123",  "emoji": "thumbsup"}
  • emoji é obrigatório ao adicionar uma reação.
  • Defina emoji como uma string vazia ("") para remover as reações do bot nos canais compatíveis.
  • Defina remove: true para remover um emoji específico (requer emoji não vazio).
  • Em canais com reações de status, definir trackToolCalls: true em uma reação permite que o ambiente de execução reutilize a mensagem que recebeu a reação para reações subsequentes de progresso das ferramentas durante o mesmo turno.

Comportamento por canal

Discord e Slack
  • Um emoji vazio remove todas as reações do bot na mensagem.
  • remove: true remove apenas o emoji especificado.
Nextcloud Talk
  • Somente adição de reações: emoji é obrigatório e não pode estar vazio.
  • A remoção de reações ainda não está conectada a uma chamada de exclusão; remove: true é rejeitado com um erro explícito, em vez de não produzir efeito silenciosamente.
  • Requer que o bot do Talk esteja registrado com o recurso reaction (consulte a documentação do canal Nextcloud Talk).
Telegram
  • Um emoji vazio remove as reações do bot.
  • remove: true também remove reações, mas ainda requer um emoji não vazio para a validação da ferramenta.
WhatsApp
  • Um emoji vazio remove a reação do bot.
  • remove: true é mapeado internamente para um emoji vazio (a chamada da ferramenta ainda requer emoji).
  • O WhatsApp tem um único espaço de reação do bot por mensagem; enviar uma nova reação substitui a anterior, em vez de acumular vários emojis.
Zalo Personal (zalouser)
  • Requer emoji não vazio tanto para adicionar quanto para remover.
  • remove: true remove essa reação de emoji específica.
Feishu/Lark
  • Usa a mesma ação react que os outros canais (adicionar, remover e listar por meio de IDs de reação da mensagem), não uma ferramenta separada.
  • A adição requer emoji não vazio (mapeado para um emoji_type do Feishu, por exemplo, SMILE, THUMBSUP, HEART).
  • remove: true requer emoji não vazio e remove a reação do próprio bot correspondente a esse tipo de emoji.
  • Um emoji vazio com clearAll: true remove todas as reações do bot na mensagem.
Signal
  • As notificações de reações recebidas são controladas por channels.signal.reactionNotifications: "off" as desativa, "own" (padrão) emite eventos quando usuários reagem às mensagens do bot, "all" emite eventos para todas as reações e "allowlist" emite eventos apenas para remetentes em channels.signal.reactionAllowlist.
iMessage
  • As reações enviadas são tapbacks do iMessage (love, like, dislike, laugh, emphasize e question); emoji deve corresponder a um desses tipos para adicionar uma reação.
  • remove: true sem um tipo de tapback reconhecido remove todos os tipos de tapback; com um tipo reconhecido, remove apenas esse tipo.

Nível de reação

A configuração reactionLevel de cada canal limita a frequência com que o agente envia suas próprias reações. Valores: off, ack, minimal ou extensive.

Relacionado

Was this useful?
On this page

On this page