查询运行环境提供方列表

查询当前工作区可使用的智能体运行环境提供方及其配置（Profile）。

GET https://api.moi.matrixorigin.cn/v5/workspaces/{workspace_id}/agent-runtime-providers

调用前准备

准备可访问目标工作区的个人访问令牌和目标工作区 ID。

请求参数

输入示例

curl "https://api.moi.matrixorigin.cn/v5/workspaces/$WORKSPACE_ID/agent-runtime-providers" -H "X-API-Key: $AI_STUDIO_API_KEY" -H "X-Workspace-ID: $WORKSPACE_ID"

参数说明

字段	类型	是否必填	说明
include_development	boolean	否	为 true 时包含仅供开发使用的 Profile。

成功响应

响应示例

{
  "code": 0,
  "data": {
    "items": [],
    "total": 0,
    "limit": 0,
    "offset": 0
  }
}

字段说明

字段	类型	说明
code	integer	成功代码。
data	object	本次操作返回的数据。
data.items	object（对象数组）	运行时提供方配置。
data.items[].provider_id	string	提供方标识，可填入详情请求的 provider_id。
data.items[].profile_id	string	Profile 标识，可填入详情请求的 profile_id。
data.items[].display_name	string	显示名称。
data.items[].description	string	当前对象的说明。
data.items[].status	string	Profile 状态。
data.items[].adapter_status	string	适配状态。
data.items[].runtime_available	boolean	当前是否可用于运行。
data.items[].development_only	boolean	是否仅供开发使用。
data.items[].capabilities	object	支持的流式、取消和工具能力。
data.items[].capabilities.a2a_profile	string	A2A 配置。
data.items[].capabilities.streaming_mode	string	流式模式。
data.items[].capabilities.cancel_mode	string	取消方式。
data.items[].capabilities.task_snapshot_mode	string	任务快照模式。
data.items[].capabilities.workspace_mode	string	工作区模式。
data.items[].capabilities.external_network	string	外部网络能力。
data.items[].capabilities.checkpoint_mode	string	检查点模式。
data.items[].capabilities.secondary_auth_mode	string	二次授权模式。
data.items[].capabilities.input_request_mode	string	输入请求模式。
data.items[].capabilities.guardrail_mode	string	护栏模式。
data.items[].capabilities.trace_mode	string	追踪模式。
data.items[].capabilities.artifact_mode	string	产物模式。
data.items[].capabilities.permission_model	string	权限模型。
data.items[].capabilities.tool_mode	string	工具调用模式。
data.items[].capabilities.file_input	boolean	文件输入能力。
data.items[].capabilities.state_transition_history	boolean	状态变更历史能力。
data.items[].capabilities.native_code_execution	boolean	原生代码执行能力。
data.items[].capabilities.native_file_edit	boolean	原生文件编辑能力。
data.items[].capabilities.native_shell	boolean	原生 Shell 能力。
data.items[].capabilities.handoff	boolean	任务移交能力。
data.items[].capabilities.native_tool_policy	string（字符串数组） 或 null	原生工具策略。
data.items[].config_schema	object	配置结构元数据对象允许扩展键。
data.items[].reason	string	原因。
data.total	integer	当前筛选条件下的 Profile 总数。
data.limit	integer	本次实际采用的返回数量上限。
data.offset	integer	本次实际采用的偏移量。

错误响应

响应示例

{
  "code": 15,
  "message": "service unavailable"
}

字段说明

字段	类型	说明
code	integer	错误代码。
message	string	面向调用者的错误信息。

常见 HTTP 错误

HTTP 状态码	错误代码	常见原因	建议操作
400	2	请求字段、工作区或操作前置条件无效。	修正参数后再提交。
403	5	当前身份或有效角色无执行该操作的权限。	使用有权限的身份，或联系管理员授权。
404	3	目标对象或所需引用未找到。	核对对象标识、所属工作区和当前状态。
503	15	业务、运行时或授权依赖暂不可用。	恢复依赖后先核对已有结果，不自动重复写入。

最后更新于 2026 年 10 月 19 日