帮你快速理解、总结文档立即下载

数据结构

最近更新时间:2026-11-03 03:11:13
我的收藏

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,表示取不到有效值。
示例值:["查一下上周订单"]

A2ASkillItem

A2A skill 列表项(出参用,来自 A2A card 解析结果)

被如下接口引用:DescribeExternalAgent, DescribeExternalAgentList。

名称 类型 必选 描述
A2ASkillId String 否 A2A skill ID(加 A2A 前缀与内部 SkillId 概念区分)
注意:此字段可能返回 null,表示取不到有效值。
示例值:skill-7f8g9h
Name String 否 skill 名称
注意:此字段可能返回 null,表示取不到有效值。
示例值:数据分析
Description String 否 skill 描述
注意:此字段可能返回 null,表示取不到有效值。
示例值:负责数据查询与分析技能

AgentConfig

任务关联的 Agent 配置

被如下接口引用:CreateScheduledTask, DescribeScheduledTask, DescribeScheduledTaskList, ModifyScheduledTask。

名称 类型 必选 描述
Prompt String 否

执行 Prompt(必填)


注意:此字段可能返回 null,表示取不到有效值。
示例值:每天上午
AgentId String 否

Agent 唯一标识(引用 CreateAgent 创建的 Managed Agent,必填)


注意:此字段可能返回 null,表示取不到有效值。
示例值:01M5W4SQM878XNW9CW0065EJH0

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

BuiltinModel

内置模型信息

被如下接口引用:DescribeBuiltinModelList。

名称 类型 必选 描述
ModelId String 否 模型唯一标识
示例值:hunyuan-turbos-latest
Name String 否 模型名称
注意:此字段可能返回 null,表示取不到有效值。
示例值:混元 Turbos
Vendor String 否 供应商,如 TENCENT、OPENAI、ANTHROPIC、DEEPSEEK 等
注意:此字段可能返回 null,表示取不到有效值。
示例值:TENCENT
MaxOutputTokens Integer 否 最大输出 Token 数
注意:此字段可能返回 null,表示取不到有效值。
示例值:32768
MaxInputTokens Integer 否 最大输入 Token 数
注意:此字段可能返回 null,表示取不到有效值。
示例值:262144
SupportsToolCall Boolean 否 是否支持函数调用(Tool Call)
注意:此字段可能返回 null,表示取不到有效值。
示例值:true
SupportsImages Boolean 否 是否支持视觉(图片输入)
注意:此字段可能返回 null,表示取不到有效值。
示例值:false
SupportsThinking Boolean 否 模型是否支持思考。仅用于展示;能否配置思考强度以 ThinkingLevels 和 CanDisableThinking 为准
注意:此字段可能返回 null,表示取不到有效值。
示例值:true
ThinkingLevels Array of String 否 可选的思考强度,取值:MINIMAL、LOW、MEDIUM、HIGH、XHIGH、MAX,数组顺序即展示顺序。不包含「关闭」,空数组表示不支持调整强度。在 Agent 版本 Manifest 中配置 thinking.level 时使用对应的小写值
注意:此字段可能返回 null,表示取不到有效值。
示例值:["LOW", "HIGH"]
DefaultThinkingLevel String 否 模型默认的思考强度,取值同 ThinkingLevels;空字符串表示未声明。Agent 版本 Manifest 未配置 thinking 时按模型默认档位运行
注意:此字段可能返回 null,表示取不到有效值。
示例值:HIGH
CanDisableThinking Boolean 否 是否支持关闭思考。为 true 时,可在 Agent 版本 Manifest 中配置 thinking.level 为 disabled
注意:此字段可能返回 null,表示取不到有效值。
示例值:false
DescriptionZh String 否 模型中文描述
注意:此字段可能返回 null,表示取不到有效值。
示例值:混元 Turbo 版模型,速度快、成本低
DescriptionEn String 否 模型英文描述
注意:此字段可能返回 null,表示取不到有效值。
示例值:Hunyuan Turbo model with fast speed and low cost
Tags Array of String 否 模型标签列表
注意:此字段可能返回 null,表示取不到有效值。
示例值:["chat", "tool_call"]
Clients Array of String 否 支持的客户端列表
注意:此字段可能返回 null,表示取不到有效值。
示例值:["web", "desktop"]
ServiceEndpoint String 否 服务接入地址
注意:此字段可能返回 null,表示取不到有效值。
示例值:https://hunyuan.tencentcloudapi.woa.com
Status String 否 状态:ENABLED(已启用)/ DISABLED(已停用)
注意:此字段可能返回 null,表示取不到有效值。
示例值:ACTIVE
AgentCount Integer 否 本企业内绑定该模型的 Agent 数(过滤软删除 Agent/版本与调试 Agent)
注意:此字段可能返回 null,表示取不到有效值。
示例值:128

