IGA Agents 指在 IGA 上运行的 AI Agent 应用。您无需自行搭建托管环境，即可从模板或自有代码出发，部署带有大模型推理、工具调用和会话能力的服务，并像管理普通 Pages 项目一样管理该服务。本文说明 Agent 应用与 IGA Pages 项目的关系、控制台与开发套件分别提供的能力，以及起步路径。

产品定位 #

Agent 应用以 IGA Pages 项目的形式创建和管理。您在控制台选择 Agent 模板或导入自有代码后，系统会创建一个 IGA Pages 项目。后续的部署、配置、环境变量和访问入口均在该项目的详情页完成。因此，控制台中与 Agent 应用对应的对象是项目，本文在描述控制台操作时统一称项目。

相比在 IGA Pages 上部署普通前端应用，Agent 应用需要接入大模型，并常常依赖工具调用、会话存储等运行时能力。IGA Pages 将这些能力集成到模板和开发套件中，让您无需单独准备推理服务和存储即可上线。

支持方式 #

IGA Agents 从两个层面支持 Agent 应用：控制台提供免代码的创建和管理流程，开发套件提供在服务端自行编写 Agent 逻辑时所需的运行时能力。

使用控制台 #

在控制台，您可以不写代码完成 Agent 应用的上线和日常维护：

• 从 Agent 模板创建项目，模板已内置可运行的 Agent 代码。
• 配置大模型，可使用平台一键开通的模型，也可接入自有模型。
• 填写模板所需的环境变量，例如外部服务的密钥。
• 查看部署状态、重新部署使配置生效，以及处理部署记录。

控制台的创建操作详见基于 Agent 模板创建应用，上线后的管理详见管理 Agent 应用。

使用开发套件 #

当您需要在服务端自行编写 Agent 逻辑时，IGA Pages 的开发套件提供以下运行时能力。您可以在应用代码中直接调用这些能力：

• 会话存储：持久保存会话上下文与状态。
• 沙箱：在隔离环境中执行代码或命令。
• 工具：为 Agent 提供可调用的外部能力。
• 对象存储：读写应用产生的文件与大对象。
• 框架适配：对接主流 Agent 开发框架。

这些能力的数据按当前项目的身份隔离，不同项目之间互不可见。各能力的接口、参数和示例见 Agents SDK 参考。

适用场景 #

控制台提供的 Agent 模板覆盖以下场景。您可以据此判断 IGA Pages 是否适合您的应用：

• 智能对话：构建可直接对话的通用 Agent。
• 工具执行：让 Agent 在沙箱中调用工具完成任务。
• 内容运营：面向内容生产与运营的 Agent。
• 知识库问答：基于企业知识库回答问题。
• 深度研究：围绕一个问题进行多步检索与归纳。
• 数据可视化：解析数据并生成可视化结果。

模板清单会随平台更新，上述场景以您在控制台看到的模板列表为准。模板的选择和配置方法见基于 Agent 模板创建应用。

开始使用 #

根据您的起点，选择一条路径：

• 第一次使用，想用一个固定模板快速跑通：参见部署第一个 Agent 应用。
• 想按业务选择模板、配置大模型和模板环境变量：参见基于 Agent 模板创建应用。
• 想在服务端自行编写 Agent 逻辑：参见 Agents SDK 参考。

关于 IGA Pages 本身的概念与通用能力，参见什么是 IGA Pages。