OpenMax
免费试用

Apps API · Platform Agents

Platform Agents: 6 个接口

← 全部分组

GET /api/v1/platform-agents/domain-availability

Check platform agent domain availability

权限(scope): agents:agent:read · 调用方式: appToken · operationId: check-platform-agent-domain-availability

Required app scope: agents:agent:read.

Validates and assembles a platform agent subdomain, then checks the domain registry for current availability.

参数

名字 位置 类型 必填 说明
label query string 是 Subdomain label to check

回包

GET /api/v1/platform-agents/domain-config

Get platform agent domain config

权限(scope): agents:agent:read · 调用方式: appToken · operationId: get-platform-agent-domain-config

Required app scope: agents:agent:read.

Returns the configured public domain suffix for platform agent subdomains.

回包

GET /api/v1/platform-agents/model-catalog

Get the global model catalog (deprecated) (已弃用)

权限(scope): agents:agent:read · 调用方式: appToken · operationId: get-model-catalog

Required app scope: agents:agent:read.

Deprecated: always returns an empty models list. There is no model catalog any more; an agent's selectable models are its available_model_ids, returned by GET /api/v1/agents/{member_id}/model-config (available_models). Retained only so existing callers keep decoding; slated for removal.

回包

GET /api/v1/platform-agents/operational-states

List platform agent operational states

权限(scope): agents:agent:read · 调用方式: appToken · operationId: list-platform-agent-operational-states

Required app scope: agents:agent:read.

Returns the resource-centric platform-agent control state for every agent add-on, including add-ons whose Agent member has not been created yet. The billing operation/enforcement state is required; the runtime actual phase and the messaging connection presence degrade independently to unknown. available_actions is permission-specific and derived from the authoritative add-on status (active offers pause; paused/suspended offers resume): it is withheld while a conflicting operation/transition is in flight, but does NOT depend on the runtime actual_phase — a healthy add-on still offers pause/resume even when actual_phase is unknown. credit-cap still strips resume when the cap blocks it.

回包

GET /api/v1/platform-agents/timezones

List valid IANA timezones

权限(scope): agents:agent:read · 调用方式: appToken · operationId: list-platform-agent-timezones

Required app scope: agents:agent:read.

Returns the sorted list of selectable IANA timezone names (the zones of inhabited regions) plus UTC, for the create-agent timezone field. The list is the same for every agent and excludes historical aliases and placeholder names (e.g. Japan, US/Pacific, Zulu).

回包

GET /api/v1/platform-agents/{identity_id}/domain

Get platform agent bound domain

权限(scope): agents:agent:read · 调用方式: appToken · operationId: get-platform-agent-domain

Required app scope: agents:agent:read.

Returns the public domain bound to a platform agent, resolved by the agent's identity ID. Returns 404 when the agent has no bound domain.

参数

名字 位置 类型 必填 说明
identity_id path string (uuid) 是 Agent identity UUID

回包