ChatEndpoint

聊天接入点。EndpointType 现在就引入枚举:当前仅返回一个 PUBLIC 元素,将来新增私网端点与 VPC 属性为纯增量。

被如下接口引用:CreateAgentSession, DescribeAgentSession。

名称 类型 必选 描述
EndpointType String 否 接入点类型:PUBLIC(公网)/ PRIVATE(私网,预留)
注意:此字段可能返回 null,表示取不到有效值。
示例值:WEB
Url String 否 接入点地址
注意:此字段可能返回 null,表示取不到有效值。
示例值:https://example.com/chat/agent-001

ConnectorInfo

连接器详情(主表 + 最新版本展开)。

被如下接口引用:DescribeConnectorList。

名称 类型 必选 描述
ConnectorId String 否

连接器 ID


示例值:conn_a3b91f0e2d7c4f88
ConnectorSlug String 否

连接器短标识(终身不变,跨版本稳定)


示例值:notion-k3x9m2
ConnectorKey String 否

版本级连接器密钥


示例值:notion-k3x9m2-v2
Name String 否

连接器名称


示例值:notion
Description String 否

连接器描述


示例值:企业 Notion 接入
AvatarUrl String 否

头像 URL


示例值:https://example.com/icon.png
Source String 否

连接器来源:ENTERPRISE_AGENT / ASSISTANT


示例值:ENTERPRISE_AGENT
EnterpriseId String 否

归属企业 ID


示例值:ent-xxxx
Type String 否

连接器类型:MCP_SERVER / A2A / API_SERVICE


示例值:MCP_SERVER
ServiceUrl String 否

上游服务地址


示例值:https://mcp.notion.internal/v1
AuthModes Array of String 否

授权方式列表:NONE / ONEID / OAUTH2_IDP / API_KEY / DYNAMIC_API_KEY。DYNAMIC_API_KEY 表示按每轮请求提供的动态字段,通过 HeaderMappings 注入出站 HTTP Header。


示例值:["ONEID"]
LatestVersionNo Integer 否

最新版本号


示例值:2
Status String 否

连接器状态:ACTIVE / DISABLED


示例值:ACTIVE
CreatorId String 否

创建人 ID


示例值:100012345
CreatedTime String 否

创建时间(ISO8601,UTC)


示例值:2026-08-26T09:10:03Z
ModifiedTime String 否

最后修改时间(ISO8601,UTC)


示例值:2026-08-26T11:20:44Z
VpcConfigId String 否

VPC 网络配置 ID。为空表示该连接器通过公网访问 ServiceUrl。仅绑定 VPC 网络配置时本字段有值。


示例值:2110326474825162752
DisplayName String 否

展示名:console 老连接器目录(DescribeConsoleConnectorList)下发,取 registry data.display_name,老数据缺失时回落 Name;云上目录无独立展示名,省略不返回。Name 是存储名/选型回写键(含 scope 前缀),不承担展示职责。


注意:此字段可能返回 null,表示取不到有效值。

ConnectorRefInput

连接器引用入参

被如下接口引用:CreateAgent, ModifyAgentVersion。

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

DeliveryTarget

投递目标

被如下接口引用:CreateScheduledTask, DescribeScheduledTask, ModifyScheduledTask。

名称 类型 必选 描述
Type String 否

投递类型:BOT_CHANNEL(IM 渠道投递)或 WEBHOOK(自定义回调)


注意:此字段可能返回 null,表示取不到有效值。
示例值:BOT_CHANNEL
Enabled Boolean 否

是否启用此投递目标


注意:此字段可能返回 null,表示取不到有效值。
示例值:true
Options TargetOptions 否

投递配置,按 Type 不同


注意:此字段可能返回 null,表示取不到有效值。

ExpertCounts

全局专家计数

被如下接口引用:DescribeExpertList。

名称 类型 必选 描述
Builtin Integer 否

