帮你快速理解、总结文档立即下载
文档中心>WorkBuddy Enterprise>API 文档>数据结构

数据结构

最近更新时间：2026-09-22 11:14:18
我的收藏

本页目录：

A2AConfig

Agent 的 A2A 对外互通配置与注册态

被如下接口引用：CreateAgent, DescribeAgent, ModifyAgent, ModifyAgentA2AConfig, ModifyAgentRouting。

名称 类型 必选 描述
A2AEnabled Boolean 否 Agent 级唯一 A2A 开关
注意：此字段可能返回 null，表示取不到有效值。
示例值：true
A2APublicRef String 否 对外 A2A handle（已注册时；仅 DescribeAgent / ModifyAgentA2AConfig 填充）
注意：此字段可能返回 null，表示取不到有效值。
示例值：agents/data-analyst
A2AEndpoint String 否 对外 A2A card 发现地址（已注册时）
注意：此字段可能返回 null，表示取不到有效值。
示例值：https://a2a.example.com/agents/data-analyst
A2AStatus String 否 注册状态：DRAFT / REGISTERED / DISABLED / NONE / UNKNOWN
注意：此字段可能返回 null，表示取不到有效值。
示例值：ACTIVE

A2ASkillInput

A2A skill 录入项（注册外部 Agent 时传入）

被如下接口引用：ModifyAgentA2AConfig。

名称 类型 必选 描述
A2ASkillId String 否

A2A skill ID


注意：此字段可能返回 null，表示取不到有效值。
示例值：order_query
Name String 否

skill 名称


注意：此字段可能返回 null，表示取不到有效值。
示例值：订单查询
Description String 否

skill 描述


注意：此字段可能返回 null，表示取不到有效值。
示例值：可以查询订单
Tags Array of String 否

标签


注意：此字段可能返回 null，表示取不到有效值。
示例值：["订单"]
Examples Array of String 否

示例


注意：此字段可能返回 null，表示取不到有效值。
示例值：["查一下上周订单"]

AgentItem

Agent 列表项（原 AgentSummary；Agent 级纯字段，不再内嵌版本信息）

被如下接口引用：DescribeAgentList。

名称 类型 必选 描述
AgentId String 否 Agent 业务 ID（全局唯一，数字字符串形态）
注意：此字段可能返回 null，表示取不到有效值。
示例值：736918300000000001
AgentName String 否 Agent 名称
注意：此字段可能返回 null，表示取不到有效值。
示例值：数据分析助手
Description String 否 Agent 描述；未填写时缺省
注意：此字段可能返回 null，表示取不到有效值。
示例值：负责每日运营数据的汇总与分析
AvatarUrl String 否 头像 URL；未设置时缺省
注意：此字段可能返回 null，表示取不到有效值。
示例值：https://example.com/avatar/agent-001.png
CreatedTime String 否 创建时间，RFC3339 UTC 格式（如 2026-06-01T09:00:00Z）
注意：此字段可能返回 null，表示取不到有效值。
示例值：2026-06-01T09:00:00Z
ModifiedTime String 否 更新时间，RFC3339 UTC 格式（如 2026-09-10T15:20:00Z）
注意：此字段可能返回 null，表示取不到有效值。
示例值：2026-09-10T15:20:00Z
A2AEnabled Boolean 否 Agent 级 A2A 开关。false 恒输出（未开启不等于字段缺失）；A2AEndpoint / A2AStatus 由本接口在 A2A 开启时直接下发
注意：此字段可能返回 null，表示取不到有效值。
示例值：true
SessionCount Integer 否 历史会话总数（t_managed_agent_sessions 未软删计数，含全部状态）。注意与 DescribeAgent.ActiveSessionCount（活跃会话数）口径不同
注意：此字段可能返回 null，表示取不到有效值。
示例值：42
Model String 否 最新版本的模型标识，取 latest_version_id 指向版本的 model；Agent 尚无版本时缺省
注意：此字段可能返回 null，表示取不到有效值。
示例值：hunyuan-turbos-latest
LatestVersionId String 否 最新版本 ID（latest_version_id 转字符串，19 位雪花数字形态）；Agent 尚无版本时缺省
注意：此字段可能返回 null，表示取不到有效值。
示例值：2087791755109965825
LatestVersionName String 否 最新版本名（可能为 default / test-N / prod-N 任意类型）；Agent 尚无版本时缺省
注意：此字段可能返回 null，表示取不到有效值。
示例值：prod-3
A2AEndpoint String 否 对外 A2A card 发现地址（Agent Card JSON 地址），仅 A2AEnabled=true 的行下发；未注册 / registry 读失败时缺省
注意：此字段可能返回 null，表示取不到有效值。
示例值：https://a2a.example.workbuddy.com/agents/736918300000000001/.well-known/agent-card.json
A2AStatus String 否 A2A 注册态：DRAFT / REGISTERED / DISABLED / NONE / UNKNOWN，仅 A2AEnabled=true 的行下发，与 DescribeAgent.A2AConfig.A2AStatus 同枚举；用于「开关已开但地址尚未生成」的空态文案
注意：此字段可能返回 null，表示取不到有效值。
示例值：REGISTERED
PublicApiEnabled Boolean 否 公网链接访问开关。false 恒输出（未开启不等于字段缺失）
注意：此字段可能返回 null，表示取不到有效值。
示例值：true
PublicApiUrl String 否 公网访问地址，仅 PublicApiEnabled=true 的行下发。固定拼法 https://{AgentId}-{region}.{endpoint_suffix}，与 DescribeAgentPublicAccess.Url 同规则；endpoint_suffix 未配置时为空
注意：此字段可能返回 null，表示取不到有效值。
示例值：https://736918300000000001-tc-nanjing.example-workbuddy.com
CreatorUin String 否 创建人 UIN（建号时落库的 sub_account_uin；主账号自建时为主账号 uin）。注意语义为「实际操作建号的账号」
注意：此字段可能返回 null，表示取不到有效值。
示例值：100012345678
AccountId String 否 绑定的 OneID 企业账号 ID（数字字符串形态，如 1438693592234206274）；空=未绑定（缺省）。与 DescribeAgent.AgentInfo.AccountId 同源同语义；创建时可选传入，之后不可变
注意：此字段可能返回 null，表示取不到有效值。
示例值：1438693592234206274

