client.agents.live

client.agents.live — the agents.live operations.

On AsyncKindgi every method is the same, awaited.

client.agents.live.resolve()

resolve(
    agent_id: str | UUID,
    /,
    *,
    project_id: str | UUID | None = None,
    segments: Sequence[ScopeSegment | Mapping[str, str]] | None = None,
    timeout: float | None = None,
) -> LiveVersionResolution

The version a run would use. GET /v1/agents/{agentId}/live

Resolves the version a run of this agent would use for a project and segment path: the most specific live version (segment path, project, org, tenant), else the latest registered. A run that names its version, or a follow-up turn in a conversation, isn't resolved this way.

client.agents.live.list()

list(agent_id: str | UUID, /, *, timeout: float | None = None) -> LivePinList

List an agent's live versions. GET /v1/agents/{agentId}/live-versions

Every scope with a live version pinned, and the promotion that set it.

client.agents.live.rollback()

rollback(
    agent_id: str | UUID,
    body: RollbackBody | Mapping[str, Any] | None = None,
    /,
    *,
    idempotency_key: str | None = None,
    timeout: float | None = None,
    **fields: Any,
) -> Promotion

Roll a scope back to its previous live version. POST /v1/agents/{agentId}/live/rollback

Back to the scope's previous live version, or toVersion. Recorded like a promotion. Needs promote on the agent.

client.agents.live.unpin()

unpin(
    agent_id: str | UUID,
    body: UnpinBody | Mapping[str, Any] | None = None,
    /,
    *,
    idempotency_key: str | None = None,
    timeout: float | None = None,
    **fields: Any,
) -> Promotion

Remove a scope's live version. POST /v1/agents/{agentId}/live/unpin

Removes the scope's own pin: its runs use the next scope up (and the latest when nothing is pinned). Recorded like a promotion. Needs promote on the agent.