Team Members and Contributors

Open in CMS

Your agent's team has two layers: members, the colleagues who are allowed to use the agent, and contributors, the Builders who are allowed to configure it. In this tutorial you add members, give them permission codes, and check who can work on the agent. The example uses Atlas, Kirana Group's operations assistant, in the organization Kirana Group, whose owner is Rina Wijaya, Kirana's operations lead.


Before you start

  • The people you want to add are already users of your organization. If not, invite them first: see Users & Invitations. A user does not need any organization role to become an agent member.
  • If some knowledge should only be visible to certain members, create the permission codes first in Knowledge Permissions.
  • You understand the organization roles (Owner, Admin, Builder, Billing). See Roles & Permissions.

Members and contributors at a glance

MembersContributors
What they getAccess to use this agent, plus optional permission codesAccess to configure this agent in the CMS
Who can be oneAny user of the organization, including users with no roleOrganization users with the Builder role
Who adds themThe agent's owner, from Users β†’ MembersAn organization Owner or Admin, from Organization β†’ Agents β†’ Manage β†’ Contributor
When it matters mostWhen the agent is Private (only members can chat) or has restricted knowledgeWhenever more than one person builds the agent

Organization Owners and Admins can manage every agent in the organization automatically. They never need to be added as contributors.


Part 1: Add members

Step 1: Open the Members page

Open Users β†’ Members in the left sidebar. The Agent Members page lists the current members with their User Name, Email and Permissions.

Agent Members page with the Search Members and Add Member buttons and an empty table with the columns User Name, Email and Permissions, showing No records to display

A new agent has no members yet, so the table shows No records to display.

Note: The Members menu is only shown to people with Owner access to the agent.

To find someone in a long list, click Search Members, type part of a name or email in Search name/email, and click Apply (or press Enter). Reset clears the search.

Step 2: Find the people to add

  1. Click Add Member. The Add Members page opens.
  2. Type a name in Search by name and click Search (or press Enter). Leave the box empty and click Search to list your organization's users.
  3. Tick the checkbox next to each person you want to add. You can select several people at once.
Add Members page with the Search by name field and Search button, the Permissions for new members box with Select permissions, and the Cancel and Add Members buttons, with Add Members disabled

If nobody matches, the page shows No organization users found. Check the spelling, or make sure the person has accepted their organization invitation.

Step 3: Give them permission codes (optional)

If the agent has permission codes, a Permissions for new members box appears. Pick one or more codes in Select permissions. The same codes are given to everyone you selected in Step 2.

Example: for Atlas, you select the three people from Kirana's finance team and choose FINANCE. All three can now get answers from content tagged with FINANCE, while other users cannot. Site safety staff get SITE-HSE in a separate round.

Step 4: Add them

Click Add Members. The button stays disabled until you select someone, and then shows how many people you selected, for example Add 3 Members. Cancel returns to the list without adding anyone. You return to the Agent Members list, where the new members appear. People who were already members are skipped.


Part 2: Change or remove a member

  1. In the Agent Members list, click the member's row. The Member Roles & Permissions window opens.
  2. User Name and Email are read-only. Change the codes in Permissions as needed.
  3. Click Save.

To remove the person from the agent, click Delete Member at the top of the same window. The button is not shown on your own entry, so you cannot remove yourself this way.

Permission codes are attached to a conversation when it starts, so a change applies to the member's next conversation.


Part 3: See who can configure the agent

Open Users β†’ Contributor. This page shows, for the current agent and organization:

SectionWho is listedCan you change it here?
Organization OwnersEveryone with the Owner roleNo, they always have access
Organization AdminsEveryone with the Admin roleNo, they always have access
Agent ContributorsBuilders who were given access to this specific agentOnly through Manage Contributors (see below)
Contributor page for the organization Kirana Group: About Agent Contributors info box, Organization Owners with Rina Wijaya (rina.wijaya@kirana.example), Organization Admins None, and Agent Contributors with the Manage Contributors button and Rina Wijaya with a Leave button

The page starts with the organization name and an About Agent Contributors box: contributors must have the Organization Builder role, and only Organization Admins and Owners can add or remove them. In the Kirana example, Rina Wijaya is listed under Organization Owners and also under Agent Contributors for Atlas, so the Leave button shows on her row. Kirana has no Organization Admins yet, so that section shows None.

If you are an organization Owner or Admin, a Manage Contributors button appears next to Agent Contributors. It takes you to the agent's contributor page under Organization β†’ Agents, where you can add or remove contributors and decide what each one may see (conversation history, remembered participant data, automations). The full walkthrough is in Managing Agent Access.

Being a contributor lets someone build the agent. Reading conversations and reading what the agent remembers about people are separate permissions, set per contributor. See Conversation history access and Participant data access.


Part 4: Leave an agent as a contributor

If you are a contributor and no longer work on an agent, you can remove your own access:

  1. Open Users β†’ Contributor.
  2. In Agent Contributors, find your own row and click Leave.
  3. Type the agent's name to confirm, then confirm.

The Leave button appears only on your own row. Agent owners have no row in Agent Contributors, so they never see it: an owner hands the agent over or deletes it from the Organization β†’ Agents tab instead. See Transferring an Agent.


Check the result

  1. Ask a new member to sign in and open the agent's chat. They should be able to chat, even if the agent is Private.
  2. If you gave them a permission code, ask a question that only restricted content can answer. The member should get the answer, while a user without the code should not.
  3. Open Users β†’ Contributor and confirm that the right Builders are listed under Agent Contributors.

Next steps