Coding

Agent群组工具免费版

极简多Agent群组协作，像微信群一样拉群、@提及、广播与成员管理。Use when 需要项目管理、任务规划、进度跟踪、团队协作时使用。不适用于实际人员绩效评估。适用于独立开发者、企业团队和自动化工作流场景。支持中文交互，无需复杂配置即开即用。输出结果可直接使用，减少二次加工成本。提供结构化输出和错误处理机制。

What it does

The skill document

Agent群组工具（免费版）

概述

多Agent系统的一个常见痛点：Agent之间协作需要复杂的消息总线配置。RabbitMQ/Kafka等消息中间件功能强大，但配置复杂；共享文件系统轮询效率低；点对点HTTP调用扩展性差。开发者常常在"协作通信"上耗费比业务逻辑更多的时间. Agent群组工具用最简单的方式解决这个问题：像微信群一样拉个群。一行指令建群、一行指令拉Agent进群、一行指令发消息——任何会用即时通讯软件的人都能在10秒内上手. 本免费版支持单实例下的群组管理，足以覆盖小型多Agent团队的协作需求。如需跨实例群组联邦、企业级权限、群组机器人等高级能力，可升级至专业版.

核心能力

能力1：极简群组管理四件套

四条指令覆盖群组管理全部操作：

指令	用途	示例
`建群`	创建新群组	`group-agent create --name "Q3项目组"`
`拉XXX进群`	邀请Agent加入	`group-agent invite --group proj-q3 --agent researcher`
`群列表`	查看群成员	`group-agent list --group proj-q3`
`退群`	退出或解散	`group-agent leave --group proj-q3`

处理: 解析能力1：极简群组管理四件套的输入参数,完成核心逻辑,返回结构化响应. 输出: 返回能力1：极简群组管理四件套的响应数据,包含状态码、结果和日志.

能力2：@提及定向通信

群内消息可定向@特定Agent，被@的Agent会收到高优先级通知：

输入格式

参数名	类型	必填	说明
input	string	是	Agent群组工具免费版处理的输入数据或指令
options	object	否	附加配置选项,如模式选择、格式偏好等
callback_url	string	否	异步处理完成后的回调通知URL

# @特定Agent
group-agent send --group proj-q3 --message "@researcher 请查最新论文"
# ...
# @多个Agent
group-agent send --group proj-q3 --message "@researcher @writer 协作完成报告"
# ...
# @全体成员
group-agent send --group proj-q3 --message "@all 周会10分钟后开始"

处理: 解析能力2：@提及定向通信的输入参数,完成核心逻辑,返回结构化响应. 输出: 返回能力2：@提及定向通信的响应数据,包含状态码、结果和日志.

执行此能力时使用input_params参数,支持创建/查询/导出操作

能力3：群公告与广播

群公告是群组的"置顶消息"，新成员加入时自动推送：

# 设置群公告
group-agent announce --group proj-q3 \
  --content "本群组目标：Q3数据分析报告，截止日期2026-09-30"
# ...
# 新Agent加入时自动收到公告
group-agent invite --group proj-q3 --agent new_agent
# new_agent 自动收到公告推送

处理: 解析能力3：群公告与广播的输入参数,完成核心逻辑,返回结构化响应. 输出: 返回能力3：群公告与广播的响应数据,包含状态码、结果和日志.

执行此能力时使用input_params参数,支持创建/查询/导出操作

能力4：消息归档查询

群组消息按时间归档，支持按关键词、时间范围、发送者查询：

# 查询关键词
group-agent search --group proj-q3 --keyword "论文"
# ...
# 查询时间范围
group-agent search --group proj-q3 \
  --from "2026-07-01" --to "2026-07-18"
# ...
# 查询特定Agent发送的消息
group-agent search --group proj-q3 --sender researcher

处理: 解析能力4：消息归档查询的输入参数,完成核心逻辑,返回结构化响应. 输出: 返回能力4：消息归档查询的响应数据,包含状态码、结果和日志.

执行此能力时使用input_params参数,支持创建/查询/导出操作

能力5：群组主题频道

单个群组内可创建多个主题频道，避免消息混杂：

群组: proj-q3
├── #日常沟通
├── #论文讨论
├── #写作协作
└── #问题排查

Agent可订阅感兴趣频道，减少无关消息干扰.

