About Groups
Groups allow MSP Admins to share Workshop items (currently agents) with specific subsets of users within a tenant, rather than sharing with an entire organization. This gives you granular control over who can access specific content.
This article covers:
What Groups are and how they work
Creating and managing groups for your tenants
Publishing agents to specific groups
What the end-user experience looks like
Current limitations and future functionality
Important: MSP-Only Feature
This feature is currently available only to MSP partners who log in through admin.hatz.ai.
If you are not an MSP Admin, you will not see this functionality in your dashboard at this time. This feature will be expanded in future updates.
Understanding Publishing Options
Before Groups were introduced, you had four publishing options for Workshop items like apps, workflows, and agents:
Publishing Option | Who Can See It |
Private | Only yourself |
Tenant | Everyone at a specific client company (e.g., Company A) |
Community | All Hatz users via the Workshop Discover Community page |
The Problem: There was no way to publish to a specific subset of users within a tenant.
For example, if you managed Company A and wanted to share HR-specific agents with only the three people in their HR department, you couldn't prevent the rest of Company A from seeing those items.
The Solution: Groups fill this gap by allowing you to create subsets of users within a tenant and publish content exclusively to those groups.
How Groups Solve Granular Sharing
With Groups, you can:
Create logical subsets of users within a tenant (e.g., "HR Team," "Sales Team," "Finance Department")
Publish Workshop items to specific groups instead of entire organizations
Control visibility so only group members see those items
Manage multiple groups across different tenants
Example Use Case:
Company A has 25 employees. Three of them work in HR and need access to HR-specific agents that process sensitive employee data. With Groups, you can:
Create a group called "Company A - HR Team"
Add only those three HR employees to the group
Publish HR agents to that group
The other 22 employees at Company A won't see those agents
How to Create a Group
From the Admin Dashboard:
Navigate to admin.hatz.ai and log in
Select the tenant where you want to create a group
Go to the Groups tab (or section)
Click Create Group
Name your group using a descriptive format
Example: "Company A - HR Team" or "ACME Corp - Sales Department"
Select members to add to the group
Choose from the users in that specific tenant
You can add or remove members at any time
Click Create Group
Your group is now created and visible in the Groups list for that tenant.
Adding Items to Groups
Once a group is created, you can add Workshop items that are already published to the tenant.
To add existing items to a group:
Open the group you created
Click Add Items (or similar option)
Select Workshop items that are already published to that tenant
Note: Currently, only agents can be added to groups
Apps and workflows will be supported in future updates
Click Save
The selected items are now visible only to members of that group.
Publishing to Groups
When creating or editing a Workshop item (like an agent), you can publish directly to a group.
To publish an agent to a group:
Create or edit your agent in the Workshop
When ready to publish, click Share or Publish
Under publishing options, select Tenant and Group
Choose the specific tenant
Select the group you want to share with (e.g., "Company A - HR Team")
Click Publish
The agent is now accessible only to users in that specific group—not to the entire tenant.
What Users See
From the end-user perspective:
When a user is added to a group, they will see group content in the Workshop.
Navigate to the Workshop
Click Shared Items
The first section displays Your Groups
Click on a group name to see items shared with that group
Users can access multiple groups if they are members of more than one.
Example:
If you created a "Group for Mark" and shared two agents with that group, when Mark opens the Workshop and clicks on Shared Items, he'll see:
Your Groups
Group for Mark
Agent 1
Agent 2
Current Limitations
As of now:
Groups are only available for MSP Admins via admin.hatz.ai
Only agents can be published to groups
Apps and workflows will be supported in future updates
This feature is in its initial rollout phase
Coming Soon:
Expanded functionality for groups
Support for apps and workflows
Additional management features
Check back for updates or watch for announcements about new group capabilities!
