Supervisor Identity
A supervisor is the person responsible for an agent. HYPR AgentPass™ learns who they are from your identity provider, gives each one a role, and attributes their agents' traffic to them. The Humans tab of Oversight → People lists everyone the gateway knows.
Where People Come From
The gateway discovers people automatically, from sign-ins and syncs:
- Console sign-in. Anyone who signs in through SSO becomes a human, with the roles their token's values are mapped to, or the default role. See Signing In to the Console.
- Directory provisioning. Users and groups pushed over SCIM appear before their first sign-in. See Gateway Settings → Directory / SCIM.
- Provider syncs. Syncing an AI provider connector's keys creates the owner of each key. See Agent Identity.
Each row shows the person, where the gateway learned about them, their groups, their roles, how many agents they own, and when they were last active. Tiles above the list count everyone, the people who have enrolled a passkey, the people with an invitation outstanding, and the people who were offboarded.
When the identity provider does not carry a person's roles, assign or change them here. Roles assigned in the console are not overwritten at the next sign-in. See Roles and Permissions.
What a Supervisor Carries
Each supervisor brings three things to their agents:
- Their roles, which decide what they see in the console and which tools their agents may call.
- A passkey, used to approve agent actions from the HYPR mobile app. See Setting Up Your Approval Passkey.
- Their agents. A supervisor's sign-in can open a real-time messaging channel for an agent they own. The channel uses the supervisor's identity, and remains subject to the agent's Mobile access setting.
Find a Person
On the Humans tab, type a name or email address, or part of one, in the Search by name or email field. The list narrows to the people who match.
Open a Person's Details
Click Details on a person's row. A drawer shows these details.
| Field | What it shows |
|---|---|
| The address the person is known by | |
| Gateway roles | The person's AgentPass roles. When an administrator assigned them, Use identity provider roles hands the person back to their identity provider. See Roles and Permissions |
| AI provider role | The person's role in the AI provider that surfaced them, when there is one |
| AI provider ID | The person's user ID in that AI provider |
| Source | Where the gateway learned about the person, such as SCIM, OAuth, Anthropic, OpenAI or Manual |
| Discovered | When the gateway first learned about the person |
| Last seen | When the person was last active |
Below the details, Agents lists each agent the person supervises. A person with no agents shows This person has no agents.
Invite a Person to Enroll a Passkey
A supervisor needs a passkey to approve agent actions from the HYPR mobile app. An administrator can send the person an activation link from their row.
- On the Humans tab, open the person's actions menu (⋮).
- Choose how to deliver the activation link:
- Send invite emails the link to the person. Once an invitation is outstanding, the menu offers Send reminder instead.
- Copy invite link copies the link to your clipboard, so you can share it with the person yourself.
The link stays valid for the Invite link lifetime (hours) set on the Invitations card in Advanced → Gateway Settings, seven days by default. See Gateway Settings → Email / Invitations.
Offboard a Person
Offboard a person when they leave your organization or must lose access now. Offboarding is an administrator action.
- On the Humans tab, open the person's actions menu (⋮), and choose Offboard.
- Review what the dialog says will be affected: the person's agents, credentials, group memberships and pending approvals.
- Click Offboard to confirm.
Offboarding takes effect immediately. It:
- Revokes the person's access to every agent assigned to them
- Ends any agent sessions they have in progress
- Disconnects all their tool connections, such as mail or chat accounts
- Removes them from every group and every agent assignment
The person's past activity and audit trail are kept, and AgentPass records which administrator offboarded them. Deactivating or deleting the person in your directory over SCIM offboards them the same way.
Offboarded people leave the list. Select Show offboarded to see them. Invite again in an offboarded person's actions menu brings them back, but their agents and credentials do not return. For a person your identity provider manages, re-enable them there instead.
Offboarding does not stop the service agents a person owns. A service agent authenticates with its own credential, so it keeps working after its owner is offboarded. Review the service agents the person owns, and reassign or disable each one. See Reviewing Your Service Agents.
Related
- Roles and Permissions — what each role grants
- Groups — give a set of people access to a shared agent
- Acting on Behalf of a Supervisor — how an agent reaches tools as its supervisor