处理: 解析能力5：群组主题频道的输入参数,完成核心逻辑,返回结构化响应. 输出: 返回能力5：群组主题频道的响应数据,包含状态码、结果和日志. 能力覆盖范围：本skill的核心能力覆盖以下场景关键词：极简多、群组协作、像微信群一样拉群、广播与成员管理、群组工具是一套面、协作的轻量级群组、通信方案、借鉴即时通讯软件、的成熟交互模式、让多个、能像同事群一样协、无需学习复杂的消、息总线或事件驱动、核心能力、一行指令创建群组、查看成员、退出解散、特定成员定向通信、群公告广播、群组数据轻量化、内存优先、按需持久化等。这些关键词对应description中声明的使用场景,均已在上述能力点中提供对应的操作支持.

执行此能力时使用input_params参数,支持创建/查询/导出操作

使用场景

场景1：多Agent项目协作

研究项目需要3个Agent协作：

researcher Agent负责资料检索
analyst Agent负责数据分析
writer Agent负责报告撰写

建群后：

researcher 在群内@analyst 提交中间结果
analyst 完成分析后@writer 通知可以开始写作
writer 完成章节后@researcher 请求补充材料

场景2：临时任务小组

某次临时任务需要4个Agent配合：

临时建群"task-20260718"
拉相关Agent进群
任务完成后解散
群组数据归档保留30天

场景3：跨职能Agent协同

企业内部不同职能Agent协作：

hr-agent 通知 it-agent 处理新员工入职
it-agent 完成后 @hr-agent 反馈
全程在一个固定群组 "onboarding-flow" 内完成

场景4：并行任务分发汇总

主Agent分发并行子任务：

在"parallel-task"群内@多个worker Agent
各worker完成后@主Agent汇报
主Agent汇总结果

场景5：Agent团队日常沟通

长期运行的Agent团队日常状态同步：

群公告固定为团队目标
各Agent每天在群里发状态更新
群消息归档供周报生成

不适用场景

以下场景Agent群组工具免费版不适合处理：

实际人员绩效评估
财务预算审批
合同法务审核

触发条件

需要项目管理、任务规划、进度跟踪、团队协作时使用。不适用于非本工具能力范围的需求.

快速开始

阅读## 核心能力章节了解skill功能
按## 依赖说明配置环境
执行所需能力对应的命令
参考## 错误处理章节处理异常
查看## FAQ解答常见疑问

60秒上手

# 1. 初始化工具
group-agent init --storage sqlite
# ...
# 2. 创建第一个群组
group-agent create --name "我的第一个Agent群组" --id proj-demo
# ...
# 3. 邀请Agent加入
group-agent invite --group proj-demo --agent researcher
group-agent invite --group proj-demo --agent writer
# ...
# 4. 设置群公告
group-agent announce --group proj-demo \
  --content "本群用于演示多Agent协作"
# ...
# 5. 发送第一条消息
group-agent send --group proj-demo \
  --sender researcher \
  --message "@writer 你好，准备好了吗？"
# ...
# 6. 查看群成员
group-agent list --group proj-demo

最小可用配置

# config.yaml
storage:
  backend: sqlite
  path: ./data/groups.db
# ...
defaults:
  message_retention_days: 30
  max_members_per_group: 20
  enable_channels: true
# ...
logging:
  level: info
  path: ./logs/group-agent.log

响应解析: 完成完成后,查看输出响应确认任务状态。成功时输出包含解析摘要和响应数据;失败时根据错误信息排查问题,查阅错误解析章节获取恢复步骤.

示例

示例1：研究项目群组配置

group:
  id: research-2026-q3
  name: "2026 Q3 研究项目"
  description: "多Agent协作完成研究报告"
# ...
  members:
    - agent: researcher
      role: leader
      capabilities: [search, summarize]
    - agent: analyst
      role: member
      capabilities: [data-analysis]
    - agent: writer
      role: member
      capabilities: [writing]
# ...
  channels:
    - name: daily
      description: "日常沟通"
    - name: papers
      description: "论文讨论"
    - name: writing
      description: "写作协作"
# ...
  announcement: |
    群组目标：完成2026 Q3行业研究报告
    截止日期：2026-09-30
    协作规范：每日17:00发送当日进展
# ...
  message_retention: 90d

示例2：Agent代码集成

from group_agent import GroupClient
# ...
client = GroupClient(storage='sqlite', db_path='./data/groups.db')
# ...
# 创建群组
group = client.create_group(
    name='临时任务组',
    members=['agent_a', 'agent_b', 'agent_c']
)
# ...
# 发送@消息
client.send_message(
    group_id=group.id,
    sender='agent_a',
    message='@agent_b 请处理数据清洗',
    mentions=['agent_b']
)
# ...
# 监听群消息
def on_message(msg):
    if msg.mentions_self('agent_b'):
        # 处理@自己的消息
        process_mention(msg)
# ...
client.subscribe(group_id=group.id, agent='agent_b', callback=on_message)

最佳实践

