Skip to content

关键概念

这里介绍您在本平台中可能遇到的重要概念。不同产品模块可能使用不同的界面字段名称,但同一概念在平台中的含义应以本页为准。

租户

租户是智算云平台中的组织隔离单元,代表一个独立的账户空间。每个租户拥有独立的资源配额、用户管理、计费和权限体系。

租户内的用户可根据被授予的权限策略和授权范围执行对应操作,例如管理用户、资源配额、API 密钥或访问特定资源。

更多内容请见 租户管理

超级管理员

超级管理员是租户内权限最高的管理角色,通常拥有平台预置的全局管理权限。

超级管理员可用于完成租户级配置、权限管理、资源管理和高权限运维操作。为降低误操作风险,应仅将该角色授予确实需要全局管理权限的用户。

用户组

用户组是一种批量管理用户权限的机制。通过将用户加入用户组,可以统一授予该组内所有用户相同的资源访问权限。

  • 一个用户可以属于多个用户组。
  • 用户的最终权限为其个人权限与所属用户组权限的并集。

API 密钥

API 密钥(API Key)是用于访问 API 服务的身份凭证。

  • 用于 GenStudio API 服务调用。
  • 可在访问控制中创建、查看和管理。

更多内容请见 API 密钥管理

权限策略

权限策略定义用户可以执行的操作。策略需要与授权范围配合使用,授权范围限定策略作用的资源。

  • 系统策略:平台预置的权限策略,用于授予产品功能的常见访问权限。
  • 自定义策略:具备权限管理权限的用户根据业务需求自定义的细粒度权限策略。

更多内容请见 理解策略和授权范围

授权范围

授权范围用于限定权限策略作用的资源边界。权限策略定义用户可以执行哪些操作,授权范围定义这些操作可以作用于哪些资源。

配置用户或用户组权限时,管理员需要同时选择权限策略和授权范围,才能形成完整的访问控制规则。

更多内容请见 理解策略和授权范围

按量付费

按量付费是一种按实际使用量结算费用的计费方式。用户无需提前购买长期资源,平台会根据资源运行时长、调用量、存储用量或其他计量维度产生费用。

文档中的“按量计费”与“按量付费”通常指同一类计费方式。实际费用以费用中心、订单、账单或产品页面展示的计费规则为准。

工作流

工作流是由多个步骤、节点或工具调用组成的自动化流程,用于把输入、处理逻辑和输出组织成可复用的执行链路。

在智能体和 ComfyUI 等场景中,用户通过工作流编排模型调用、工具调用、图像生成、数据处理或其他业务逻辑,并可通过页面或 API 发起运行。

智能体模板

智能体模板保存可复用的智能体设计,包括模型、提示词、能力关联和运行配置。一个智能体模板可以用于创建多个智能体实例。

修改智能体模板不会自动更新已有智能体实例。需要让实例使用新配置时,请手动更新实例并重新验证运行结果。

任务标题中的“智能体”有时泛指要构建的对象;涉及选择、编辑或更新具体资源时,文档使用“智能体模板”指代这个可复用设计。更多内容请见 智能体、插件和实例的关系

智能体实例

智能体实例是根据智能体模板创建的运行对象,可以通过 Playground、Invoke API、WebSocket、飞书或 QQ 使用。

每个智能体实例都引用一个智能体模板,但可以具有自己的运行参数、能力资源、访问凭证、状态和会话。部分渠道配置界面使用“应用实例”指代同一个对象。

智能体实例不等同于一次会话或一次调用任务。更多内容请见 从智能体到智能体实例

插件配置

插件配置记录智能体模板与能力对象之间的关联,用于让智能体检索知识、调用工具、保存记忆、执行命令或委托子代理。

插件配置不是独立的运行资源。根据能力类型,它可以引用能力模板、已有能力实例、平台工具包、用户工具契约或已有智能体实例。

保存插件配置后,还需要创建或更新智能体实例,并通过实际任务和 Trace 确认能力已经生效。更多内容请见 为智能体添加能力

能力模板

能力模板保存可重复使用的能力配置,并可以决定创建智能体实例时允许填写哪些参数。

智能体模板通过插件配置选择能力模板后,平台会在创建智能体实例时按照该模板准备或绑定运行所需的能力资源。能力模板适合统一基线、复用配置或按需准备资源的场景。

创建第一个智能体并不要求预先创建能力模板。更多内容请见 模板和实例如何影响资源

能力实例

能力实例是智能体运行时实际使用的能力资源或连接,例如 MCP 连接、知识库组、记忆库、技能组或沙箱。

在插件配置中选择已有能力实例,会让智能体模板直接关联该资源。由同一智能体模板创建的多个智能体实例可能共享它;选择已有实例不会自动复制资源或隔离其中的数据、凭证和权限。

需要按统一配置为新智能体实例准备资源时,请改用能力模板。更多内容请见 模板和实例如何影响资源

沙箱

