Agent Identity
An agent identity is what HYPR AgentPass™ recognizes a request by. Each identity has an owner, the supervisor responsible for it. Every request the agent sends is therefore attributed both to the agent and to a person. Oversight → Agent identities opens the Agents page, which lists them all.
Where Identities Come From
An identity reaches the list in one of three ways.
| Source | How it appears |
|---|---|
| Synced from a provider | Under Import from, choose a connected AI provider connector, and click Sync Now. Each provider key becomes an identity, owned by the person it belongs to. The provider tabs on the page filter by source |
| Created manually | Click Add Agent, and enter a name, description, owner and scopes. Scopes offers inference, tools and admin, and starts with inference. The gateway generates the agent's API key and shows it once. Store it before you close the dialog |
| Onboarded | A local agent that points at the gateway gains an identity when its first connection is approved. See Onboarding Mode |
Agents that run with nobody at the keyboard, such as automations, pipelines and cloud harnesses, get a service agent identity instead, with its own role and credential. See Service Agents.
Read the List
The list has these columns.
| Column | Meaning |
|---|---|
| Agent | The identity's name. An identity synced from a provider also shows a hint of its provider key |
| Owner | The supervisor the agent is attributed to |
| Scopes | The scopes the identity carries, such as inference or tools |
| Active | Whether the identity can currently send traffic. A switch you cannot use is unavailable. See Who Can Turn an Agent Off and On |
| Mobile access | Whether the agent may open a real-time channel session for supervisor messaging. Turning the switch off ends active channel sessions, and prevents new ones from opening. AgentPass records who turned it on or off |
| Activity | When the identity was created or last seen |
Related
- Supervisor Identity — the person an agent is attributed to
- Service Agents — identities for unattended callers
- Onboarding Mode — how a connector treats an agent's first request