Skip to main content
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

1

Open agent settings

Navigate to the agent and open its settings or sharing panel.
2

Add users by email

Enter the email address of each user you want to share with.
3

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.
1

Open agent settings

Navigate to the agent’s sharing panel.
2

Add a group

Select the group you want to share with.
3

Assign a role

The role applies to all members of the group.
When users are added to or removed from the group, their agent access updates automatically.

​
Agent roles

The Owner role is automatically assigned to the user who created the agent. Ownership cannot be transferred through the sharing interface.

​
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).