GeniSpace 高级功能指南
本指南面向有经验的用户，介绍 GeniSpace 平台的进阶用法。每个章节都对应一项真实的平台能力，并链接到相应的详细文档。
用量与计费分析
控制台的 分析 模块让您清晰掌握空间内的 Token 消耗与支出情况。
- 在控制台侧边栏打开 分析 模块
- 查看 Token 余额、今日用量和本月用量
- 按服务类别细分用量（智能体、算子、助手服务）
- 对比不同周期（今日 vs 昨日、本月 vs 上月）
- 查看最近交易记录（消费、充值、赠送、退款、调整）以及成员用量排行榜
在独立部署版中，分析视图主要展示 Token 用量卡片；计费与交易明细适用于 SaaS 版。
完整说明详见 分析概述。
高级工作流
工作流远不止线性的节点串联。工作流引擎支持控制流和多种触发方式，让您能够建模真实的业务逻辑。
控制流
使用控制流节点在工作流内部进行分支和迭代：
- 条件分支（If/Else） — 判断条件，并沿匹配的分支路由执行
- 循环（For Each） — 遍历列表，对每一项执行其中的步骤
将其与算子、任务、数据源节点组合，即可构建对数据作出响应的多步骤流程。
触发器
工作流任务可通过三种方式启动：
| 触发方式 | 说明 |
|---|---|
| 手动（Manual） | 在控制台中按需运行，或通过 API 触发 |
| 事件（Event） | 由平台事件触发 |
| 定时（Scheduled） | 按计划自动运行（cron 风格） |
配置映射与环境变量
使用 配置映射（ConfigMap） 将配置与工作流、算子解耦。配置映射是一个键值变量的容器（可标记敏感项），可在执行时被引用。
- 进入 系统 设置 → 配置 标签页（或
/settings?tab=configmaps） - 创建配置映射并添加配置变量（如
DB_HOST、API_TOKEN） - 为敏感值（密码、API 密钥）标记敏感标志
- 将配置映射绑定到任务，或为空间设置默认配置映射
在工作流和算子配置中，使用 {{variableName}} 模板语法引用变量。例如，算子 URL https://{{API_HOST}}/api/v1/{{RESOURCE}} 会在执行时被解析。变量按优先级合并：任务级环境变量（最高）、绑定的配置映射、默认配置映射。
正确地做好访问控制
GeniSpace 在空间、应用和智能体三个层面分层管理访问控制。组合使用这些层级，可实现最小权限授权。
空间角色
空间成员资格由角色管理——所有者、管理员、成员 和 查看者——这些角色对应细粒度的 RBAC 权限（例如 space.workbench.read / write / admin）。大多数资源权限都由成员的空间角色派生，自定义角色可进一步细化。
详见 空间管理。
应用访问控制
应用拥有各自的可见性与访问设置，因此您可以独立于其他资源，控制谁能打开和管理每个已发布的应用或已安装的 GeniApp。
详见 应用管理。
智能体访问控制
智能体归属于某个空间，访问由空间的智能体权限（读 / 写 / 管理）控制。在配置智能体的工具时，还可进一步限制它可使用的算子、任务和数据源。
详见 智能体概述。
向智能体开放工具（MCP）
GeniSpace 智能体可通过 MCP（Model Context Protocol） 系统调用工具。MCP 工具按智能体配置，因此每个智能体只暴露您授予它的能力。
在智能体的 MCP 工具 配置中，您可以：
- 为智能体 启用 MCP 工具调用
- 启用内置工具（平台提供的渲染器和实用工具）
- 选择 算子策略：不使用算子、使用用户有权限的全部算子，或指定子集（算子工具命名为
算子标识_方法标识） - 选择 任务策略：不使用任务、使用全部任务，或指定任务（类型为 SCHEDULED / EVENT / MANUAL）
- 选择 数据源策略：不使用数据源、使用全部数据源，或指定数据源（操作类型为 READ / CREATE / UPDATE / DELETE）
- 通过端点添加 外部 MCP 服务器，引入第三方工具
对于专业化智能体，建议使用「指定」策略，将每个智能体限制为仅与其角色相关的算子、任务和数据源。这样能提升准确性和安全性。
完整的配置、路由、缓存以及智能体 MCP API 说明，详见 MCP 工具调用 指南。
扩展平台：GeniApps、应用市场与 Shell
除了智能体和工作流，您还可以用打包的业务应用来扩展空间。
- GeniApps 是平台托管的 iframe 应用（HR、库存、CRM、短剧制作等）。可从控制台 → 应用 中的 应用市场 安装到空间。安装或升级时，GeniApp 可自动开通自己的托管数据源和数据库结构。
- Shell 在控制台导航旁以 iframe 承载已安装的 GeniApp，安装后即出现在侧边栏中。
- 您也可以发布自己的 工作台 应用以及嵌入式/外部应用，并按应用管理其访问权限。