After creating and configuring an agent, you need to share it with the people who will use it. Circuit provides role-based sharing at both the user and group level.
Sharing with users
Open agent settings
Navigate to the agent and open its settings or sharing panel.
Add users by email
Enter the email address of each user you want to share with.
Assign a role
Choose the appropriate role for each user:
- Viewer: can chat with the agent but cannot change its configuration
- Admin: can chat with the agent and modify its configuration
Sharing with groups
For team-level access, share agents with groups instead of individual users. This is the recommended approach for most teams.
Open agent settings
Navigate to the agent’s sharing panel.
Add a group
Select the group you want to share with.
Assign a role
The role applies to all members of the group.
Agent roles
| Role | Can chat | Can edit config | Can manage sharing | Can delete |
|---|
| Owner | Yes | Yes | Yes | Yes |
| Admin | Yes | Yes | Yes | No |
| Viewer | Yes | No | No | No |
Invitations
When you share an agent with a user who is not yet in your workspace, Circuit sends them an invitation. The user can join the workspace and immediately access the agent.
Revoking access
To remove someone’s access to an agent:
- Remove them from the agent’s sharing list (for direct assignments)
- Remove them from the group that has agent access (for group-based assignments)
Access changes take effect immediately. The user will no longer see the agent in their list.
Use groups for day-to-day access management and individual sharing only for special cases (e.g., a contractor who needs temporary access to one agent).