AgentVersionItem

Agent 版本列表项（原 AgentVersionSummary / AgentVersionBrief 合并，字段取并集）

被如下接口引用：DescribeAgentVersionList。

名称 类型 必选 描述
VersionId String 否 版本 ID（雪花算法生成的数字字符串，唯一标识）
注意：此字段可能返回 null，表示取不到有效值。
示例值：2101589342229893121
VersionName String 否 版本名称，形如 default / test-N / prod-N（N 为同类型版本的自增序号）
注意：此字段可能返回 null，表示取不到有效值。
示例值：default
VersionType String 否 版本类型（服务端按 VersionName 派生）：DEFAULT（默认版本，可编辑）/ TEST（测试版本，可编辑）/ PROD（生产版本，内容冻结）
注意：此字段可能返回 null，表示取不到有效值。
示例值：DEFAULT
Model String 否 版本绑定的模型标识；未设置时缺省
注意：此字段可能返回 null，表示取不到有效值。
示例值：glm-5.2
SandboxTemplateId String 否 版本运行时使用的沙箱模板业务 ID；空字符串表示使用默认沙箱
注意：此字段可能返回 null，表示取不到有效值。
示例值：tpl-fxuctus69mgw
Status String 否 版本状态：DRAFT（草稿）/ ENABLED（已启用）/ DISABLED（已停用）
注意：此字段可能返回 null，表示取不到有效值。
示例值：ENABLED
SessionCount Integer 否

该版本累计承接的会话总数（历史累计值，只增不减）


注意：此字段可能返回 null，表示取不到有效值。
示例值：6
CreatedTime String 否 创建时间，RFC3339 UTC 格式（如 2026-08-01T10:00:00Z）
注意：此字段可能返回 null，表示取不到有效值。
示例值：2006-01-02T15:04:05Z07:00
ModifiedTime String 否 更新时间，RFC3339 UTC 格式（如 2026-08-10T15:30:00Z）
注意：此字段可能返回 null，表示取不到有效值。
示例值：2006-01-02T15:04:05Z07:00

ConnectorRefInput

连接器引用入参

被如下接口引用：CreateAgent。

名称 类型 必选 描述
ConnectorId String 否 connector 主表 ID（雪花 ID 数字串）
示例值：conn-p1q2r3

Filter

云 API 通用过滤结构。多个 Filter 之间为 AND 关系；同一 Filter 内多个 Values 为 OR 关系。

被如下接口引用：DescribeAgentList, DescribeAgentVersionList。

名称 类型 必选 描述
Name String 否 过滤属性名
注意：此字段可能返回 null，表示取不到有效值。
示例值：TaskName
Values Array of String 否 过滤值列表（同一 Filter 内多个值为 OR 关系）
注意：此字段可能返回 null，表示取不到有效值。
示例值：["每日日报", "每周周报"]
ExactMatch Boolean 否 是否精确匹配，默认 false（模糊匹配）
注意：此字段可能返回 null，表示取不到有效值。
示例值：true

RoutingItem

路由项

被如下接口引用：CreateAgent, DescribeAgent, ModifyAgent, ModifyAgentA2AConfig, ModifyAgentRouting。

名称 类型 必选 描述
VersionId String 否 版本 ID
注意：此字段可能返回 null，表示取不到有效值。
示例值：v12
Weight Float 否 权重，(0, 1] 之间的浮点百分比
注意：此字段可能返回 null，表示取不到有效值。
示例值：100
中国站