跳到主要内容

解决方案指南 · 渠道协作

渠道桥接实践:把 Hajimi 接入团队群聊

让团队成员在熟悉的聊天工具里调用 Agent,同时保留审批、安全和上下文隔离能力。

步骤 1

先定义渠道边界与职责

先选 1-2 个核心群聊试点,明确谁可以触发、谁负责审核结果,避免全员开放导致噪音激增。

步骤 2

用配置示例初始化

先通过 print-template 生成 channels.toml,再按渠道填 bot token、频道范围和轮询参数,降低手写配置错误。

步骤 3

开启受控触发机制

飞书可启用 require_command_prefix 与 require_bot_mention;Slack/Discord 只配置受控 channel_ids,避免误触发。

步骤 4

为每个渠道建立值班 Runbook

记录常见故障处理步骤:token 失效、频道权限变化、消息格式异常,确保非开发同学也能快速恢复服务。

步骤 5

定期复盘消息质量

每周抽样查看 AI 回复和工具调用情况,清理低价值触发词并补充高价值规则,提升渠道协作效率。

启动命令参考

hajimi channel --print-template > ~/.hajimi/channels.toml
hajimi channel --once
hajimi channel
  • 先用 --once 验证配置,再长期运行服务,避免无效轮询。
  • 每个渠道保留单独告警入口,便于快速定位故障来源。
  • 高风险操作只允许在专用“审批频道”触发。