创建一个新的智能体实例，可指定名称、描述、灵魂设定、身份定义和禁用的内置技能。身份定义支持Markdown，不传或传空白内容时使用系统默认身份。

根据智能体ID查询智能体的详细信息，包含基础信息、头像、技能矩阵和功能开关等。

查询当前用户有权限访问的智能体列表，返回智能体ID、名称和头像URL。

兼容更新智能体名称、描述和灵魂设定；仅编辑名称和描述时，建议使用 updateDefinition。

仅更新智能体名称和描述，不修改灵魂设定、身份定义、模型、技能、头像或能力配置。更新成功后返回最新的基本定义；如需同时修改灵魂设定，请继续使用兼容接口 updateBasicInfo。

更新智能体的身份定义内容（支持Markdown），传null则清空。更新后自动创建版本快照，可通过配置版本管理接口（configType=identity）查看历史版本并恢复。身份说明：当您通过API访问本系统时，请求头中必须传递 X-Principal-Id 以标识操作主体；当您通过页面访问本系统时，无需传递。

更新智能体的头像，传 null 表示恢复默认头像。

设置智能体的默认模型名称，modelName 传 null 或空字符串表示清除自定义设置、恢复为系统默认模型。modelName 按当前租户可用模型列表校验，与「查询可用模型列表」接口返回的列表口径一致。身份说明：当您通过API访问本系统时，请求头中必须传递 X-Principal-Id 以标识操作主体；当您通过页面访问本系统时，无需传递。

设置智能体在 file 工具 view 图片（含 PDF、知识库文档内嵌图片）时使用的视觉模型，运行时优先于系统默认视觉模型。imageModelName 传 null 或空字符串表示清除自定义设置、恢复为系统默认视觉模型。模型按当前租户可用模型列表校验，且必须支持图片输入（「查询可用模型列表」接口返回的 inputModalities 包含 IMAGE），纯文本模型会被拒绝。身份说明：当您通过API访问本系统时，请求头中必须传递 X-Principal-Id 以标识操作主体；当您通过页面访问本系统时，无需传递。

查询当前租户下可选的模型列表，含模型ID、上下文窗口、最大输出token及输入模态等元数据。inputModalities可选值：TEXT、IMAGE、VIDEO，调用方应使用该字段判断模型是否支持图片或视频输入。原supportVision字段已废弃但暂时保留，新调用方不应继续依赖该字段。同时返回服务端建议预选的 selectedModelName（恒非空），前端下拉框应直接用该值预选。元数据字段可能为空（供应商未配置时），前端渲染需容错。可选传入 agentId：传入且可解析时 selectedModelName 为该智能体的有效模型，否则回落为系统默认。

更新智能体的功能设置，包括定时任务、斜杠命令、代码执行、Shell执行、联网搜索、网页读取和向用户提问等开关。所有开关字段均为可选，传null表示不修改。

设置智能体的技能数据隔离策略。AGENT模式下所有用户共享技能数据；PRINCIPAL模式下按用户隔离。注意：若智能体下已存在自定义技能，则禁止切换，需先删除所有自定义技能后再修改。

根据智能体ID查询该智能体下的技能列表，包含内置技能和自定义技能。当智能体技能隔离范围为PRINCIPAL模式时，传递 X-Principal-Id 可按身份主体过滤技能数据；未传递则返回该智能体下所有技能。

身份说明：当您通过API访问本系统时，可在请求头中传递 X-Principal-Id 以按身份主体过滤技能（可选）；当您通过页面访问本系统时，无需传递。

查询当前租户下所有可用的内置技能列表。

在智能体上启用或禁用指定知识库。启用后该 agent 在对话时会看到 knowledge_search 工具，且仅能访问启用范围内的知识库。

启用（enabled=true）时只允许指定<b>当前应用空间下</b>的知识库，跨应用空间或跨租户的知识库返回无权访问；用户被迁移到新应用空间后，其在原空间创建的旧库同样不能再被新空间的智能体启用。禁用（enabled=false）不做该校验，历史上已启用的跨空间知识库随时可关闭。

调用 AIGC 接口生成头像，返回 fileName 和 previewUrl。

删除智能体前调用，返回是否可删除、当前阻塞项、预计软删除的资源数量以及删除后保留的历史资源。阻塞类型可选值：DEFAULT_AGENT、ACTIVE_RUN、REGISTERED_EXECUTION、SANDBOX_BACKGROUND_TASK、PUBLISHED_AGENT_HUB、BOUND_CHANNEL、CHANNEL_PRINCIPAL_MAPPING、DELETE_IN_PROGRESS、UNKNOWN。

标准软删除智能体及其定义资源，返回统一删除时间和各类资源的软删除数量。调用前应先使用 deleteCheck 展示删除影响；执行删除时系统会再次检查，如果状态变化导致不可删除，将返回HTTP 409及最新删除检查结果。会话、运行记录、附件和配置快照等历史资源会按删除检查结果保留。