查询运行时提供方 Profile¶

查询一个运行时提供方 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。

成功响应¶

成功时返回 200 和目标 Profile。

响应示例

{
  "code": 0,
  "data": {
    "provider_id": "astra",
    "profile_id": "default",
    "display_name": "Astra Default",
    "description": "默认运行环境",
    "runtime_available": true
  }
}

字段说明

通用字段

字段	类型	说明
`data`	object	运行时提供方 Profile。

基础信息

字段	类型	说明
`data.provider_id`	string	运行时提供方 ID。
`data.profile_id`	string	Profile ID。
`data.display_name`	string	Profile 展示名称。
`data.description`	string	Profile 说明；有值时返回。

配置与凭据

字段	类型	说明
`data.config_schema`	object	配置结构；存在时返回。

能力与工具

字段	类型	说明
`data.capabilities`	object	支持的流式、取消、工具和文件能力。

状态信息

字段	类型	说明
`data.status`	string	Profile 状态。
`data.adapter_status`	string	适配器状态。
`data.runtime_available`	boolean	当前是否可用于运行。
`data.reason`	string	Profile 当前不可用的原因；有诊断信息时返回。

错误响应¶

响应示例

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

字段说明

通用字段

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

最后更新于 2026 年 9 月 11 日