查询运行环境提供方配置

查询一个运行环境提供方的配置（Profile）。

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

调用前准备

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

请求参数

输入示例

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

参数说明

字段	类型	是否必填	说明
workspace_id	string	是	查看范围的工作区 ID。
provider_id	string	是	运行时提供方 ID。
profile_id	string	是	提供方 Profile ID。

成功响应

响应示例

{
  "code": 0,
  "data": {
    "provider_id": "astra",
    "profile_id": "default",
    "display_name": "Astra Default",
    "description": "默认运行环境",
    "runtime_available": true,
    "status": "",
    "adapter_status": "",
    "capabilities": {
      "a2a_profile": "",
      "streaming_mode": "",
      "cancel_mode": "",
      "tool_mode": ""
    }
  }
}

字段说明

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

错误响应

响应示例

{
  "code": 3,
  "message": "runtime provider not found"
}

字段说明

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

HTTP 状态码	错误代码	说明

常见 HTTP 错误

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

最后更新于 2026 年 10 月 19 日