KYA (Know Your Agent) is a four-level identity verification hierarchy. Agents begin with zero permissions and unlock capabilities through developer verification, user authorization, and behavioral baseline analysis.
The agent exists in the system. No financial operations are permitted. This is the starting state for every new agent.
The developer has verified the agent through KYB (Know Your Business) attestation. The agent can execute transactions within low spending limits.
A human user has authorized this agent to act on their behalf. The agent can access enhanced operations with higher limits.
The agent has maintained 30 days of clean transaction history. The system has established a behavioral baseline. Full autonomy is granted within policy limits.
Oris monitors every agent transaction against its established behavioral baseline. If an agent deviates from its normal spending patterns, the system triggers automatic suspension.
The agent is demoted to a lower trust level until the developer investigates. No human delay exists in this process. The detection happens within the policy evaluation cycle at sub-10ms latency.
# Register an agent with KYA
agent = oris.agents.create(
name="procurement-bot",
description="Purchases cloud compute credits",
kya_level=0 # starts at L0
)
# Promote after developer verification
oris.agents.promote(
agent.id,
target_level=1
)Create an agent at Level 0. Complete developer verification to promote it to Level 1. Each promotion is an explicit API call. Trust levels never increase automatically.
Level 3 requires 30 days of clean transaction history. The system evaluates behavioral consistency and promotes the agent when the baseline is established. No manual intervention is needed for this final step.
Register your first agent and assign trust levels through the API. KYA is included in every Oris plan.