内置专家数


注意:此字段可能返回 null,表示取不到有效值。
示例值:323
Custom Integer 否

自建专家数


注意:此字段可能返回 null,表示取不到有效值。
示例值:0
Total Integer 否

总数


注意:此字段可能返回 null,表示取不到有效值。
示例值:323

ExpertItem

专家列表/详情项

被如下接口引用:DescribeExpertList。

名称 类型 必选 描述
Source String 否

专家来源:builtin、custom


示例值:BUILTIN
DisplayName String 否

展示名


示例值:伯乐乐
Description String 否

描述


示例值:精通人才招聘全流程,为团队找到最佳人才
Icon String 否

图标 URL


示例值:https://staging-download.codebuddy.cn/public/experts/avatars/ZhihuStrategist.png
Enabled Boolean 否

是否启用


示例值:true
DownloadUrl String 否

下载 URL


示例值:https://staging-download.codebuddy.cn/operation-platform/experts/plugins/content-platform-experts/1.0.0.zip?sign=1789570921-aa39d00c6366b112-0-7042175b3155a3b0d1a4621502c968af&expert_id=ex_T7onGXvlG7E7
ModifiedTime String 否

更新时间


示例值:2026-07-20T12:11:47Z
Status String 否

启停状态:enabled、disabled


示例值:ENABLED
ExpertId String 否

专家标识


注意:此字段可能返回 null,表示取不到有效值。
示例值:ex_McsoRGB85Aax
ExpertVersion String 否

当前生效版本号


注意:此字段可能返回 null,表示取不到有效值。
示例值:1.0.1

ExternalAgentInfo

外部 Agent 列表/详情项

被如下接口引用:DescribeExternalAgentList。

名称 类型 必选 描述
A2AAgentId String 否 外部 A2A agent ID
注意:此字段可能返回 null,表示取不到有效值。
示例值:a2a-q7r8s9t0
Name String 否 外部 Agent 名称
注意:此字段可能返回 null,表示取不到有效值。
示例值:外部助手
Description String 否 描述
注意:此字段可能返回 null,表示取不到有效值。
示例值:一个用于外部协作的智能助手
Endpoint String 否 外部 A2A Server URL
注意:此字段可能返回 null,表示取不到有效值。
示例值:https://example.com/a2a/agent
BindingId String 否 绑定记录 ID(已绑定时返回)
注意:此字段可能返回 null,表示取不到有效值。
示例值:1024
Bound Boolean 否 是否已绑定到当前 Agent
注意:此字段可能返回 null,表示取不到有效值。
示例值:true
IconUrl String 否 头像地址(取自 provider card 的 iconUrl)
注意:此字段可能返回 null,表示取不到有效值。
示例值:http://xxx.xx/
A2AVersion String 否 外部 agent card 声明的版本号
注意:此字段可能返回 null,表示取不到有效值。
示例值:default
LatestVersionName String 否 子 Agent 的最新版本名,返回版本存储名(default / test-N / prod-N),非 V1/V2 展示名。取值规则:有正式版本(prod)时取最新 prod,否则取最新 test,再否则取 default。仅企业 Agent 来源返回(其 A2AVersion 恒为 default);其他来源或查询失败时不返回。注意:不代表 A2A 调用时实际执行的版本
注意:此字段可能返回 null,表示取不到有效值。
示例值:test-1
A2ASkillSet Array of A2ASkillItem 否 A2A card skills 集合
注意:此字段可能返回 null,表示取不到有效值。

Filter

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

被如下接口引用:DescribeAgentList, DescribeAgentSessionList, DescribeAgentVersionList, DescribeBuiltinModelList, DescribeConnectorList, DescribeExpertList, DescribeExternalAgentList, DescribeMessageEventList, DescribeScheduledTaskList, DescribeScheduledTaskLogList, DescribeSkillList。

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

自定义请求头键值对

被如下接口引用:CreateScheduledTask, DescribeScheduledTask, ModifyScheduledTask。

名称 类型 必选 描述
Key String 否

请求头名称


注意:此字段可能返回 null,表示取不到有效值。
示例值:Authorization
Value String 否

请求头值


注意:此字段可能返回 null,表示取不到有效值。
示例值:Bearer token

MessageEvent

消息事件

被如下接口引用:DescribeMessageEventList。

名称 类型 必选 描述
Sequence Integer 否