在智能体开发服务平台(AgentWorks)中,沙箱是与智能体实例关联的隔离运行环境,可向智能体提供命令、文件和代码执行工具。兼容的沙箱环境还可以承载预先开发的微应用,在智能体实例的 Playground 中显示自定义业务界面。

选择沙箱模板时,创建智能体实例会为该实例创建沙箱资源;选择现有沙箱实例时,会复用同一个资源。新建会话不会自动创建沙箱。选择方法参见 配置沙箱模板和实例

渠道账号

渠道账号把飞书、QQ 或 WebSocket 等外部入口连接到 AgentWorks,并保存该入口所需的渠道配置和凭证。

渠道账号可以绑定一个已有智能体实例,让渠道用户共享该实例;也可以绑定智能体模板,让不同渠道用户通过 /init 按需创建专属智能体实例。

渠道账号不等同于渠道用户、用户绑定或渠道会话。更多内容请见 通过渠道提供智能体

用户绑定

用户绑定记录一个渠道用户与一个专属智能体实例之间的对应关系。它只在渠道账号使用模板绑定、并为用户按需创建实例时产生。

后续消息根据用户绑定进入已经创建的智能体实例。删除用户绑定不会删除原智能体实例;用户重新执行 /init 后,平台可以创建实例并建立新的绑定。

用户绑定不等同于渠道会话,也不会单独证明记忆、业务数据或外部账号已经按用户隔离。更多内容请见 管理渠道账号与用户绑定

API 会话

API 会话使用 session_id 把对同一个智能体实例的多次 Invoke API 请求组织成一段多轮对话。

首次请求不发送 session_id 时,平台会创建会话并返回新 ID;后续请求复用该 ID 以继续对话。开始新会话不会创建新的智能体实例,也不会自动创建或清空记忆库。

同一 API 会话同时只能有一个活动调用任务流。更多内容请见 管理 API 会话、调用任务和中断

调用任务

调用任务表示智能体实例处理一次输入的运行过程。每次发送新输入或中断响应时,平台都会启动对应的调用任务。

completederror 表示本次任务结束;interrupted 表示任务暂停并等待调用方提交响应。调用任务结束或暂停不表示整个 API 会话、记忆库或沙箱同时结束。

更多内容请见 管理 API 会话、调用任务和中断

Agent API Token

Agent API Token 是调用 AgentWorks Invoke API 时使用的 Bearer 凭证,作用范围由其所属智能体实例和凭证配置决定。

临时调试 Token 适合短期验证,正式 Token 适合受控的系统集成。Agent API Token 不能代替控制台登录态,也不同于 WebSocket 渠道 Token 和大语言模型的文本计量 Token。

更多内容请见 管理 API 调用和 WebSocket Token

大语言模型

大语言模型是面向自然语言理解、生成、推理和对话等任务的基础模型。文档中的“大模型”在多数上下文中也指这一类模型或以大语言模型为核心的模型服务。

在 GenStudio 中,用户可以通过体验中心、API、模型广场或微调服务使用大语言模型,并根据模型能力、上下文长度、价格和调用限制选择合适的模型。

模型广场

模型广场是 GenStudio 用于集中展示平台预置模型的产品页面。用户可以按模型类型、任务场景、上下文长度、兼容协议、模型提供方等条件筛选模型,并查看模型卡片和详情页。

模型广场中的模型卡片和详情页通常提供模型 ID、上下文长度、最大生成长度、输入输出模态、兼容协议、调用说明、价格或服务限制等信息。接入 GenStudio API 或编码套餐前,用户应以模型广场展示的当前能力和调用信息为准。

Token

Token 是大语言模型处理文本的基本计量单位。模型会把输入文本拆分为 Token,并按 Token 序列生成输出。

在 GenStudio 中,Token 常用于描述上下文长度、最大输出长度、API 频率限制、用量统计和计费。一次调用通常会分别统计输入 Token 和输出 Token。

上下文长度

上下文长度是模型一次请求中可处理的输入与输出 Token 总量上限。它决定模型能够同时接收多少历史消息、提示词、工具结果或其他文本内容。

选择模型时,用户应结合任务所需的上下文长度和最大输出长度评估模型是否适合当前业务场景。

API 频率限制

API 频率限制用于控制租户或 API Key 在固定时间窗口内可发起的请求量、Token 用量或其他调用量,避免单个调用方影响整体服务稳定性。

GenStudio LLM API 常见限制维度包括 RPM、RPD 和 TPM。触发频率限制后,请求可能返回限流错误,用户需要降低调用频率、缩短请求内容或升级服务等级。

包并发服务

包并发服务是一种预先购买并发处理能力的容量保障方式。用户购买并发槽位后,可在约定范围内获得更稳定的请求处理能力。

在 GenStudio LLM API 和 ComfyUI 工作流等场景中,包并发服务可用于降低高峰期与其他用户争用公共资源的风险,并提升实时业务的响应稳定性。