AICallConfig
智能通话配置
被如下接口引用：ModifyApp。
| 名称 | 类型 | 必选 | 描述 |
|---|---|---|---|
| DigitalHuman | DigitalHumanConfig | 是 | 数智人配置 注意：此字段可能返回 null，表示取不到有效值。 |
| EnableDigitalHuman | Boolean | 是 | 启用数智人 示例值：false |
| EnableVoiceCall | Boolean | 是 | 启用语音通话 示例值：false |
| EnableVoiceInteract | Boolean | 是 | 启用语音互动功能 示例值：false |
| Voice | VoiceConfig | 是 | 音色配置 注意：此字段可能返回 null，表示取不到有效值。 |
AIOptimizeModel
AI一键优化模型配置
被如下接口引用：ModifyApp。
| 名称 | 类型 | 必选 | 描述 |
|---|---|---|---|
| Model | ModelDetailInfo | 是 | 模型配置 注意：此字段可能返回 null，表示取不到有效值。 |
AgentAdvancedConfig
Agent高级设置
被如下接口引用：CreateAgent, DescribeAgentDetail, ModifyAgent。
| 名称 | 类型 | 必选 | 描述 |
|---|---|---|---|
| MaxReasoningRound | Integer | 否 | 最大推理轮数 示例值：30 |
AgentCollaborationConfig
[数据结构定义] Agent协同配置
被如下接口引用：ModifyApp。
| 名称 | 类型 | 必选 | 描述 |
|---|---|---|---|
| AgentCollaborationMode | Integer | 是 | 协同方式。枚举值: 1:自由转交：Agent之间可自由传递任务, 2:工作流编排：基于预定义流程的协同, 3:Plan-and-Execute：规划与执行分离的协同模式 示例值：0 |
| WorkflowId | String | 是 | 工作流Id 示例值：dd***das |
| WorkflowName | String | 是 | 工作流名称 示例值：我的工作流 |
AgentDetail
Agent 详情
被如下接口引用：DescribeAgentDetail。
| 名称 | 类型 | 描述 |
|---|---|---|
| AgentId | String | Agent ID 示例值：ab1b010c-edd9-4542-9f44-0a510d9377e1 |
| Profile | AgentProfile | Agent基本配置 |
| Instructions | String | 系统提示词 示例值：你是一个clawAgent |
| Model | AgentModelConfig | 模型信息 |
| ToolList | Array of AgentTool | 工具详情 |
| PluginList | Array of AgentPlugin | 插件配置 |
| SkillList | Array of AgentSkill | 技能详情 |
| AdvancedConfig | AgentAdvancedConfig | 高级配置 |
AgentInput
Agent输入值，支持直接赋值和引用
被如下接口引用：CreateAgent, DescribeAgentDetail, ModifyAgent。
| 名称 | 类型 | 必选 | 描述 |
|---|---|---|---|
| InputType | Integer | 否 | 输入来源类型：0 用户输入，3 自定义变量（API参数） 示例值：2 |
| UserInputValue | AgentUserInputValue | 否 | 用户手写输入 注意：此字段可能返回 null，表示取不到有效值。 |
| SystemVariable | AgentSystemVariable | 否 | 系统参数 注意：此字段可能返回 null，表示取不到有效值。 |
| CustomVariableId | String | 否 | 自定义变量（API参数） 示例值：1de4f872-7c73-42e3-9cf0-e33c7e73a271 |
| EnvVariableId | String | 否 | 环境变量参数 示例值：1de4f872-7c73-42e3-9cf0-e33c7e73a271 |
| AppVariableId | String | 否 | 应用变量参数 示例值：3ffe01e2-a102-4503-8170-35ac103d8780 |
AgentModelConfig
Agent 配置里面的模型定义
被如下接口引用：CreateAgent, DescribeAgentDetail, ModifyAgent。
| 名称 | 类型 | 必选 | 描述 |
|---|---|---|---|
| ModelId | String | 否 | 模型唯一id 示例值：TCADP/gpt-5.5 |
| Alias | String | 否 | 模型别名 示例值：GPT-5.5 |
| ContextWordsLimit | Integer | 否 | 模型上下文长度字符限制 示例值：0 |
| InstructionsWordsLimit | Integer | 否 | 指令长度字符限制 示例值：20000 |
| ModelParameters | ModelParams | 否 | 模型参数 |
AgentPlugin
Agent 的插件信息
被如下接口引用：DescribeAgentDetail。
| 名称 | 类型 | 描述 |
|---|---|---|
| Config | AgentPluginConfig | 插件基本配置 |
| Name | String | 插件名称 示例值：图片生成（极速版） |
| IconUrl | String | 插件图标url 示例值：https://qidian-qbot-1251316161.cos.ap-guangzhou.myqcloud.com/public/plugin_files/03bigIcon%E5%A4%A7%E5%9B%BE%E6%A0%87%20%282%29.png |
| Description | String | 插件描述 示例值：基于混元大模型，可以根据用户输入的文本query，自动创作不同风格的图片（极速版） |
| PluginClass | Integer | 插件产品分类 枚举值：
示例值：0 |
| Status | Integer | 插件状态 枚举值：
示例值：1 |
| AuthConfigStatus | Integer | 插件鉴权配置状态 枚举值：
示例值：2 |
AgentPluginConfig
Agent 的插件基本配置
被如下接口引用：CreateAgent, DescribeAgentDetail, ModifyAgent。
| 名称 | 类型 | 必选 | 描述 |
|---|---|---|---|
| PluginId | String | 否 | 插件id 示例值：bf8ad2f3-1e5c-410a-ae81-abd7c5c14f1c |
| HeaderParameterList | Array of AgentPluginParameter | 否 | 插件 Header 参数 |
| QueryParameterList | Array of AgentPluginParameter | 否 | 插件 Query 参数 |
| EnableCamRoleAuth | Boolean | 否 | 是否使用CAM一键授权，仅 auth_type=2时生效 示例值：true |
| AuthType | Integer | 否 | 授权类型 枚举值：
示例值：2 |
| OAuthConsent | Integer | 否 | OAuth 授权同意模式；0-开发者授权；1-使用者授权（仅在auth_type=3时生效） 示例值：0 |
AgentPluginParameter
Agent 插件参数配置
被如下接口引用：CreateAgent, DescribeAgentDetail, ModifyAgent。
| 名称 | 类型 | 必选 | 描述 |
|---|---|---|---|
| Name | String | 否 | 参数名称 示例值：SECRET_ID |
| IsRequired | Boolean | 否 | 是否必填 示例值：true |
| Input | AgentInput | 否 | 输入的值 |
AgentProfile
Agent 基本配置
被如下接口引用：CreateAgent, DescribeAgentDetail, ModifyAgent。
| 名称 | 类型 | 必选 | 描述 |
|---|---|---|---|
| Name | String | 否 | Agent名称 示例值：h*claw |
| IconUrl | String | 否 | 图标URL 示例值：https://cdn.xiaowei.qq.com/static/lke/agent-robot.png |
AgentRelease
Agent发布项目详情
被如下接口引用：DescribeAgentReleasePreviewList。
| 名称 | 类型 | 描述 |
|---|---|---|
| ItemName | String | 名称 示例值：基础配置 |
| UpdateTime | String | 更新时间, unix 秒时间戳 (s) 示例值：1776838008 |
| ActionDescription | String | 动作描述 示例值：新增 |
| ReleaseMessage | String | 变更为 测试 示例值：新增基础配置 |
AgentReleasePreview
Agent 发布预览信息
被如下接口引用：DescribeAgentReleasePreviewList。
| 名称 | 类型 | 描述 |
|---|---|---|
| AgentId | String | AgentID 示例值：e25e9a2b-**-f6f869e7cfb9 |
| Name | String | Agent名称 示例值：*_test |
| UpdateTime | String | 更新时间, unix 秒时间戳 (s) 示例值：1776838008 |
| Action | Integer | 状态, 状态值：1:新增, 2:修改, 3:删除 示例值：1 |
| ActionDescription | String | 动作描述 示例值：新增 |
| Message | String | 发布消息 示例值：待发布变更 5 项 |
| ReleaseList | Array of AgentRelease | 发布详情 |
AgentSkill
Agent 技能详情
被如下接口引用：DescribeAgentDetail。
| 名称 | 类型 | 描述 |
|---|---|---|
| SkillId | String | skillId 示例值：dd405ecb-***f3df021bc97d |
| Name | String | skill名称 示例值：adp-skill-manager |
| Description | String | 技能描述 示例值：管理 ADP 技能广场技能 |
| DisplayName | String | skill展示名称 示例值：ADP技能管理 |
| DisplayDescription | String | 技能展示描述 示例值：管理和发现技能 |
| IconUrl | String | skill图标url 示例值：https://qidian-****************************guangzhou.myqcloud.com/public/adp/skill/skill_icon/Excel-XLSX.png |
| SourceType | Integer | Skill来源 示例值：1 |
| CurrentVersion | String | Skill版本 示例值：1.0.0 |
AgentSkillConfig
Agent 技能入参
被如下接口引用：CreateAgent, ModifyAgent。
| 名称 | 类型 | 必选 | 描述 |
|---|---|---|---|
| SkillId | String | 否 | 技能ID 示例值：dd405ecb-232f-4344-bc3f-f3df021bc97d |
AgentSpec
Agent 可编辑配置
被如下接口引用：CreateAgent, ModifyAgent。
| 名称 | 类型 | 必选 | 描述 |
|---|---|---|---|
| Profile | AgentProfile | 否 | Agent基本配置 |
| Instructions | String | 否 | 系统提示词 示例值：你是一个ai助手 |
| Model | AgentModelConfig | 否 | 主模型配置 |
| ToolList | Array of AgentToolConfig | 否 | 工具信息 |
| PluginList | Array of AgentPluginConfig | 否 | 插件信息 |
| SkillList | Array of AgentSkillConfig | 否 | 技能信息 |
| AdvancedConfig | AgentAdvancedConfig | 否 | 高级设置 |
AgentSystemVariable
系统参数
被如下接口引用：CreateAgent, DescribeAgentDetail, ModifyAgent。
| 名称 | 类型 | 必选 | 描述 |
|---|---|---|---|
| Name | String | 否 | 系统参数名 示例值：SYS.UserQuery |
| DialogHistoryLimit | Integer | 否 | 对话历史轮数的配置；如果Input是系统变量中的“对话历史”时才使用； 示例值：0 |
AgentTool
Agent 工具详情
被如下接口引用：DescribeAgentDetail。
| 名称 | 类型 | 描述 |
|---|---|---|
| Config | AgentToolBasicConfig | 工具配置字段 |
| Name | String | 工具名称 示例值：get_change_records |
| Status | Integer | 工具状态 枚举值：
示例值：1 |
| StreamMode | Integer | 调用方式 枚举值：
示例值：0 |
| ToolAccessMode | Integer | 工具访问模式 枚举值：
示例值：0 |
AgentToolBasicConfig
Agent的工具基础配置
被如下接口引用：CreateAgent, DescribeAgentDetail, ModifyAgent。
| 名称 | 类型 | 必选 | 描述 |
|---|---|---|---|
| PluginId | String | 否 | 插件id 示例值：61a2635f-62f8-4e44-94fd-38cf07a9cc71 |
| ToolId | String | 否 | 工具id 示例值：6f7a8b9c-0d1e-4f2a-3456-789abcdef01a |
| Description | String | 否 | 描述 示例值：查询企业作为被执行人的案件信息，包括执行标的、立案时间、执行法院，适用于企业债务执行情况了解、强制执行风险判断。 |
| InputList | Array of AgentToolInputParameter | 否 | 工具输入参数列表 注意：此字段可能返回 null，表示取不到有效值。 |
| OutputList | Array of AgentToolOutputParameter | 否 | 工具输出参数列表 注意：此字段可能返回 null，表示取不到有效值。 |
| HeaderParameterList | Array of AgentPluginParameter | 否 | 工具Header参数列表 注意：此字段可能返回 null，表示取不到有效值。 |
| QueryParameterList | Array of AgentPluginParameter | 否 | 工具Query参数列表 注意：此字段可能返回 null，表示取不到有效值。 |
| ToolSource | Integer | 否 | 工具来源: 0-来自插件，1-来自工作流 示例值：0 |
| IsDisabled | Boolean | 否 | 是否禁用 示例值：false |
AgentToolConfig
Agent 工具入参
被如下接口引用：CreateAgent, ModifyAgent。
| 名称 | 类型 | 必选 | 描述 |
|---|---|---|---|
| Config | AgentToolBasicConfig | 否 | 工具配置 |
AgentToolInputParameter
Agent 工具输入参数定义
被如下接口引用：CreateAgent, DescribeAgentDetail, ModifyAgent。
| 名称 | 类型 | 必选 | 描述 |
|---|---|---|---|
| Name | String | 否 | 工具名称 示例值：Query |
| Description | String | 否 | 工具描述 示例值：模型 |
| Type | Integer | 否 | 工具参数类型 枚举值：
示例值：9 |
| IsRequired | Boolean | 否 | 是否必填 示例值：true |
| SubParameterList | Array of AgentToolInputParameter | 否 | 子参数，仅 OBJECT 或 ARRAY<> 类型时使用 注意：此字段可能返回 null，表示取不到有效值。 |
| IsHidden | Boolean | 否 | 模式下是否对模型隐藏 示例值：true |
| OneOfList | Array of AgentToolInputParameter | 否 | OneOf类型的参数 注意：此字段可能返回 null，表示取不到有效值。 |
| AnyOfList | Array of AgentToolInputParameter | 否 | AnyOf类型的参数 注意：此字段可能返回 null，表示取不到有效值。 |
| Input | AgentInput | 否 | 参数取值来源 注意：此字段可能返回 null，表示取不到有效值。 |
AgentToolOutputParameter
Agent 工具输出参数
被如下接口引用：CreateAgent, DescribeAgentDetail, ModifyAgent。
| 名称 | 类型 | 必选 | 描述 |
|---|---|---|---|
| Name | String | 否 | 参数名称 示例值：References |
| Description | String | 否 | 变量描述 示例值：返回数据。Code为0：{}，Code非0：RetrievalAnswer |
| Type | Integer | 否 | 参数类型 枚举值：
示例值：1 |
| SubParameterList | Array of AgentToolOutputParameter | 否 | 子参数，仅 OBJECT 或 ARRAY_OBJECT 类型时使用 |
| RenderMode | Integer | 否 | 解析方式 示例值：0 |
AgentUserInputValue
用户输入值
被如下接口引用：CreateAgent, DescribeAgentDetail, ModifyAgent。
| 名称 | 类型 | 必选 | 描述 |
|---|---|---|---|
| ValueList | Array of String | 否 | 用户输入参数值 示例值：["0.1"] |
ApiToolConfig
ApiToolConfig
被如下接口引用：DescribePlugin。
| 名称 | 类型 | 必选 | 描述 |
|---|---|---|---|
| ExternalApiUrl | String | 否 | API插件支持对外调用的工具URL 示例值：https://adp.cloud.tencent.com/plugin/api/v1/fd215e08-ccb7-4968-8123-d5ccbdf440d3/2a35fdd4-fc6c-4c10-a65e-c4dc5e682d3a |
| Method | String | 否 | 请求method 示例值：POST |
| Url | String | 否 | 请求的url 示例值：http://xx.com/api |
| Body | Array of RequestParam | 否 | body参数 |
| Example | ToolExample | 否 | 示例 |
| Header | Array of RequestParam | 否 | Header信息 |
| Outputs | Array of ResponseParam | 否 | 输出参数 |
| Query | Array of RequestParam | 否 | query参数 |
| StreamMode | Integer | 否 | 流式模式 枚举值: | uint | 描述 | | --- | --- | | 0 | 非流式 | | 1 | 流式 | 示例值：0 |
App
App 应用完整信息
被如下接口引用：DescribeApp。
| 名称 | 类型 | 必选 | 描述 |
|---|---|---|---|
| AuxiliaryInfo | AppAuxiliaryInfo | 是 | 辅助信息(子状态/审批/申诉/搜索资源/特殊状态等) 注意：此字段可能返回 null，表示取不到有效值。 |
| Config | AppConfig | 是 | 配置 注意：此字段可能返回 null，表示取不到有效值。 |
| Metadata | AppMetadata | 是 | 元数据 注意：此字段可能返回 null，表示取不到有效值。 |
| SecretInfo | AppSecretInfo | 是 | 应用密钥信息 注意：此字段可能返回 null，表示取不到有效值。 |
| ShareUrlInfo | AppShareURLInfo | 是 | 分享链接信息(含访问控制) 注意：此字段可能返回 null，表示取不到有效值。 |
| Status | AppStatusInfo | 是 | 状态 注意：此字段可能返回 null，表示取不到有效值。 |
| SharedKnowledgeList | Array of AppSharedKnowledgeInfo | 否 | 应用引用的共享知识库列表 |
AppAdvancedConf
应用高级配置
被如下接口引用：ModifyApp。
| 名称 | 类型 | 必选 | 描述 |
|---|---|---|---|
| EnableContextRewrite | Boolean | 是 | 是否开启上下文改写 示例值：false |
| EnableImageTextRetrieval | Boolean | 是 | 是否开启图文检索 示例值：false |
| ReplyFlexibility | Integer | 是 | 回复灵活度 示例值：1 |
| IntentAchievement | Array of IntentAchievementInfo | 否 | 意图达成优先级 |
AppAppeal
应用申诉信息(用户不可修改)
被如下接口引用：DescribeApp。
| 名称 | 类型 | 必选 | 描述 |
|---|---|---|---|
| AppealingStatus | AppealingStatus | 是 | 申诉中的配置项 注意：此字段可能返回 null，表示取不到有效值。 |
AppAuxiliaryInfo
应用辅助信息 - 包含各类辅助状态和扩展信息(用户不可修改)
被如下接口引用：DescribeApp。
| 名称 | 类型 | 必选 | 描述 |
|---|---|---|---|
| Appeal | AppAppeal | 是 | 申诉信息 注意：此字段可能返回 null，表示取不到有效值。 |
| SearchResourceStatus | SearchResourceStatusInfo | 是 | 搜索资源状态 注意：此字段可能返回 null，表示取不到有效值。 |
| SpecialStatusInfo | SpecialStatusInfo | 是 | 特殊状态信息 注意：此字段可能返回 null，表示取不到有效值。 |
| SubStatus | AppSubStatusInfo | 是 | 子状态信息 注意：此字段可能返回 null，表示取不到有效值。 |
| TemplatePublish | TemplatePublishInfo | 是 | 模版中心同步信息(私有化独有) 注意：此字段可能返回 null，表示取不到有效值。 |
AppConfig
应用配置 - 用户可修改的所有配置
被如下接口引用：DescribeApp, ModifyApp。
| 名称 | 类型 | 必选 | 描述 |
|---|---|---|---|
| Experience | AppExperienceConfig | 是 | 体验配置 注意：此字段可能返回 null，表示取不到有效值。 |
| Greeting | AppGreetingConfig | 是 | 欢迎语配置 注意：此字段可能返回 null，表示取不到有效值。 |
| Memory | AppMemoryConfig | 是 | 记忆配置 注意：此字段可能返回 null，表示取不到有效值。 |
| Mode | AppModeConfig | 是 | 模式相关配置 注意：此字段可能返回 null，表示取不到有效值。 |
| Model | AppModelConfig | 是 | 模型配置 注意：此字段可能返回 null，表示取不到有效值。 |
| WebSearch | AppWebSearchConfig | 是 | 联网搜索配置 注意：此字段可能返回 null，表示取不到有效值。 |
| Workflow | AppWorkflowConfig | 是 | 工作流配置 注意：此字段可能返回 null，表示取不到有效值。 |
AppExperienceConfig
体验配置
被如下接口引用：ModifyApp。
| 名称 | 类型 | 必选 | 描述 |
|---|---|---|---|
| Advanced | AppAdvancedConf | 是 | 高级配置 注意：此字段可能返回 null，表示取不到有效值。 |
| Conversation | ConversationExperience | 是 | 对话体验配置 注意：此字段可能返回 null，表示取不到有效值。 |
| Role | RoleConfig | 是 | 角色配置 注意：此字段可能返回 null，表示取不到有效值。 |
AppGreetingConfig
欢迎语配置
被如下接口引用：ModifyApp。
| 名称 | 类型 | 必选 | 描述 |
|---|---|---|---|
| Greeting | String | 是 | 欢迎语内容 示例值：你好欢迎语 |
| OpeningQuestionList | Array of String | 否 | 开场问题列表 示例值：["我的示例问题"] |
AppMemoryConfig
记忆配置
被如下接口引用：ModifyApp。
| 名称 | 类型 | 必选 | 描述 |
|---|---|---|---|
| Enabled | Boolean | 是 | 是否开启长记忆 示例值：false |
| LongMemoryDay | Integer | 是 | 长记忆时长 示例值：30 |
| Model | ModelDetailInfo | 是 | 模型配置 注意：此字段可能返回 null，表示取不到有效值。 |
| PromptContent | String | 是 | prompt内容 示例值：prompt信息 |
| PromptMode | Integer | 是 | 提示词模式。枚举值: 1:自定义 示例值：0 |
AppMetadata
应用元数据 - 基础标识和描述信息
被如下接口引用：DescribeApp。
| 名称 | 类型 | 必选 | 描述 |
|---|---|---|---|
| AppId | String | 是 | 应用ID 示例值：206****5184 |
| AppMode | Integer | 是 | 应用模式。枚举值: 1:标准模式, 2:Agent模式, 3:单工作流模式, 4:ClawAgent模式 示例值：1 |
| Avatar | String | 是 | 应用头像 示例值：https://qidian-qbot-test-1251316161.cos.ap-guangzhou.myqcl**********************************************************ge/NrjBSfeRqMuNJalcGcNA-1981186399502619328.png |
| CreateTime | String | 是 | 创建时间 (Unix时间戳,秒级) 示例值：1780044175 |
| Description | String | 是 | 应用描述 示例值：我的描述 |
| Name | String | 是 | 应用名称 示例值：我的智能体应用03 |
| SpaceId | String | 是 | 空间ID 示例值：default_space |
| UpdateTime | String | 是 | 更新时间 (Unix时间戳,秒级) 示例值：1780384282 |
AppModeConfig
模式配置 - 包含不同模式的独有配置
被如下接口引用：ModifyApp。
| 名称 | 类型 | 必选 | 描述 |
|---|---|---|---|
| MultiAgentConfig | MultiAgentConfig | 是 | 多智能体配置(Agent模式) 注意：此字段可能返回 null，表示取不到有效值。 |
| SingleWorkflowConfig | SingleWorkflowConfig | 是 | 单工作流配置(单工作流模式) 注意：此字段可能返回 null，表示取不到有效值。 |
AppModelConfig
模型配置
被如下接口引用：ModifyApp。
| 名称 | 类型 | 必选 | 描述 |
|---|---|---|---|
| AiOptimizeModel | AIOptimizeModel | 是 | AI一键优化模型 注意：此字段可能返回 null，表示取不到有效值。 |
| FileParseModel | FileParseModel | 是 | 实时文件解析模型 注意：此字段可能返回 null，表示取不到有效值。 |
| GenerateModel | GenerateModel | 是 | 生成模型配置 注意：此字段可能返回 null，表示取不到有效值。 |
| MultiModalQaModel | MultiModalQAModel | 是 | 多模态问答模型 注意：此字段可能返回 null，表示取不到有效值。 |
| MultiModalUnderstandingModel | MultiModalUnderstandingModel | 是 | 多模态理解模型 注意：此字段可能返回 null，表示取不到有效值。 |
| PromptRewriteModel | PromptRewriteModel | 是 | Prompt改写模型 注意：此字段可能返回 null，表示取不到有效值。 |
| ThinkModel | ThinkModel | 是 | 思考模型配置 注意：此字段可能返回 null，表示取不到有效值。 |
AppOperation
应用操作信息
被如下接口引用：DescribeAppSummaryList。
| 名称 | 类型 | 必选 | 描述 |
|---|---|---|---|
| Creator | String | 是 | 创建人 示例值：user |
| CreatorUin | String | 是 | 创建人UIN 示例值：117890 |
| CreatorUserAccount | String | 是 | 创建人账号(私有化场景使用) 示例值：创建人 |
| UpdateTime | String | 是 | 修改时间 (Unix时间戳,秒级) 示例值：112345678965 |
| Updater | String | 是 | 最后修改人 示例值：Updater |
| UpdaterUin | String | 是 | 修改人UIN 示例值：117890 |
AppSecretInfo
应用密钥信息
被如下接口引用：DescribeApp。
| 名称 | 类型 | 必选 | 描述 |
|---|---|---|---|
| AppKey | String | 是 | 应用密钥 示例值：cw**nptQWMSAtFeD |
| CreateTime | String | 是 | 创建时间 示例值：1780044174 |
AppShareAccessControl
应用分享访问控制配置
被如下接口引用：DescribeApp, ModifyApp。
| 名称 | 类型 | 必选 | 描述 |
|---|---|---|---|
| AccessType | Integer | 是 | 访问控制类型。枚举值: 1:公开访问(所有用户都可访问), 2:内部访问(仅企业用户可访问), 3:账号白名单(指定UIN/手机/邮箱/IP可访问) 示例值：3 |
| Enabled | Boolean | 是 | 体验链接开关 示例值：true |
| Whitelist | Array of AppShareWhitelistItem | 否 | 白名单(仅 access_type=ACCOUNT_WHITELIST 时生效) |
AppShareURLInfo
分享链接信息(详情查询返回，用户不可修改部分；access_control 用户可修改部分由 ModifyApp 承载)
被如下接口引用：DescribeApp。
| 名称 | 类型 | 必选 | 描述 |
|---|---|---|---|
| AccessControl | AppShareAccessControl | 是 | 当前生效的访问控制配置 注意：此字段可能返回 null，表示取不到有效值。 |
| ShareUrl | String | 是 | 分享URL 示例值：https://tde.xiaowei.c****.tencen* |
AppShareWhitelistItem
应用分享白名单项
被如下接口引用：ModifyApp。
| 名称 | 类型 | 必选 | 描述 |
|---|---|---|---|
| Type | Integer | 是 | 白名单类型。枚举值: 1:UIN账号, 2:手机号码, 3:邮箱地址, 4:IP地址 示例值：1 |
| Values | Array of String | 否 | 白名单值列表(UIN/手机号/邮箱/IP等) 示例值：["70000000"] |
AppSharedKnowledgeInfo
应用引用的共享知识库简要信息(查询时仅返回ID和名称)
被如下接口引用：DescribeApp。
| 名称 | 类型 | 必选 | 描述 |
|---|---|---|---|
| KnowledgeId | String | 是 | 共享知识库ID 示例值：204*376 |
| KnowledgeName | String | 是 | 共享知识库名称 示例值：*0423 |
AppStatusInfo
应用状态信息 - 运行时状态信息(用户不可修改)
被如下接口引用：DescribeApp, DescribeAppSummaryList。
| 名称 | 类型 | 必选 | 描述 |
|---|---|---|---|
| Status | Integer | 是 | 应用状态 (OFFLINE:未上线, RUNNING:运行中, DISABLED:停用)。枚举值: 1:未上线, 2:运行中, 3:停用 示例值：2 |
| StatusDescription | String | 是 | 状态描述 示例值：运行中 |
AppSubStatusInfo
应用子状态信息
被如下接口引用：DescribeApp, DescribeAppSummaryList。
| 名称 | 类型 | 必选 | 描述 |
|---|---|---|---|
| ApprovalId | String | 是 | 审批记录ID (当sub_status_list包含PUBLISH_APPROVING时有效) 示例值：0 |
| SubStatusList | Array of Integer | 否 | 应用子状态列表 (可能同时处于多个子状态) 示例值：[1] |
AppSummary
应用摘要 - 列表查询返回的应用信息
被如下接口引用：DescribeAppSummaryList。
| 名称 | 类型 | 必选 | 描述 |
|---|---|---|---|
| AppId | String | 是 | 应用ID 示例值：2060*20 |
| AppMode | Integer | 是 | 应用模式。枚举值: 1:标准模式, 2:Agent模式, 3:单工作流模式, 4:ClawAgent模式 示例值：2 |
| Avatar | String | 是 | 应用头像 示例值：https://cdn.xiaowei.qq.com/static/adp/app-default-avatar.png |
| Name | String | 是 | 应用名称 示例值：测试的应用信息 |
| OperationInfo | AppOperation | 是 | 操作信息 注意：此字段可能返回 null，表示取不到有效值。 |
| Status | AppStatusInfo | 是 | 状态信息 注意：此字段可能返回 null，表示取不到有效值。 |
| SubStatus | AppSubStatusInfo | 是 | 子状态信息 注意：此字段可能返回 null，表示取不到有效值。 |
| PermissionIdList | Array of String | 否 | 资源操作权限 示例值：["adpAppEdit"] |
AppToolConfig
AppToolConfig
被如下接口引用：DescribePlugin。
| 名称 | 类型 | 必选 | 描述 |
|---|---|---|---|
| Inputs | Array of RequestParam | 否 | 输入参数 |
| Outputs | Array of ResponseParam | 否 | 输出参数 |
AppWebSearchConfig
联网搜索配置(国际版使用)
被如下接口引用：ModifyApp。
| 名称 | 类型 | 必选 | 描述 |
|---|---|---|---|
| ApiKey | String | 是 | API密钥 示例值：sk-*** |
| Enabled | Boolean | 是 | 是否开启 示例值：false |
| Provider | String | 是 | 服务提供商 示例值：代理商信息 |
| TopN | Integer | 是 | 返回结果数量 示例值：0 |
AppWorkflowConfig
工作流配置
被如下接口引用：ModifyApp。
| 名称 | 类型 | 必选 | 描述 |
|---|---|---|---|
| EnablePDL | Boolean | 是 | 是否使用PDL 示例值：false |
AppealingStatus
申诉中的配置 - 记录各配置项是否在申诉中
被如下接口引用：DescribeApp。
| 名称 | 类型 | 必选 | 描述 |
|---|---|---|---|
| AvatarInAppeal | Boolean | 是 | 头像是否在申诉中 示例值：false |
| FallbackReplyInAppeal | Boolean | 是 | 兜底回复语是否在申诉中 示例值：false |
| GreetingInAppeal | Boolean | 是 | 欢迎语是否在申诉中 示例值：false |
| NameInAppeal | Boolean | 是 | 应用名称是否在申诉中 示例值：false |
| RoleInAppeal | Boolean | 是 | 角色描述是否在申诉中 示例值：false |
BackgroundImage
BackgroundImage 背景图片配置
被如下接口引用：ModifyApp。
| 名称 | 类型 | 必选 | 描述 |
|---|---|---|---|
| Brightness | Integer | 是 | 亮度值 示例值：117 |
| LandscapeImageUrl | String | 是 | 横图(pc) 示例值：https://qidian-qbot-test-1251316161.cos.ap-guangzhou.myqcloud.com/public/1744544193038090240/*****************84/image/xdNgbZYwoJkwclZytKaa-2061707216749939200.jpg |
| OriginalImageUrl | String | 是 | 原始图 示例值：https://qidian-qbot-test-1251316161.cos.ap-guangzhou.myqcloud.co*******************************************************************************1707216749939200.jpg |
| PortraitImageUrl | String | 是 | 长图(手机) 示例值：https://qidian-qbot-test-1251316161.cos.ap-guangzhou.myqcloud.com/*********************90240/***0280711******184/ima*** |
| ThemeColor | String | 是 | 主题色 示例值：#cc5631 |
CodeToolConfig
CodeToolConfig
被如下接口引用：DescribePlugin。
| 名称 | 类型 | 必选 | 描述 |
|---|---|---|---|
| Code | String | 是 | 代码 示例值：代码内容，仅通过代码方式创建的工具有值 |
| Example | ToolExample | 否 | 示例 |
| Inputs | Array of RequestParam | 否 | 输入参数 |
| Outputs | Array of ResponseParam | 否 | 输出参数 |
Conversation
Conversation 会话信息
被如下接口引用：DescribeConversationList。
| 名称 | 类型 | 必选 | 描述 |
|---|---|---|---|
| AppId | String | 是 | 应用 ID 示例值：2049148302274678336 |
| ConversationId | String | 是 | 会话 ID 示例值：2f3395c6-f742-4e07-8686-b5618791790d |
| CreateTime | String | 是 | 创建时间 示例值：2026-04-30T14:20:31+08:00 |
| Type | Integer | 是 | 会话类型 枚举值: 0-CONVERSATION_TYPE_UNSPECIFIED(未指定；列表查询时表示全部), 1-CONVERSATION_TYPE_VISITOR(访客端体验), 2-CONVERSATION_TYPE_EVALUATION(评测), 5-CONVERSATION_TYPE_API(API 接入), 10-CONVERSATION_TYPE_WORKFLOW(工作流调试), 20-CONVERSATION_TYPE_SHARE(分享链接) 示例值：2 |
| UpdateTime | String | 是 | 更新时间 示例值：2026-04-30T14:20:31+08:00 |
| Title | String | 否 | 会话标题 示例值：新会话 |
ConversationAgentTask
AgentTask 智能体任务信息
被如下接口引用：DescribeConversationMessageList。
| 名称 | 类型 | 必选 | 描述 |
|---|---|---|---|
| Content | String | 是 | 任务内容 示例值：example task pending |
| Index | String | 是 | 任务序号 示例值：1 |
| Status | String | 是 | 任务状态，pending:待执行，processing:处理中，success:已完成，failed:处理失败，stop:已取消 示例值：processing |
ConversationContent
Content 消息内容信息
被如下接口引用：DescribeConversationMessageList。
| 名称 | 类型 | 必选 | 描述 |
|---|---|---|---|
| Text | String | 是 | 文本内容 示例值：让我选择苹果或者香蕉 |
| Type | String | 是 | 内容类型, text：文本,image：图片,file：文件,custom_variables：自定义输入参数信息,widget_action：widget动作信息 示例值：custom_variables |
| CustomParamList | Array of String | 否 | 自定义参数数据 示例值：["mock-param-a"] |
| CustomParams | Array of String | 否 | 自定义参数数据 示例值：["foo=bar"] |
| CustomVariablesData | String | 否 | 自定义变量数据 注意：此字段可能返回 null，表示取不到有效值。 示例值：{"env":"prod","region":"ap-shanghai"} |
| EnterpriseCharts | String | 否 | 企业表单 注意：此字段可能返回 null，表示取不到有效值。 示例值：{"series":[{"type":"line","data":[1,2,3]}]} |
| OptionCardList | Array of String | 否 | 选项卡列表 示例值：["mock-option-a"] |
| OptionCards | Array of String | 否 | 选项卡列表 示例值：["card-a"] |
| OptionMode | Integer | 否 | 选项卡模式 枚举值: 0-OPTION_MODE_SINGLE(单选), 1-OPTION_MODE_MULTI(多选) 注意：此字段可能返回 null，表示取不到有效值。 示例值：1 |
| QuoteInfoList | Array of ConversationQuoteInfo | 否 | 引用角标信息列表 |
| QuoteInfos | Array of ConversationQuoteInfo | 否 | 引用角标信息列表 |
| ReferenceList | Array of ConversationReference | 否 | 参考来源列表 |
| References | Array of ConversationReference | 否 | 参考来源列表 |
| RelatedRecordId | String | 否 | 关联记录 ID 注意：此字段可能返回 null，表示取不到有效值。 示例值：example-related-record-id |
| TaskList | Array of ConversationAgentTask | 否 | 智能体任务列表 |
| Tasks | Array of ConversationAgentTask | 否 | 智能体任务列表 |
| WorkflowInput | String | 否 | 工作流输入参数 注意：此字段可能返回 null，表示取不到有效值。 示例值：example workflow input |
ConversationExperience
对话体验配置
被如下接口引用：ModifyApp。
| 名称 | 类型 | 必选 | 描述 |
|---|---|---|---|
| AiCall | AICallConfig | 是 | AI通话配置 注意：此字段可能返回 null，表示取不到有效值。 |
| BackgroundImage | BackgroundImage | 是 | 背景图片配置 注意：此字段可能返回 null，表示取不到有效值。 |
| EnableFallbackReply | Boolean | 是 | 兜底回复开关 示例值：false |
| EnableRecommended | Boolean | 是 | 是否使用推荐问 示例值：false |
| EnableWebSearch | Boolean | 是 | 是否使用联网搜索 示例值：false |
| FallbackReply | String | 是 | 兜底回复语 示例值：针对您这个问题，我暂时还无法进行回答，请换一个问题吧。 |
| InputBoxConfig | InputBoxConfig | 是 | 输入框配置 注意：此字段可能返回 null，表示取不到有效值。 |
| Method | Integer | 是 | 输出方式。枚举值: 1:流式, 2:非流式 示例值：1 |
| RecommendPromptMode | Integer | 是 | 推荐问生成prompt模式。枚举值: 1:仅结合知识库输出推荐问的prompt 示例值：0 |
ConversationMessage
Message 消息信息
被如下接口引用：DescribeConversationMessageList。
| 名称 | 类型 | 必选 | 描述 |
|---|---|---|---|
| ConversationId | String | 是 | 会话 ID 示例值：4abd149a-e010-4a6c-bc52-1132658f149d |
| Icon | String | 是 | 消息图标 示例值：https://example.com/icon.png |
| MessageId | String | 是 | 消息 ID 示例值：msg_c8e51d69-d693-415e-afc0-afb39facbc95_1_content |
| Name | String | 是 | 消息名称 示例值：example-assistant |
| RecordId | String | 是 | 记录 ID 示例值：rcd_c8e51d69-d693-415e-afc0-afb39facbc95 |
| Role | String | 是 | 消息角色 示例值：user |
| Status | String | 是 | 消息状态，pending:待执行，processing:处理中，success:已完成，failed:处理失败，stop:已取消 示例值：success |
| StatusDesc | String | 是 | 状态描述 示例值：完整示例消息 |
| Title | String | 是 | 消息标题 示例值：完整示例消息 |
| ContentList | Array of ConversationContent | 否 | 消息内容列表 |
| Contents | Array of ConversationContent | 否 | 消息内容列表 |
| Type | String | 否 | 类型 示例值：tool_call |
ConversationQuoteInfo
QuoteInfo 参考来源索引信息
被如下接口引用：DescribeConversationMessageList。
| 名称 | 类型 | 必选 | 描述 |
|---|---|---|---|
| Index | Integer | 是 | 参考来源的索引值 示例值：1 |
| Position | Integer | 是 | 参考来源位置 示例值：1 |
ConversationReference
Reference 参考来源信息
被如下接口引用：DescribeConversationMessageList。
| 名称 | 类型 | 必选 | 描述 |
|---|---|---|---|
| Index | Integer | 是 | 参考来源索引 示例值：1 |
| Name | String | 是 | 参考来源名称 示例值：doc reference |
| Type | Integer | 是 | 参考来源类型 枚举值: 0-APP_REFERENCE_TYPE_UNSPECIFIED(未指定), 1-APP_REFERENCE_TYPE_QA(问答), 2-APP_REFERENCE_TYPE_SEGMENT(分片), 3-APP_REFERENCE_TYPE_DOC(文档), 4-APP_REFERENCE_TYPE_WEB_SEARCH(Web 搜索), 5-APP_REFERENCE_TYPE_GRAPH_RAG(GraphRAG) 示例值：3 |
ConversationWorkspace
Workspace 工作空间信息
被如下接口引用：DescribeConversation。
| 名称 | 类型 | 必选 | 描述 |
|---|---|---|---|
| WorkspaceId | String | 是 | 工作空间 ID 示例值：6576c839-839c-4a54-b820-408aec31dbe0 |
| StorageType | String | 否 | 存储类型 注意：此字段可能返回 null，表示取不到有效值。 示例值：sandbox_e2b |
DigitalHumanConfig
数智人配置
被如下接口引用：ModifyApp。
| 名称 | 类型 | 必选 | 描述 |
|---|---|---|---|
| AssetKey | String | 是 | 数智人形象资产id 示例值：df***df0 |
| Avatar | String | 是 | 数智人图片 示例值：https://virtualhuman-cos-prod-1251316161.cos.ap-nanjing.tencentcos.cn/wupload/xy/virtualhuman_crm_prod/website_buy/vnZ6ZZYY.png |
| Name | String | 是 | 数智人形象名称 示例值：艾朵_职业套装_站姿 |
| PreviewUrl | String | 是 | 数智人预览地址 示例值：https://virtualhuman-cos-prod-1251316161.cos.ap-nanjing.tencentcos.cn/wupload/xy/virtualhuman_crm_prod/preview/vStr966G.png |
FieldMask
FieldMask
被如下接口引用：DescribeApp, ModifyAgent, ModifyApp, ModifySpace。
| 名称 | 类型 | 必选 | 描述 |
|---|---|---|---|
| Paths | Array of String | 否 | paths 示例值：["AppConfig"] |
FileParseModel
文档解析模型参数
被如下接口引用：ModifyApp。
| 名称 | 类型 | 必选 | 描述 |
|---|---|---|---|
| Alias | String | 是 | 模型别名 示例值：混元大模型 |
| Description | String | 是 | 模型描述 示例值：混元 |
| EnhancementMode | String | 是 | 增强模式 示例值：VLM |
| ModelId | String | 是 | 模型唯一ID 示例值：hunyuan |
| ModelProviderType | String | 是 | 模型类型 示例值：模型供应商类型 |
| EnableFormulaEnhancement | Boolean | 否 | 是否启用公式增强 注意：此字段可能返回 null，表示取不到有效值。 示例值：true |
| EnableLLMEnhancement | Boolean | 否 | 是否启用 LLM 增强 注意：此字段可能返回 null，表示取不到有效值。 示例值：false |
| OutputHtmlTable | Boolean | 否 | 是否输出 HTML 表格 注意：此字段可能返回 null，表示取不到有效值。 示例值：true |
| SupportedFileList | Array of SupportedFileType | 否 | 支持的文件类型列表 |
Filter
Filter
被如下接口引用：DescribeAgentReleasePreviewList, DescribeAppSummaryList, DescribePluginSummaryList, DescribeSkillSummaryList, DescribeVariableList。
| 名称 | 类型 | 必选 | 描述 |
|---|---|---|---|
| Name | String | 否 | 检索名称 示例值：WorkflowRunId |
| ValueList | Array of String | 否 | 检索值 示例值：["8ad82e0553507b4c1ba771fb53029492"] |
GenerateModel
生成模型配置
被如下接口引用：ModifyApp。
| 名称 | 类型 | 必选 | 描述 |
|---|---|---|---|
| Model | ModelDetailInfo | 是 | 生成模型 注意：此字段可能返回 null，表示取不到有效值。 |
InputBoxConfig
输入框配置
被如下接口引用：ModifyApp。
| 名称 | 类型 | 必选 | 描述 |
|---|---|---|---|
| InputBoxButtons | Array of Integer | 否 | 输入框按钮，1：上传图片、2：上传文档，3：腾讯文档，4：联网搜索 示例值：[1] |
IntentAchievementInfo
意图达成信息
被如下接口引用：ModifyApp。
| 名称 | 类型 | 必选 | 描述 |
|---|---|---|---|
| Description | String | 是 | 描述 示例值：文档回复 |
| Name | String | 是 | 名称 示例值：doc |
MCPToolConfig
MCPToolConfig
被如下接口引用：DescribePlugin。
| 名称 | 类型 | 必选 | 描述 |
|---|---|---|---|
| Inputs | Array of RequestParam | 否 | 输入参数 |
| Outputs | Array of ResponseParam | 否 | 输出参数 |
Model
模型完整信息
被如下接口引用：DescribeModelList。
| 名称 | 类型 | 描述 |
|---|---|---|
| BadgeList | Array of ModelBadge | 模型徽章列表 |
| LimitInfo | ModelLimit | 模型限制信息 注意：此字段可能返回 null，表示取不到有效值。 |
| ModelBasic | ModelBasic | 模型基本信息 注意：此字段可能返回 null，表示取不到有效值。 |
| ParameterList | Array of ModelParameter | 模型超参配置 |
| PropertyList | Array of ModelProperty | 模型属性配置 |
| ProviderInfo | ModelProviderBasic | 模型提供商信息 注意：此字段可能返回 null，表示取不到有效值。 |
| StatusInfo | ModelStatus | 模型状态信息 注意：此字段可能返回 null，表示取不到有效值。 |
| TagList | Array of String | 模型标签列表 示例值：["全模态"] |
ModelBadge
模型徽章
被如下接口引用：DescribeModelList。
| 名称 | 类型 | 描述 |
|---|---|---|
| Text | String | 展示文案 示例值：限时免费 |
| Theme | Integer | 样式主题。1-信息（蓝色）, 2-成功（绿色）, 3-警告（橙色）, 4-危险（红色） 示例值：2 |
| Tips | String | tooltip文案，为空则不展示 示例值：该模型当前限时免费使用 |
| Type | Integer | 徽章类型。1-限时免费, 2-即将下线, 3-新模型, 4-热门 示例值：1 |
ModelBasic
模型基本信息
被如下接口引用：DescribeModelList。
| 名称 | 类型 | 描述 |
|---|---|---|
| Description | String | 模型描述 示例值：通用大语言模型 |
| IconUrl | String | 模型图标地址 示例值：https://example.cos.ap-guangzhou.myqcloud.com/public/***/image/***.png |
| ModelId | String | 模型ID 示例值：DeepSeek-V3.2 |
| ModelType | Integer | 模型类型。1-LLM模型, 2-Rerank模型, 3-Embedding模型, 4-文档解析模型 示例值：1 |
| Name | String | 模型名称 示例值：DeepSeek-V3.2 |
ModelDetailInfo
模型详细信息
被如下接口引用：ModifyApp。
| 名称 | 类型 | 必选 | 描述 |
|---|---|---|---|
| Alias | String | 是 | 模型别名 示例值：DeepSeek-V3.2 |
| HistoryLimit | Integer | 是 | 历史对话条数限制 示例值：5 |
| ModelId | String | 是 | 模型唯一ID 示例值：Deepseek/deepseek-v3.2 |
| ModelParams | ModelParams | 否 | 模型参数 注意：此字段可能返回 null，表示取不到有效值。 |
ModelLimit
模型限制信息
被如下接口引用：DescribeModelList。
| 名称 | 类型 | 描述 |
|---|---|---|
| ContextLengthDescription | String | 模型上下文长度展示文案（如 "128K"、"1000K"） 示例值：128K |
| InputLengthLimit | Integer | 模型对话框输入长度字符数限制 示例值：8000 |
| PromptLengthLimit | Integer | 模型提示词长度字符数限制 示例值：4000 |
ModelParameter
模型超参
被如下接口引用：DescribeModelList。
| 名称 | 类型 | 描述 |
|---|---|---|
| DefaultValue | String | 默认值 示例值：0.7 |
| EnumValueList | Array of String | 枚举值列表（仅枚举类型有效） 示例值：[] |
| MaxValue | Float | 最大值（仅数值类型有效） 示例值：1.0 |
| MinValue | Float | 最小值（仅数值类型有效） 示例值：0.0 |
| Name | String | 超参名称 示例值：temperature |
| Type | Integer | 超参类型。1-浮点数, 2-整数, 3-字符串, 4-枚举 示例值：1 |
ModelParams
模型参数
被如下接口引用：CreateAgent, DescribeAgentDetail, ModifyAgent, ModifyApp。
| 名称 | 类型 | 必选 | 描述 |
|---|---|---|---|
| DeepThinking | String | 是 | 是否开启深度思考 示例值：disabled |
| ReasoningEffort | String | 是 | 深度思考效果 示例值：none |
| ReplyFormat | String | 是 | 输出格式 text、json_object 示例值：text |
| FrequencyPenalty | Float | 否 | 频率惩罚 注意：此字段可能返回 null，表示取不到有效值。 示例值：0.4 |
| MaxTokens | Integer | 否 | 最大输出长度 注意：此字段可能返回 null，表示取不到有效值。 示例值：16384 |
| PresencePenalty | Float | 否 | 存在惩罚 注意：此字段可能返回 null，表示取不到有效值。 示例值：0.3 |
| RepetitionPenalty | Float | 否 | 重复惩罚 注意：此字段可能返回 null，表示取不到有效值。 示例值：0.4 |
| Seed | Integer | 否 | seed 随机种子 注意：此字段可能返回 null，表示取不到有效值。 示例值：1 |
| StopSequenceList | Array of String | 否 | 停止序列 示例值：["前进"] |
| Temperature | Float | 否 | 温度 注意：此字段可能返回 null，表示取不到有效值。 示例值：0.6 |
| TopP | Float | 否 | top_p 注意：此字段可能返回 null，表示取不到有效值。 示例值：0.6 |
ModelProperty
模型属性
被如下接口引用：DescribeModelList。
| 名称 | 类型 | 描述 |
|---|---|---|
| Name | String | 属性名称 示例值：support_workflow_status |
| Value | String | 属性值 示例值：1 |
ModelProviderBasic
模型提供商基本信息
被如下接口引用：DescribeModelList。
| 名称 | 类型 | 描述 |
|---|---|---|
| Alias | String | 模型提供商别名 示例值：DeepSeek |
| Name | String | 模型提供商名称 示例值：deepseek |
| ProviderType | Integer | 模型提供商类型。1-自有提供商, 2-自定义模型提供商, 3-第三方模型提供商 示例值：1 |
ModelStatus
模型状态信息
被如下接口引用：DescribeModelList。
| 名称 | 类型 | 描述 |
|---|---|---|
| Concurrency | Integer | 专属并发数 示例值：0 |
| IsExclusive | Boolean | 是否专属并发 示例值：false |
| ResourceStatus | Integer | 资源状态。1-资源可用, 2-资源已用尽 示例值：1 |
MultiAgentConfig
多智能体配置
被如下接口引用：ModifyApp。
| 名称 | 类型 | 必选 | 描述 |
|---|---|---|---|
| AgentCollaboration | AgentCollaborationConfig | 是 | Agent协同配置 注意：此字段可能返回 null，表示取不到有效值。 |
MultiModalQAModel
多模态问答模型配置
被如下接口引用：ModifyApp。
| 名称 | 类型 | 必选 | 描述 |
|---|---|---|---|
| Model | ModelDetailInfo | 是 | 模型配置 注意：此字段可能返回 null，表示取不到有效值。 |
MultiModalUnderstandingModel
多模态理解模型配置
被如下接口引用：ModifyApp。
| 名称 | 类型 | 必选 | 描述 |
|---|---|---|---|
| Model | ModelDetailInfo | 是 | 模型配置 注意：此字段可能返回 null，表示取不到有效值。 |
Plugin
插件详情
被如下接口引用：DescribePlugin。
| 名称 | 类型 | 必选 | 描述 |
|---|---|---|---|
| CreateTime | String | 否 | 创建时间，unix时间戳 示例值：1780047312 |
| Operation | PluginOperation | 否 | 插件运营管理信息 |
| PluginId | String | 否 | 插件id 示例值：0960ae93-80a0-408d-928b-f484064f834a |
| PluginVersion | Integer | 否 | 插件版本号 示例值：1 |
| Profile | PluginProfile | 否 | 插件基础信息 |
| Statistics | PluginStatistics | 否 | 插件统计信息 |
| Status | Integer | 否 | 插件状态，1:可用，2:不可用 枚举值：
示例值：1 |
| ToolList | Array of Tool | 否 | 工具列表 |
| UpdateTime | String | 否 | 更新时间，Unix时间戳 示例值：1780047312 |
| UserState | PluginUserState | 否 | 用户维度的插件状态信息 |
PluginOperation
PluginOperation
被如下接口引用：DescribePlugin, DescribePluginSummaryList。
| 名称 | 类型 | 必选 | 描述 |
|---|---|---|---|
| AllowExternalAccess | Boolean | 否 | 是否允许外部调用 示例值：true |
| BillingType | Integer | 否 | 计费类型 枚举值: | uint | 描述 | | --- | --- | | 0 | 免费 | | 1 | 限时免费 | | 2 | 官方收费 | 示例值：3 |
| CategoryKey | String | 否 | 插件分类标识 示例值：search_fetch |
| Introduction | String | 否 | 插件概述 示例值：# 混元生3D AI3D> 前往 腾讯混元生3D 了解更多。 |
| IsRecommended | Boolean | 否 | 是否精选 示例值：true |
PluginProfile
PluginProfile
被如下接口引用：DescribePlugin, DescribePluginSummaryList。
| 名称 | 类型 | 必选 | 描述 |
|---|---|---|---|
| Author | String | 否 | 插件作者 示例值：智能体开发平台 |
| Description | String | 否 | 插件描述 示例值：基于混元大模型，可以根据用户输入的文本query，自动创作不同风格的图片（极速版） |
| IconUrl | String | 否 | 插件图标url 示例值：https://qidian-qbot-test-1251316161.cos.ap-guangzhou.myqcloud.com/public/adp/0d0b65f37d0651ef8c4dc61d7238617d_1780285068379.png |
| Name | String | 否 | 插件名称 示例值：混元生3D AI3D |
| PluginClass | Integer | 否 | 插件产品分类 枚举值: | uint | 描述 | | --- | --- | | 0 | 普通插件 | | 1 | 连接器类插件 | 示例值：0 |
| PluginKind | Integer | 否 | 插件类型 枚举值: | uint | 描述 | | --- | --- | | 0 | API接口 | | 1 | 代码 | | 2 | MCP | | 3 | 应用 | 示例值：0 |
| PluginSource | Integer | 否 | 插件来源 枚举值: | uint | 描述 | | --- | --- | | 0 | 自定义插件 | | 1 | 官方插件 | | 2 | 第三方插件 | 示例值：1 |
PluginStatistics
PluginStatistics
被如下接口引用：DescribePlugin, DescribePluginSummaryList。
| 名称 | 类型 | 必选 | 描述 |
|---|---|---|---|
| CallCount | Integer | 否 | 插件调用量 示例值：9 |
| ToolCount | Integer | 否 | 工具数量 示例值：6 |
PluginSummary
插件概要信息（用于插件列表）
被如下接口引用：DescribePluginSummaryList。
| 名称 | 类型 | 必选 | 描述 |
|---|---|---|---|
| Operation | PluginOperation | 否 | 插件运营管理信息 |
| PluginId | String | 否 | 插件id 示例值：0960ae93-80a0-408d-928b-f484064f834a |
| Profile | PluginProfile | 否 | 插件基础信息 |
| Statistics | PluginStatistics | 否 | 插件统计信息 |
| Status | Integer | 否 | 插件状态，1:可用，2:不可用 枚举值：
示例值：1 |
| UserState | PluginUserState | 否 | 用户维度的插件状态信息 |
PluginUserState
PluginUserState
被如下接口引用：DescribePlugin, DescribePluginSummaryList。
| 名称 | 类型 | 必选 | 描述 |
|---|---|---|---|
| IsFavorite | Boolean | 否 | 是否已收藏该插件 示例值：true |
| IsInWhiteList | Boolean | 否 | 是否在插件白名单内 示例值：true |
| WhiteListType | Integer | 否 | 白名单类型 枚举值: | uint | 描述 | | --- | --- | | 0 | 非白名单插件，全量开放 | | 1 | 在白名单里 | | 2 | 不在白名单里，需要提交申请 | 示例值：0 |
PromptRewriteModel
Prompt改写配置
被如下接口引用：ModifyApp。
| 名称 | 类型 | 必选 | 描述 |
|---|---|---|---|
| Model | ModelDetailInfo | 是 | 模型配置 注意：此字段可能返回 null，表示取不到有效值。 |
ReleaseRecord
[数据结构定义] 发布记录
被如下接口引用：DescribeReleaseList。
| 名称 | 类型 | 必选 | 描述 |
|---|---|---|---|
| CanExport | Boolean | 是 | 是否可导出 示例值：true |
| CanRollback | Boolean | 是 | 是否可回滚 示例值：false |
| Description | String | 是 | 发布描述 示例值：我的发布信息 |
| FailCount | Integer | 是 | 发布失败数 示例值：0 |
| Reason | String | 是 | 失败原因 示例值：发布原因 |
| ReleaseId | String | 是 | 发布ID 示例值：20617****32 |
| ReleaseVersion | String | 是 | 发布版本 示例值：v2026****08 |
| Status | Integer | 是 | 发布状态。枚举值: 1:待发布, 2:发布中, 3:发布成功, 4:发布失败, 5:审核中, 6:审核成功, 7:审核失败, 8:发布成功回调处理中, 9:发布暂停, 10:申诉审核中, 11:申诉审核通过, 12:申诉审核不通过 示例值：3 |
| StatusDescription | String | 是 | 状态描述 示例值：发布成功 |
| SuccessCount | Integer | 是 | 发布成功数 示例值：0 |
| UpdateTime | String | 是 | 更新时间 (Unix时间戳,秒级) 示例值：1780389728 |
| Updater | String | 是 | 发布人 示例值：wu**g |
ReleaseSummary
发布摘要信息
被如下接口引用：DescribeLatestRelease, DescribeReleaseSummary。
| 名称 | 类型 | 必选 | 描述 |
|---|---|---|---|
| CreateTime | String | 是 | 创建时间 (Unix时间戳,秒级) 示例值：1780389728 |
| Description | String | 是 | 发布描述 示例值：我的发布信息 |
| ReleaseId | String | 是 | 发布ID 示例值：2061*32 |
| Status | Integer | 是 | 发布状态。枚举值: 1:待发布, 2:发布中, 3:发布成功, 4:发布失败, 5:审核中, 6:审核成功, 7:审核失败, 8:发布成功回调处理中, 9:发布暂停, 10:申诉审核中, 11:申诉审核通过, 12:申诉审核不通过 示例值：3 |
| StatusDescription | String | 是 | 状态描述 示例值：发布成功 |
| ChannelIdList | Array of String | 否 | 发布渠道ID列表 示例值：["123213213213"] |
RequestParam
定义工具的请求参数
被如下接口引用：DescribePlugin。
| 名称 | 类型 | 必选 | 描述 |
|---|---|---|---|
| DefaultValue | String | 是 | 默认值 示例值：张三 |
| Description | String | 是 | 参数描述 示例值：人物名字 |
| IsGlobalHidden | Boolean | 是 | 全局隐藏不可见（区别于Agent场景的agent_hidden），true-全局隐藏不可见，false-可见 示例值：false |
| IsRequired | Boolean | 是 | 是否必选 示例值：true |
| Name | String | 是 | 参数名称 示例值：name |
| Type | Integer | 是 | 参数类型 枚举值: | uint | 描述 | | --- | --- | | 0 | 默认值是string，如果不填就按string处理 | | 1 | | | 2 | | | 3 | | | 4 | | | 5 | | | 6 | | | 7 | | | 8 | | | 9 | | | 20 | | | 99 | 空值 | | 100 | 未指定类型，用于类型为OneOf和AnyOf的场景 | 示例值：0 |
| AnyOf | Array of RequestParam | 否 | AnyOf类型的参数 |
| OneOf | Array of RequestParam | 否 | OneOf类型的参数 |
| SubParams | Array of RequestParam | 否 | 子参数,ParamType 是OBJECT 或 ARRAY<>类型有用 |
ResponseParam
定义工具的回复参数
被如下接口引用：DescribePlugin。
| 名称 | 类型 | 必选 | 描述 |
|---|---|---|---|
| Description | String | 是 | 变量描述 示例值：人物名字 |
| Name | String | 是 | 参数名称 示例值：name |
| Type | Integer | 是 | 参数类型 枚举值: | uint | 描述 | | --- | --- | | 0 | 默认值是string，如果不填就按string处理 | | 1 | | | 2 | | | 3 | | | 4 | | | 5 | | | 6 | | | 7 | | | 8 | | | 9 | | | 20 | | | 99 | 空值 | | 100 | 未指定类型，用于类型为OneOf和AnyOf的场景 | 示例值：0 |
| RenderMode | Integer | 否 | 枚举值: | uint | 描述 | | --- | --- | | 0 | 覆盖（全量替换） | | 1 | 增量追加 | 示例值：0 |
| SubParams | Array of ResponseParam | 否 | 只对 OBJECT 或 ARRAY_OBJECT 类型有用 |
RoleConfig
角色配置
被如下接口引用：ModifyApp。
| 名称 | 类型 | 必选 | 描述 |
|---|---|---|---|
| RoleDescription | String | 是 | 角色描述 示例值：我是提示词信息 |
SearchResourceStatusInfo
搜索资源状态信息
被如下接口引用：DescribeApp。
| 名称 | 类型 | 必选 | 描述 |
|---|---|---|---|
| ResourceStatus | Integer | 是 | 搜索资源状态: AVAILABLE(1)=资源可用, EXHAUSTED(2)=资源已用尽。枚举值: 1:资源可用, 2:资源已用尽 示例值：1 |
SingleWorkflowConfig
单工作流配置
被如下接口引用：ModifyApp。
| 名称 | 类型 | 必选 | 描述 |
|---|---|---|---|
| AsyncWorkflow | Boolean | 是 | 是否开启异步工作流 示例值：false |
| Status | String | 是 | 状态 发布状态(UNPUBLISHED: 待发布 PUBLISHING: 发布中 PUBLISHED: 已发布 PUBLISHED_FAIL:发布失败；DRAFT：待调试) 示例值：PUBLISHING |
| WorkflowDescription | String | 是 | 工作流描述 示例值：我的工作流信息 |
| WorkflowId | String | 是 | 工作流Id 示例值：250b6*a-0436b0cc5717 |
| WorkflowName | String | 是 | 工作流名称 示例值：我的工作流 |
SkillAnalysisInfo
SkillAnalysisInfo Skill 安全扫描信息。
被如下接口引用：DescribeSkillSummaryList。
| 名称 | 类型 | 必选 | 描述 |
|---|---|---|---|
| AnalysisStatus | Integer | 是 | 安全检测状态 枚举值: | uint | 描述 | | --- | --- | | 0 | 待检测 | | 1 | 检测中 | | 2 | 可用 | | 3 | 不可用 | | 4 | 检测失败 | 示例值：2 |
| RiskDescription | String | 是 | 风险描述 示例值：风险** |
| RiskLevel | Integer | 是 | 风险等级 枚举值: | uint | 描述 | | --- | --- | | 0 | 无风险 | | 1 | 低风险 | | 2 | 中风险 | | 3 | 高风险 | 示例值：2 |
| SecurityReportUrl | String | 是 | 安全报告跳转url; 示例值：https://tix.qq.com/search/skill?keyword=************35b2bf1e62e70d86170c |
SkillCategory
SkillCategory Skill 分类信息。
被如下接口引用：DescribeSkillCategoryList。
| 名称 | 类型 | 必选 | 描述 |
|---|---|---|---|
| CategoryKey | String | 是 | 分类标识 示例值：office_doc |
| CategoryName | String | 是 | 分类名称 示例值：通用办公 |
SkillClassification
SkillClassification Skill 分类与来源信息。
被如下接口引用：DescribeSkillSummaryList。
| 名称 | 类型 | 必选 | 描述 |
|---|---|---|---|
| BillingType | Integer | 是 | Skill 计费类型 枚举值: | uint | 描述 | | --- | --- | | 0 | 免费 | | 1 | 付费 | 示例值：0 |
| BuiltinSource | Integer | 是 | Skill 内置来源，仅在 create_type 为 SKILL_CREATE_TYPE_BUILTIN 时生效 枚举值: | uint | 描述 | | --- | --- | | 0 | 占位 | | 1 | ADP 专有 | | 2 | 腾讯专有 | | 3 | SkillHub | | 99 | 其他 | 示例值：1 |
| CategoryKey | String | 是 | Skill 分类 示例值：ocr |
| CreateType | Integer | 是 | Skill 创建方式 枚举值: | uint | 描述 | | --- | --- | | 0 | 占位 | | 1 | 文件上传 | | 2 | 由企业级共享流程生成 | | 3 | AIGC 生成 | | 99 | 内置 Skill | 示例值：99 |
| ProviderType | Integer | 是 | Skill 提供方类型 枚举值: | uint | 描述 | | --- | --- | | 0 | 占位 | | 1 | 官方 | | 2 | 第三方 | | 3 | 自定义 | | 4 | 自定义企业级共享 | 示例值：1 |
| SourceLink | String | 是 | Skill 来源链接 示例值：https://adp.*** |
SkillProfile
SkillProfile Skill 基础展示信息。
被如下接口引用：DescribeSkillSummaryList。
| 名称 | 类型 | 必选 | 描述 |
|---|---|---|---|
| CreateTime | String | 是 | 创建时间（Unix秒） 示例值：1716825600 |
| Creator | String | 是 | 创建者 示例值：智能体开发平台 |
| Description | String | 是 | Skill 描述 示例值：A skill for analyzing datasets, generating insights, and creating reports. |
| DisplayDescription | String | 是 | Skill 展示描述 示例值：用于分析数据集、生成洞察并输出分析报告的 Skill。 |
| DisplayName | String | 是 | Skill 展示名称 示例值：数据分析助手 |
| IconUrl | String | 是 | Skill 图标 示例值：https://example.com/icons/data-analysis.png |
| Name | String | 是 | Skill 名称 示例值：data_analysis_assistant |
| UpdateTime | String | 是 | 更新时间（Unix秒） 示例值：1716825600 |
SkillShare
SkillShare Skill 企业共享信息。
被如下接口引用：DescribeSkillSummaryList。
| 名称 | 类型 | 必选 | 描述 |
|---|---|---|---|
| ApprovalId | String | 是 | 审批ID 示例值：20621320*** |
| ShareSkillId | String | 是 | 共享后关联的新 skill_id 示例值：c8c9668b-**-7c5f644f8a20_shared |
| ShareVersion | String | 是 | 共享版本，如 1.0.0 示例值：1.0.11 |
| ShareVersionId | String | 是 | 共享版本ID 示例值：afebd117-*-a1f2-ab52264835c1 |
| SkillId | String | 是 | 原 skill_id 示例值：c8c9668b-*-8af5-7c5f644f8a20 |
| Status | Integer | 是 | 共享状态 枚举值: | uint | 描述 | | --- | --- | | 0 | 未共享 | | 1 | 已共享 | | 2 | 审批中 | 示例值：2 |
SkillSummary
SkillSummary 列表中的 Skill 摘要。
被如下接口引用：DescribeSkillSummaryList。
| 名称 | 类型 | 必选 | 描述 |
|---|---|---|---|
| ClassificationInfo | SkillClassification | 是 | 分类信息 注意：此字段可能返回 null，表示取不到有效值。 |
| CurrentVersionInfo | SkillVersion | 是 | 当前版本信息 注意：此字段可能返回 null，表示取不到有效值。 |
| IsFavorite | Boolean | 是 | 当前用户是否收藏 示例值：false |
| Profile | SkillProfile | 是 | 基础信息 注意：此字段可能返回 null，表示取不到有效值。 |
| SkillId | String | 是 | Skill ID 示例值：2d74f6c5-**-dfcd5cd1b7a6 |
| ShareList | Array of SkillShare | 否 | 共享信息；可能有两条，一条是已共享的，一条是审核中的 |
SkillVersion
SkillVersion Skill 版本信息。
被如下接口引用：DescribeSkillSummaryList。
| 名称 | 类型 | 必选 | 描述 |
|---|---|---|---|
| AnalysisInfo | SkillAnalysisInfo | 是 | 检测信息 注意：此字段可能返回 null，表示取不到有效值。 |
| Version | String | 是 | 当前生效版本号 示例值：1.0.8 |
| VersionId | String | 是 | 当前生效版本ID 示例值：25551ac3-**-1a829b1a6255 |
Space
空间信息
被如下接口引用：DescribeSpaceList。
| 名称 | 类型 | 必选 | 描述 |
|---|---|---|---|
| SpaceId | String | 否 | 空间id 示例值：default_space |
| Name | String | 否 | 空间名称 示例值：名称 |
| Description | String | 否 | 空间描述 示例值：空间描述 |
| PermissionIdList | Array of String | 否 | 空间权限 示例值：["adpSpace.ModifySpace"] |
SpecialStatusInfo
特殊状态信息
被如下接口引用：DescribeApp。
| 名称 | 类型 | 必选 | 描述 |
|---|---|---|---|
| Status | Integer | 是 | 状态 (0-不在特殊状态中, 1-在特殊状态中)。枚举值: 1:在特殊状态中 示例值：0 |
SupportedFileType
支持的文件类型
被如下接口引用：ModifyApp。
| 名称 | 类型 | 必选 | 描述 |
|---|---|---|---|
| Description | String | 是 | 文件类型描述(如"文本文档") 示例值：描述信息 |
| FileExt | String | 是 | 文件类型(如 txt、pdf、jpg, 建议用扩展名) 示例值：txt |
| MaxSizeBytes | String | 是 | 文件大小限制(单位: 字节) 示例值：1000 |
SystemVariable
系统变量
被如下接口引用：DescribeSystemVariableList。
| 名称 | 类型 | 必选 | 描述 |
|---|---|---|---|
| Description | String | 是 | 变量描述 示例值：会话ID（API调用请求参数中的session_id） |
| Name | String | 是 | 变量名称 示例值：SYS.SessionId |
TemplatePublishInfo
模版中心同步信息(私有化独有 - 公有云/SaaS 版本忽略此字段)
被如下接口引用：DescribeApp。
| 名称 | 类型 | 必选 | 描述 |
|---|---|---|---|
| IsPublished | Boolean | 是 | 是否已同步到模版中心 示例值：false |
ThinkModel
思考模型配置
被如下接口引用：ModifyApp。
| 名称 | 类型 | 必选 | 描述 |
|---|---|---|---|
| Model | ModelDetailInfo | 是 | 思考模型 注意：此字段可能返回 null，表示取不到有效值。 |
Tool
插件的工具信息
被如下接口引用：DescribePlugin。
| 名称 | 类型 | 必选 | 描述 |
|---|---|---|---|
| Description | String | 否 | 工具描述信息 示例值：获取指定日期和地点的天气信息 |
| Name | String | 否 | 工具名称 示例值：GetWeatherInfo |
| PluginId | String | 否 | 插件id 示例值：0960ae93-80a0-408d-928b-f484064f833h |
| ToolId | String | 否 | 工具id 示例值：0960ae93-80a0-408d-928b-f484064f834a |
| Billing | ToolBilling | 否 | 工具计费信息 |
| CallCount | Integer | 否 | 工具调用次数 示例值：5 |
| ToolAccessMode | Integer | 否 | 工具访问模式 枚举值：
示例值：0 |
| ToolConfig | ToolConfig | 否 | 工具配置 |
ToolBilling
ToolBilling
被如下接口引用：DescribePlugin。
| 名称 | 类型 | 必选 | 描述 |
|---|---|---|---|
| BillingType | Integer | 否 | 计费类型 枚举值: | uint | 描述 | | --- | --- | | 0 | 免费 | | 1 | 限时免费 | | 2 | 官方收费 | | 3 | 官方收费(存量老用户限时免费) | 示例值：0 |
ToolConfig
ToolConfig
被如下接口引用：DescribePlugin。
| 名称 | 类型 | 必选 | 描述 |
|---|---|---|---|
| ApiToolConfig | ApiToolConfig | 否 | API插件工具配置 注意：此字段可能返回 null，表示取不到有效值。 |
| AppToolConfig | AppToolConfig | 否 | 应用插件工具配置 注意：此字段可能返回 null，表示取不到有效值。 |
| CodeToolConfig | CodeToolConfig | 否 | 代码插件工具配置 注意：此字段可能返回 null，表示取不到有效值。 |
| MCPToolConfig | MCPToolConfig | 否 | mcp插件工具配置 注意：此字段可能返回 null，表示取不到有效值。 |
ToolExample
ToolExample
被如下接口引用：DescribePlugin。
| 名称 | 类型 | 必选 | 描述 |
|---|---|---|---|
| Request | String | 否 | 请求示例，json字符串 示例值：{"input":"A"} |
| Response | String | 否 | 回复示例，json字符串 示例值：{"result": "B"} |
Variable
变量信息
被如下接口引用：CreateVariable, DescribeVariable, DescribeVariableList, ModifyVariable。
| 名称 | 类型 | 必选 | 描述 |
|---|---|---|---|
| DefaultFileName | String | 是 | 默认文件名称 示例值：**** |
| DefaultValue | String | 是 | 默认值 示例值：1 |
| Description | String | 是 | 变量描述 示例值：我的环境变量 |
| ModuleType | Integer | 是 | 模块类型。枚举值: 1:环境参数, 2:应用参数, 3:系统参数, -1:所有参数 示例值：1 |
| Name | String | 是 | 变量名称 示例值：myname1 |
| Type | Integer | 是 | 变量类型。枚举值: 1:字符串, 2:整数, 3:浮点数, 4:布尔值, 5:对象, 6:字符串数组, 7:整数数组, 8:浮点数数组, 9:布尔值数组, 10:对象数组, 11:文件, 12:文档, 13:图片, 14:音频, 15:视频, 16:文件数组, 17:文档数组, 18:图片数组, 19:音频数组, 20:视频数组, 21:数组的数组, 22:密钥/敏感信息, 99:空值 示例值：1 |
| VariableId | String | 是 | 变量ID 示例值：e6b30407-81fd-4ca1-a153-1820d32a37b2 |
VoiceConfig
VoiceConfig
被如下接口引用：ModifyApp。
| 名称 | 类型 | 必选 | 描述 |
|---|---|---|---|
| TimbreKey | String | 是 | 数智人音色key,需要和公有云音色id对齐 示例值：tts_female_55 |
| VoiceName | String | 是 | 音色名称 示例值：智小柔-聊天女声 |
| VoiceType | Integer | 是 | 公有云音色id 示例值：502001 |
