Skip to main content
Unlisted page
This page is unlisted. Search engines will not index it, and only users having a direct link can access it.
Version: 11.3.0

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.

SourceHow it appears
Synced from a providerUnder 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 manuallyClick 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
OnboardedA 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.

ColumnMeaning
AgentThe identity's name. An identity synced from a provider also shows a hint of its provider key
OwnerThe supervisor the agent is attributed to
ScopesThe scopes the identity carries, such as inference or tools
ActiveWhether the identity can currently send traffic. A switch you cannot use is unavailable. See Who Can Turn an Agent Off and On
Mobile accessWhether 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
ActivityWhen the identity was created or last seen