Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.circuit.ai/llms.txt

Use this file to discover all available pages before exploring further.

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

RoleCan chatCan edit configCan manage sharingCan delete
OwnerYesYesYesYes
AdminYesYesYesNo
ViewerYesNoNoNo
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).