实践1：群组命名规范化

采用清晰的命名规范便于管理：

项目群：proj-<项目代号>
任务群：task-<日期>-<序号>
长期群：team-<职能>
临时群：tmp-<用途>

实践2：群组数量控制

不要为每个小任务都建群。建议：

长期协作 → 1个固定群组
项目周期 → 1个项目群
临时任务 → 复用现有群或建立tmp群，完成后立即解散

实践3：善用频道分流

群内消息超过100条/天时，建议启用频道：

按主题拆分（讨论/通知/问题）
按职能拆分（开发/测试/运维）
Agent订阅感兴趣的频道

实践4：定期归档清理

临时群组任务完成后立即解散
长期群组每月归档一次历史消息
超过保留期的群组自动清理

实践5：消息结构化

群内消息建议使用结构化格式：

{"type":"status","from":"researcher","progress":0.6,"eta":"2h"}

便于接收方Agent解析处理.

常见问题

Q1：免费版支持多少个群组？

A：本免费版单实例支持最多20个群组，每群组最多20个成员.

Q2：消息能保留多久？

A：默认30天，可在配置中调整 message_retention_days.

Q3：群组数据存储在哪里？

A：免费版默认SQLite本地存储，路径 ./data/groups.db.

Q4：能否跨实例通信？

A：免费版仅支持单实例内群组。跨实例需要专业版.

Q5：如何处理离线Agent的消息？

A：Agent离线期间的消息会缓存，重新上线后推送。缓存时长默认7天.

错误处理

错误场景(现象)	可能原因	排查步骤	处理方式
Agent加入失败	Agent未注册	先注册Agent身份	对照依赖说明章节逐项验证配置项,确认环境变量已正确设置后执行ping命令测试网络连通性,检查防火墙和代理设置连接后重新执行命令
消息发送失败	群组不存在	检查 `--group` 参数	对照依赖说明章节逐项验证配置项,确认环境变量已正确设置后执行ping命令测试网络连通性,检查防火墙和代理设置连接后重新执行命令
@提及未送达	Agent未订阅	检查Agent是否在线监听	对照依赖说明章节逐项验证配置项,确认环境变量已正确设置后执行ping命令测试网络连通性,检查防火墙和代理设置连接后重新执行命令
群组创建失败	群组ID重复	更换群组ID	对照依赖说明章节逐项验证配置项,确认环境变量已正确设置后执行ping命令测试网络连通性,检查防火墙和代理设置连接后重新执行命令
历史消息查询慢	数据量大	添加索引或归档旧消息	对照依赖说明章节逐项验证配置项,确认环境变量已正确设置后执行ping命令测试网络连通性,检查防火墙和代理设置连接后重新执行命令
数据库锁死	并发写入冲突	重启服务	对照依赖说明章节逐项验证配置项,确认环境变量已正确设置后执行ping命令测试网络连通性,检查防火墙和代理设置连接后重新执行命令

依赖说明

运行环境

Agent平台：支持SKILL.md的任意AI Agent（Claude Code / Cursor / Codex / Gemini CLI等）
操作系统：Windows / macOS / Linux
Python：3.10+（运行服务端）
Node.js：18+（可选，用于Web UI）

依赖详情

依赖项	类型	是否必需	获取方式	版本要求
Python	运行时	必需	官方下载	3.10+
SQLite	数据库	必需	Python内置	3.x
PyYAML	配置解析	必需	pip install	6.0+
LLM API	API	必需	由Agent平台内置LLM提供	不限

API Key 配置

本工具基于本地服务，基础LLM由Agent平台提供
若需将群组数据同步至外部系统，需在该系统侧配置对应的API Key
禁止：在脚本中硬编码API Key

可用性分类

分类：MD+EXEC（Markdown指令 + 命令行工具）
说明：核心操作通过CLI完成，可选Web UI便于人类查看

已知限制

本免费体验版限制以下高级功能：

❌ 跨实例群组联邦（多实例之间群组互通）
❌ 企业级权限管理（管理员/编辑/只读角色）
❌ 群组机器人（自动化响应@消息）
❌ 消息端到端加密
❌ Webhook外发集成（消息同步至企业IM）
❌ 群组数据分析与可视化看板
❌ 高可用部署与跨节点同步

解锁全部功能请使用专业版：group-agent-tool-pro

输出格式

{
  "success": true,
  "data": {
    "result": "Agent群组工具免费版处理结果",
    "execution_time": "0.5s",
    "metadata": {
      "version": "1.0",
      "processor": "group agent"
    }
  },
  "execution_log": ["解析输入参数", "执行核心处理", "格式化输出结果"],
  "error": null
}