Agents

Define autonomous agents with budgets, groups, and bound inference keys.

Agents are first-class fleet identities. Each agent can have spend limits, model allowlists, schedules, and a dedicated inference key.

  • Create agents in Dashboard → Agents; optionally auto-provision a bound nf_live_ key.
  • Agent groups inherit shared policies; individual agents can override.
  • Usage, activity, and exports attribute spend to agentId and agentGroupId.
  • Archive an agent to revoke its bound keys immediately.
Agent groups API
GET    /api/agents/groups
POST   /api/agents/groups
PATCH  /api/agents/groups/{id}
DELETE /api/agents/groups/{id}   # unassigns agents, does not delete them

# Create group with shared policy
POST /api/agents/groups
{"name": "support-bots", "spendLimits": {"monthlyUsd": 200}, "modelAllowlist": ["gpt-4o-mini"]}
Agent-scoped inference
# Use the agent's bound inference key — no extra headers required.
# Gateway tags usage with agentId from KeyMeta.

POST https://gateway.relixr.com/v1/chat/completions
Authorization: Bearer nf_live_agent_bound_key_...

{"model": "gpt-4o-mini", "messages": [...]}