Register Your Agent

Before ASCEND can govern your agent's actions, the agent must be registered and activated. Unregistered agents receive conservative default thresholds — registration lets you configure custom risk thresholds, allowed action types, and governance policies.

Two-step process

Registration creates the agent in DRAFT status. You must activate it before it can submit governed actions.

Option A — Dashboard (Recommended)

1. Go to Agent Registry in the sidebar
2. Click Register New Agent
3. Fill in:
   • Agent ID — unique identifier (3–64 chars, e.g. finance-bot)
   • Display Name — human-readable label
4. Click Save
5. Find your agent in the list and click Activate

Option B — SDK

Registration uses the agent_id and agent_name you set in the AscendClient constructor:

from ascend import AscendClient, FailMode

client = AscendClient(
    api_key="owkai_your_key_here",
    api_url="https://pilot.owkai.app",
    agent_id="finance-bot",      # used by register()
    agent_name="Finance Bot",    # used by register()
    fail_mode=FailMode.CLOSED,
)

# Register the agent (idempotent — safe to call on every startup)
result = client.register()
print(result["status"])
# → "registered" or "already_registered"

After registration, activate via the dashboard (Agent Registry → your agent → Activate) or via the REST API:

curl -X POST \
  https://pilot.owkai.app/api/registry/agents/{agent_id}/activate \
  -H "X-API-Key: owkai_your_key_here"

Option C — REST API

# Step 1: Register
curl -X POST \
  https://pilot.owkai.app/api/registry/agents \
  -H "X-API-Key: owkai_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "agent_id": "finance-bot",
    "display_name": "Finance Bot"
  }'

# Response (201 Created):
# {
#   "success": true,
#   "created": true,
#   "agent": {
#     "agent_id": "finance-bot",
#     "status": "draft"
#   },
#   "next_steps": [
#     "Configure policies",
#     "Activate agent",
#     "Submit actions"
#   ]
# }

# Step 2: Activate (required before submitting actions)
curl -X POST \
  https://pilot.owkai.app/api/registry/agents/finance-bot/activate \
  -H "X-API-Key: owkai_your_key_here"

Idempotency

Registration is idempotent. Calling client.register() or the REST endpoint when the agent already exists returns "already_registered" — no error. Safe to call on every container startup.

Default Thresholds

New agents are created with these conservative defaults:

Threshold	Default
Auto-approve below	30
Max risk threshold	80
Agent type	Supervised

Adjust these in Agent Registry → your agent → Edit.

Next Steps

Once your agent is registered and activated, proceed to First Governed Action.