Agent versions
An AgentVersion is one immutable snapshot of an Agent's definition.
An AgentVersion is one immutable snapshot of an Agent's definition. It is written by the create or update that changed the Agent's spec, and never changed after.
Service Sylphx Agents · Resource type agents.sylphx.com/AgentVersion · Name pattern orgs/{org}/projects/{project}/envs/{env}/agents/{agent}/agent_versions/{agent_version} · Shape record
Fields
| Field | Type | What it is |
|---|---|---|
name | string | orgs/{org}/projects/{project}/envs/{env}/agents/{agent}/agent_versions/{agent_version}. |
uid | string | agv_<cell><ulid>; never reused. Output only. |
meta | ResourceMeta | Resource metadata. |
version_number | int64 | The version number within the agent, from 1, with no gaps. Output only. |
spec | AgentSpec | The definition, frozen. Output only. |
agent_generation | int64 | The Agent generation that minted it. Output only. |
create_time | timestamp | When it was minted. Output only. |
Methods
Every method of the collection, in the registry's order, with the scope it needs. The full request, response and examples are one link away.
get
Gets an agent version.
GET https://api.sylphx.com/v1/orgs/acme/projects/shop/envs/production/agents/agent/agent_versions/agent-version · scope agents:read · effect read · Request, response and examples
list
Lists an agent's versions, newest first.
GET https://api.sylphx.com/v1/orgs/acme/projects/shop/envs/production/agents/agent/agent_versions · scope agents:read · effect read · paginated · Request, response and examples