序号


注意:此字段可能返回 null,表示取不到有效值。
示例值:29
EventType String 否

类型 USER/TOOL/ASSISTANT


注意:此字段可能返回 null,表示取不到有效值。
示例值:TOOL
OccurredAt String 否

发生时间 ISO8601


注意:此字段可能返回 null,表示取不到有效值。
示例值:2026-09-22T03:31:06Z
Message MessageEventMessage 否

消息内容


注意:此字段可能返回 null,表示取不到有效值。
ToolCall MessageEventToolCall 否

工具调用


注意:此字段可能返回 null,表示取不到有效值。

MessageEventMessage

消息内容

被如下接口引用:DescribeMessageEventList。

名称 类型 必选 描述
Content String 否

文本内容


注意:此字段可能返回 null,表示取不到有效值。
示例值:随便使用个工具,查一下当前目录有多少文件
TokenUsage TokenUsage 否

Token用量


注意:此字段可能返回 null,表示取不到有效值。

MessageEventToolCall

工具调用

被如下接口引用:DescribeMessageEventList。

名称 类型 必选 描述
ToolCallId String 否

调用ID


注意:此字段可能返回 null,表示取不到有效值。
示例值:call_f4b4a3c718354152a953c5de
ToolName String 否

工具名


注意:此字段可能返回 null,表示取不到有效值。
示例值:Bash
Status String 否

状态 PENDING/IN_PROGRESS/SUCCEEDED/FAILED


注意:此字段可能返回 null,表示取不到有效值。
示例值:SUCCEEDED
Input String 否

工具调用Input(已递归脱敏,JSON 字符串)


注意:此字段可能返回 null,表示取不到有效值。
示例值:{"command":"ls -1 /workspace/2102239219915046912 | wc -l","description":"统计当前目录文件数量"}
Output String 否

工具调用Output(已递归脱敏,JSON 字符串)


注意:此字段可能返回 null,表示取不到有效值。
示例值:{"text":"Command: ls -1 /workspace/2102239219915046912 | wc -l\nStdout: 0\n\nStderr: (empty)\nExit Code: 0\nSignal: (none)","type":"text"}
EndedAt String 否

结束时间


注意:此字段可能返回 null,表示取不到有效值。
示例值:2026-09-22T03:31:10Z
DurationMs Integer 否

耗时毫秒


注意:此字段可能返回 null,表示取不到有效值。
示例值:100
StartedAt String 否

调用开始时间(RFC3339 格式)


注意:此字段可能返回 null,表示取不到有效值。
示例值:2026-09-22T03:31:10Z
ExpertId String 否 本次调用对应的业务专家 ID。
示例值:ex_example
ExpertName String 否 本次调用对应的专家名称。
示例值:代码审查专家
ExpertVersion String 否 执行时解析到的专家资源版本。
示例值:v1
SubAgentId String 否 CBC 子代理执行实例 ID,可用于查询该次专家调用的消息事件。
示例值:agent-example
SubAgentName String 否 CBC 子代理定义名称。
示例值:code-reviewer
ParentToolCallId String 否 父会话中触发本次子代理执行的工具调用 ID。
示例值:call_example

RoutingItem

路由项

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

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

ScheduledTaskLogStats

定时任务执行聚合统计

被如下接口引用:DescribeScheduledTaskLogList。

名称 类型 必选 描述
TotalCount Integer 否

总执行次数


注意:此字段可能返回 null,表示取不到有效值。
示例值:1
SuccessCount Integer 否

成功次数


注意:此字段可能返回 null,表示取不到有效值。
示例值:0
FailedCount Integer 否

失败次数


注意:此字段可能返回 null,表示取不到有效值。
示例值:0
AvgDurationMs Integer 否

平均执行时长(毫秒)


注意:此字段可能返回 null,表示取不到有效值。
示例值:0

ScheduledTaskLogSummary

定时任务执行日志列表项

被如下接口引用:DescribeScheduledTaskLogList。

名称 类型 必选 描述
LogId String 否

执行日志 ID


注意:此字段可能返回 null,表示取不到有效值。
示例值:2114705928236544000
TaskKey String 否

任务唯一标识


注意:此字段可能返回 null,表示取不到有效值。
示例值:d473a076-7d74-4d39-9f93-6ff0e7a4dc1a
TriggerType String 否

触发类型:MANUAL(手动)/ CRON(定时)


