Levain LabsLevain Labs
API ReferenceAgents

Get Agent Objective

Read the objective that turns an agent's run signals into a reward.

Read the objective that turns an agent's run signals into a reward.

Every agent starts on the platform default (version 0): a failed run scores the lower bound, human ratings and approvals count, and a run with neither is excluded rather than scored.

GET
/api/v1/agents/{agent_id}/objective

Authorization

HTTPBearer
AuthorizationBearer <token>

In: header

Path Parameters

agent_id*Agent Id

Header Parameters

X-API-Key?string|null

Response Body

application/json

application/json

curl -X GET "https://api.levainlabs.com/api/v1/agents/string/objective"
{
  "agent_id": "2b1e3b65-2c04-4fa2-a2d7-467901e98978",
  "version": 0,
  "definition": {
    "horizon_s": 0,
    "default": "exclude",
    "guards": [
      {
        "signal": "string",
        "op": "gt",
        "value": 0
      }
    ],
    "terms": [
      {
        "signal": "string",
        "weight": 0,
        "agg": "first",
        "within_s": 0,
        "scale": [
          0,
          0
        ],
        "missing": "skip",
        "evidence": true
      }
    ],
    "bounds": [
      0,
      1
    ]
  },
  "note": "string",
  "created_by": "string",
  "created_at": "2019-08-24T14:15:22Z"
}