feat(captain/hermes): auto-react deterministico antes do LLM

Pattern matching no Captain dispara reaction <1s sem esperar Codex
processar. Resposta de texto continua vindo do Hermes normalmente —
auto-react eh COMPLEMENTAR.

Padroes detectados (no incoming message):
- "obrigado/valeu/vlw/thanks" -> 🙏
- "ok/fechado/perfeito/blz/combinado" -> 👍
- attachment image (msg sem texto) -> 😍
- attachment audio (msg curta) -> 🙏

Conservative: só dispara em casos CLAROS. Em duvida, deixa pro LLM
decidir via react_to_message tool.

Plugado em Captain::Hermes::OutgoingJob#perform — chamado antes do
dispatch pro Hermes. Falha silenciosa (rescue) — nao bloqueia fluxo.

SOUL.md atualizado: regra de frequencia (~30% das msgs) + nota sobre
auto-react pra LLM nao duplicar reacao em casos cobertos.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
This commit is contained in:
Rodribm10 2026-05-01 21:59:28 -03:00
parent c7300dfbcf
commit bfa06597f2
2 changed files with 101 additions and 0 deletions

View File

@ -27,6 +27,10 @@ class Captain::Hermes::OutgoingJob < ApplicationJob
return
end
# Auto-react ANTES do dispatch — gesto chega <1s sem esperar Codex.
# Não bloqueia fluxo: se falhar, dispatch normal continua.
Captain::Hermes::AutoReactService.maybe_react!(message)
Captain::Hermes::Client.new(conversation.inbox).dispatch(message: message, conversation: conversation)
end
end

View File

@ -0,0 +1,97 @@
# Auto-react determinístico — dispara reaction antes do LLM processar.
#
# Por que existe: quando cliente manda "obrigado", "ok", foto, etc, ele
# espera o feedback IMEDIATO (gesto). Esperar 10-30s do LLM gerar
# resposta + decidir chamar tool é UX ruim. Captain detecta padrões
# comuns e reage <1s, em paralelo ao processamento normal.
#
# A resposta de texto continua vindo do Hermes normalmente — auto-react
# é COMPLEMENTAR, não substitui.
#
# Padrões:
# - Agradecimento curto → 🙏
# - Confirmação ("ok", "fechado", "perfeito", "blz") → 👍
# - Imagem (sem texto explicativo) → 😍
# - Áudio sem ser "diferente" (não é dúvida complexa) → 🙏
#
# Conservative: só dispara em casos CLAROS. Em dúvida, deixa pro LLM
# decidir via react_to_message tool.
class Captain::Hermes::AutoReactService
THANKS_REGEX = /\A(obrigad[oa]|valeu|vlw|thanks|brigad[oa]|grat[oa])[\s.!,]*\z/i
CONFIRMATION_REGEX = /\A(ok|okay|fechado|perfeit[oa]|blz|beleza|combinado|certo|ótim[oa]|legal|pode\s*ser|isso\s*mesmo)[\s.!,]*\z/i
def self.maybe_react!(message)
new(message).maybe_react!
end
def initialize(message)
@message = message
@conversation = message.conversation
end
def maybe_react!
return unless eligible?
emoji = decide_emoji
return if emoji.blank?
create_reaction!(emoji)
Rails.logger.info("[Captain::Hermes::AutoReact] msg ##{@message.id} reagiu com #{emoji}")
rescue StandardError => e
Rails.logger.warn("[Captain::Hermes::AutoReact] failed for msg ##{@message&.id}: #{e.class} - #{e.message}")
end
private
def eligible?
return false if @message.blank? || @conversation.blank?
return false unless @message.message_type == 'incoming'
return false if @message.source_id.blank?
true
end
def decide_emoji
text = @message.content.to_s.strip
return image_emoji if image_attachment?
return audio_emoji if audio_attachment? && text.length < 10
return '🙏' if THANKS_REGEX.match?(text)
return '👍' if CONFIRMATION_REGEX.match?(text)
nil
end
def image_attachment?
@message.attachments.exists?(file_type: :image)
end
def audio_attachment?
@message.attachments.exists?(file_type: :audio)
end
def image_emoji
'😍'
end
def audio_emoji
'🙏'
end
def create_reaction!(emoji)
assistant = @conversation.inbox.captain_assistant
@conversation.messages.create!(
message_type: :outgoing,
account_id: @conversation.account_id,
inbox_id: @conversation.inbox_id,
sender: assistant,
content: emoji,
content_attributes: {
is_reaction: true,
in_reply_to_external_id: @message.source_id,
in_reply_to: @message.id,
external_source: 'hermes_auto_react'
}
)
end
end