注意:此字段可能返回 null,表示取不到有效值。
示例值:MANUAL
Status String 否

执行状态


注意:此字段可能返回 null,表示取不到有效值。
示例值:RUNNING
StartTime String 否

开始时间


注意:此字段可能返回 null,表示取不到有效值。
示例值:2026-10-26T21:09:17+08:00
EndTime String 否

结束时间


注意:此字段可能返回 null,表示取不到有效值。
示例值:2026-10-27T15:05:39+08:00
DurationMs Integer 否

执行时长(毫秒)


注意:此字段可能返回 null,表示取不到有效值。
示例值:34741
DeliveryStatus String 否

投递状态


注意:此字段可能返回 null,表示取不到有效值。
示例值:SKIPPED
SessionId String 否

关联会话 ID


注意:此字段可能返回 null,表示取不到有效值。
示例值:2114705929132331008
ErrorMessage String 否

失败原因


注意:此字段可能返回 null,表示取不到有效值。
示例值:skipped: task not found at dispatch time
SessionName String 否

会话名称(AgentOS 侧生成的 AI 标题 / 用户改名);缺失时为空,调用方可兜底展示 SessionId 后缀


注意:此字段可能返回 null,表示取不到有效值。
示例值:automation-2114703867875184640-2114705928236544000
Result String 否

执行结果预览(前 50 字符),仅用于列表页展示;完整结果请调用 DescribeScheduledTaskLog


注意:此字段可能返回 null,表示取不到有效值。
示例值:{"sessionId": "2114705929132331008"}

ScheduledTaskSummary

定时任务列表项

被如下接口引用:DescribeScheduledTaskList。

名称 类型 必选 描述
TaskId String 否

任务 ID


注意:此字段可能返回 null,表示取不到有效值。
示例值:2114706665523884032
TaskKey String 否

任务唯一标识


注意:此字段可能返回 null,表示取不到有效值。
示例值:038a93de-b092-4ae7-8278-5f78331f3941
TaskName String 否

任务名称


注意:此字段可能返回 null,表示取不到有效值。
示例值:测试任务
AgentId String 否

关联 Agent ID


注意:此字段可能返回 null,表示取不到有效值。
示例值:01M5W4SQM878XNW9CW0065EJH0
CronExpr String 否

Cron 表达式


注意:此字段可能返回 null,表示取不到有效值。
示例值:0 00 09 * * *
Status String 否

任务状态:ACTIVE(启用)/ PAUSED(暂停)/ DISABLED(停用)


注意:此字段可能返回 null,表示取不到有效值。
示例值:ACTIVE
LastRunTime String 否

最近执行时间


注意:此字段可能返回 null,表示取不到有效值。
示例值:2026-10-26T23:55:13+08:00
NextRunTime String 否

下次执行时间


注意:此字段可能返回 null,表示取不到有效值。
示例值:2026-10-27T09:02:52+08:00
CreatedTime String 否

创建时间


注意:此字段可能返回 null,表示取不到有效值。
示例值:2026-10-26T21:12:13+08:00
AgentConfig AgentConfig 否

任务 Agent 配置(Prompt/Model/AgentId)


注意:此字段可能返回 null,表示取不到有效值。

SessionItem

会话列表项

被如下接口引用:DescribeAgentSessionList。

名称 类型 必选 描述
SessionId String 否 会话 ID
注意:此字段可能返回 null,表示取不到有效值。
示例值:sess_a1b2c3d4
SessionName String 否 会话名称(AI 生成标题或用户改名;缺失时为空)
注意:此字段可能返回 null,表示取不到有效值。
示例值:每日日报
AgentId String 否 Agent 业务 ID
注意:此字段可能返回 null,表示取不到有效值。
示例值:736918300000000001
AgentName String 否 Agent 名称
注意:此字段可能返回 null,表示取不到有效值。
示例值:数据分析助手
VersionName String 否 会话使用的版本名称(与 VersionId 区分:此为版本名,非 ID;原 AgentVersion)
注意:此字段可能返回 null,表示取不到有效值。
示例值:v12
VersionId String 否 会话使用的 Agent 版本 ID
注意:此字段可能返回 null,表示取不到有效值。
示例值:v12
Status String 否 会话状态
注意:此字段可能返回 null,表示取不到有效值。
示例值:COMPLETED
Creator String 否 创建者 Uin
注意:此字段可能返回 null,表示取不到有效值。
示例值:100012345678
Source String 否 会话来源
注意:此字段可能返回 null,表示取不到有效值。
示例值:WEB
CreatedTime String 否 创建时间(RFC3339)
注意:此字段可能返回 null,表示取不到有效值。
示例值:2026-09-18 10:00:00
ModifiedTime String 否 更新时间(RFC3339)
注意:此字段可能返回 null,表示取不到有效值。
示例值:2026-09-18 10:30:00

