AgentInfo-API 网关(API Gateway)-阿里云帮助中心

名称	类型	描述	示例值
	object	Agent 聚合资源的基本信息、类型允许的能力，以及已配置访问能力关联的底层资源 ID。
agentId	string	Agent ID。	agent-1
gatewayId	string	Agent 所属的网关 ID。读取关联 API 部署配置时应选择 gatewayId 与该值一致的配置。	gateway-1
name	string	Agent 名称。	my-agent
agentType	string	Agent 类型。DashScope（百炼）仅允许 Agent 访问，Dify 允许 Agent 访问和模型访问，ClaudeCode 仅允许模型访问，Custom 允许 Agent 访问和模型访问。	Custom
description	string	Agent 描述。	custom agent
resourceGroupId	string	Agent 保存的资源组 ID。	rg-1
status	string	Agent 状态。本期成功创建并可被查询的 Agent 固定返回 Ready；内部创建或补偿状态不对外返回。	Ready
allowedCapabilities	array	当前 Agent 类型允许配置的能力列表。该字段不表示能力已经配置；是否已配置应判断 agentAccess 或 modelAccess 是否为 null。
	string	Agent 类型允许配置的能力。AgentAccess 表示 Agent 访问，ModelAccess 表示模型访问。	["AgentAccess", "ModelAccess"]
agentAccess	object	Agent 访问能力的关联资源信息。未配置 Agent 访问能力时固定返回 null。
httpApiId	string	Agent 访问能力关联的 HTTP API ID。前端使用该 ID 调用存量 HTTP API、路由、消费者授权、策略和插件查询接口。	{ "httpApiId": "api-abc123" }
modelAccess	object	模型访问能力的关联资源信息。未配置模型访问能力时固定返回 null。
modelApiId	string	模型访问能力关联的 Model API ID。Model Access 不区分路由；前端使用该 ID 查询 Model API 基本信息及全部路由。	{ "modelApiId": "model-api-1" }
consumerIds	array	由 Agent 域维护的消费者身份绑定列表。Model API ID 和列表中的消费者 ID 共同定位 Agent 身份，对该 Model API 的所有路由生效；消费者详情及其 Model API 授权详情通过存量 Consumer API 和消费者授权查询接口获取。
	string	代表该 Agent 身份的消费者 ID。	["consumer-1", "consumer-2"]
createTimestamp	integer	Agent 创建时间，Unix 毫秒时间戳。	1755129600000
updateTimestamp	integer	Agent 最近更新时间，Unix 毫秒时间戳。	1755129600000

object

Agent 聚合资源的基本信息、类型允许的能力，以及已配置访问能力关联的底层资源 ID。

agentId

string

Agent ID。

agent-1

gatewayId

string

Agent 所属的网关 ID。读取关联 API 部署配置时应选择 gatewayId 与该值一致的配置。

gateway-1

name

string

Agent 名称。

my-agent

agentType

string

Agent 类型。DashScope（百炼）仅允许 Agent 访问，Dify 允许 Agent 访问和模型访问，ClaudeCode 仅允许模型访问，Custom 允许 Agent 访问和模型访问。

Custom

description

string

Agent 描述。

custom agent

resourceGroupId

string

Agent 保存的资源组 ID。

rg-1

status

string

Agent 状态。本期成功创建并可被查询的 Agent 固定返回 Ready；内部创建或补偿状态不对外返回。

Ready

allowedCapabilities

array

当前 Agent 类型允许配置的能力列表。该字段不表示能力已经配置；是否已配置应判断 agentAccess 或 modelAccess 是否为 null。

string

Agent 类型允许配置的能力。AgentAccess 表示 Agent 访问，ModelAccess 表示模型访问。

["AgentAccess", "ModelAccess"]

agentAccess

object

Agent 访问能力的关联资源信息。未配置 Agent 访问能力时固定返回 null。

httpApiId

string

Agent 访问能力关联的 HTTP API ID。前端使用该 ID 调用存量 HTTP API、路由、消费者授权、策略和插件查询接口。

{ "httpApiId": "api-abc123" }

modelAccess

object

模型访问能力的关联资源信息。未配置模型访问能力时固定返回 null。

modelApiId

string

模型访问能力关联的 Model API ID。Model Access 不区分路由；前端使用该 ID 查询 Model API 基本信息及全部路由。

{ "modelApiId": "model-api-1" }

consumerIds

array

由 Agent 域维护的消费者身份绑定列表。Model API ID 和列表中的消费者 ID 共同定位 Agent 身份，对该 Model API 的所有路由生效；消费者详情及其 Model API 授权详情通过存量 Consumer API 和消费者授权查询接口获取。

string

代表该 Agent 身份的消费者 ID。

["consumer-1", "consumer-2"]

createTimestamp

integer

Agent 创建时间，Unix 毫秒时间戳。

1755129600000

updateTimestamp

integer

Agent 最近更新时间，Unix 毫秒时间戳。

1755129600000