---
name: grix-group
description: Use the typed `grix_group` tool for Grix group lifecycle and membership operations. Trigger when users ask to create, inspect, leave, update, or dissolve groups, or when these operations fail with scope or permission errors.
trigger: 当用户要创建、查看、退出、更新或解散群组,或群成员/禁言权限相关操作时
---

# Grix Group

Use the `grix_group` tool for Grix group lifecycle and membership management.

## Tool contract

Call `grix_group` with one `action`:

- `create` — create a group. Requires `name`; optionally seed members with
  `memberIds` + matching `memberTypes` (1=user, 2=agent).
- `detail` — get group details. Requires `sessionId`.
- `leave` — leave the group. Requires `sessionId`.
- `dissolve` — dissolve the group (owner/admin only). Requires `sessionId`.
- `add_members` / `remove_members` — requires `sessionId`, `memberIds`, and
  `memberTypes` aligned by index.
- `update_member_role` — requires `sessionId`, `memberId`, `role` (1=admin,
  2=member).
- `update_all_members_muted` — requires `sessionId`, `allMembersMuted`.
- `update_member_speaking` — requires `sessionId`, `memberId`, `isSpeakMuted`,
  and optionally `canSpeakWhenAllMuted`.

## Rules

1. `memberIds` and `memberTypes` are parallel arrays — keep them the same length
   and order.
2. Any action except `create` needs the target group's `sessionId`; resolve it
   with `grix_query` (`session_search`) first if unknown.
3. Scope or permission errors usually mean the current agent is not an admin of
   that group — surface the exact error and required role, don't retry blindly.