SkillCounts

全局技能计数

被如下接口引用:DescribeSkillList。

名称 类型 必选 描述
Builtin Integer 否 内置技能数
注意:此字段可能返回 null,表示取不到有效值。
示例值:8
Custom Integer 否 自建技能数
注意:此字段可能返回 null,表示取不到有效值。
示例值:5
Total Integer 否 总数
注意:此字段可能返回 null,表示取不到有效值。
示例值:13

SkillItem

Skill 列表项(按列表页展示裁剪:名称/版本/描述/状态/操作五列 + 编排所需的 Source 与 DownloadUrl)

被如下接口引用:DescribeSkillList。

名称 类型 必选 描述
Source String 否 技能来源:BUILTIN(内置)/ CUSTOM(自建)/ AUTHORIZED(企业授权)
示例值:authorized
Name String 否

slug(仅 custom 返回)


示例值:tst
DisplayName String 否

展示名


示例值:t
Description String 否

描述


示例值:t
Icon String 否

图标 URL


示例值:t
Enabled Boolean 否

是否启用


示例值:true
DownloadUrl String 否

下载 URL


示例值:d
SkillId String 否

技能标识


示例值:skill-7f8g9h
SkillVersion String 否

当前生效版本号


注意:此字段可能返回 null,表示取不到有效值。
示例值:v1.2.0
CreateTime String 否 创建时间,RFC3339 UTC 格式(如 2026-08-11T09:23:10Z)
示例值:2026-08-11T09:23:10Z
UpdateTime String 否 更新时间,RFC3339 UTC 格式(如 2026-09-15T06:51:26Z)
示例值:2026-09-15T06:51:26Z

TargetOptions

投递目标配置,按 Type 选用不同字段组

被如下接口引用:CreateScheduledTask, DescribeScheduledTask, ModifyScheduledTask。

名称 类型 必选 描述
ChannelType String 否

渠道类型(BOT_CHANNEL 必填):FEISHU / DINGTALK / QQ / WECOM_NEW / WECOM_AIBOT / WECHAT_KF


注意:此字段可能返回 null,表示取不到有效值。
示例值:QQ
ChannelId String 否

渠道标识(BOT_CHANNEL 必填):飞书 appId / 钉钉 appKey / QQ appId / 企微 corpId:agentId


注意:此字段可能返回 null,表示取不到有效值。
示例值:1905657364
Url String 否

回调 URL(WEBHOOK 必填):仅允许 http/https,禁止内网地址(SSRF 防护)


注意:此字段可能返回 null,表示取不到有效值。
示例值:https://webhook.site/2caa360b-be93-4367-b5b8-a455cb594c90
Headers Array of Header 否

自定义请求头列表,与默认 Content-Type: application/json 合并


注意:此字段可能返回 null,表示取不到有效值。
Secret String 否

HMAC-SHA256 签名密钥(WEBHOOK 可选)


注意:此字段可能返回 null,表示取不到有效值。
示例值:secret
RecipientIdSet Array of String 否

接收目标 ID 集合(群 ID / 用户 ID / 频道 ID),BOT_CHANNEL 模式必填,至少一个


注意:此字段可能返回 null,表示取不到有效值。
示例值:["4D1D111309B0E0FBC945B4C9C03502F6"]

TokenUsage

Token用量

被如下接口引用:DescribeMessageEventList。

名称 类型 必选 描述
InputTokens Integer 否

输入Token


注意:此字段可能返回 null,表示取不到有效值。
示例值:19143
OutputTokens Integer 否

输出Token


注意:此字段可能返回 null,表示取不到有效值。
示例值:42
TotalTokens Integer 否

总Token


注意:此字段可能返回 null,表示取不到有效值。
示例值:19185
Scope String 否

统计口径


注意:此字段可能返回 null,表示取不到有效值。
示例值:TURN