Skip to content

Agent Registry

Agent Registry

Register AI agents with the control plane. Each agent accumulates an adaptive trust level, clean records earn fast-path clearance, blocks reduce trust.

POST /v1/enforce/agents Register a new agent. GET /v1/enforce/agents List all registered agents. GET /v1/enforce/agents/{agent_id} Get agent details including trust level and action history. GET /v1/enforce/agents/{agent_id}/history Get trust history and decision timeline for an agent.

Adaptive Trust

Event Trust Change Description
Action allowed +0.2 Clean record builds trust over time
Action blocked -2.0 Policy violations significantly reduce trust
Action escalated -0.5 Uncertain decisions slightly reduce trust

Register Agent Example

# Register a trading agent
agent = requests.post(
    "https://www.xybern.com/api/v1/enforce/agents",
    headers={"X-API-Key": API_KEY},
    json={
        "name": "Trading Agent Alpha",
        "framework": "langchain",
        "description": "Automated equity trading agent",
        "capabilities": ["execute_trade", "read_data", "send_email"],
        "permissions": {
            "allowed_action_types": ["execute_trade", "read_data"],
            "denied_action_types": ["delete_data", "admin_action"]
        }
    }
).json()

agent_id = agent["agent"]["agent_id"]
print(f"Registered: {agent_id}, trust: {agent['agent']['trust_level']}")