查询运行策略

读取智能体当前保存的策略引用，并返回可解析的运行策略配置和未解析引用的警告。

GET https://api.moi.matrixorigin.cn/v5/workspaces/{workspace_id}/agents/{agent_id}/policies

调用前准备

先查询智能体列表取得智能体 ID。准备有目标工作区访问权限的个人访问令牌、目标工作区 ID 和智能体 ID。

请求参数

curl "https://api.moi.matrixorigin.cn/v5/workspaces/$WORKSPACE_ID/agents/$AGENT_ID/policies" \
  -H "X-API-Key: $AI_STUDIO_API_KEY" \
  -H "X-Workspace-ID: $WORKSPACE_ID"

字段

类型

必填

说明

workspace_id

string

是

当前工作区 ID。

agent_id

string

是

要查看的智能体 ID。

字段

类型

必填

说明

agent_workspace_id

string

否

智能体所属工作区 ID。未提供时使用当前工作区；只能指定当前工作区或系统工作区。

成功响应

{
  "code": 0,
  "data": {
    "agent_id": "agent_01",
    "agent_version": 2,
    "policy_refs": {
      "runtime_policy_ref": "rp_01",
      "approval_policy_ref": "ap_01",
      "guardrail_policy_ref": "gp_01"
    },
    "runtime_policy": {
      "id": "rp_01"
    },
    "warnings": []
  }
}

成功时返回 200。warnings 表示某个引用没有被解析，不表示本次读取失败。

字段

类型

说明

code

integer

成功时为 0。

字段

类型

说明

data.agent_id

string

智能体 ID。

data.agent_version

integer

智能体资源版本。

data.policy_refs

object

已保存的运行、审批和护栏策略引用。

data.runtime_policy

object

可解析时返回的运行策略配置。

data.warnings

string（字符串数组）

无法解析的运行策略，或当前未解析的审批、护栏策略引用的说明。

错误响应

{
  "code": 3,
  "message": "<错误信息>"
}

字段

类型

说明

400

2（INVALID_ARGUMENT）

路径参数或 agent_workspace_id 无效。建议：检查路径和查询参数。

401

6（UNAUTHENTICATED）

缺少有效身份凭据。建议：检查 API Key。

403

5（PERMISSION_DENIED）

当前调用者没有读取智能体的权限。建议：检查工作区中的智能体授权。

404

3（NOT_FOUND）

指定工作区范围内不存在该智能体。建议：检查智能体 ID 和所属工作区。

503

15（UNAVAILABLE）

智能体资源服务或其授权依赖暂不可用。建议：稍后重试。

后续操作

需要修改时更新运行策略。

最后更新于