本文说明如何在 IGA Pages 控制台基于 Agent 模板创建项目。您将选择 Agent 模板、配置代码仓库、选择大模型接入方式、填写模板环境变量，并处理个别模板的特殊要求，最终创建可部署的 Agent 应用。

Agent 应用以 IGA Pages 项目的形式创建。GitHub 授权、代码源、加速区域和火山引擎 Supabase 等通用配置与普通项目一致，详见创建 IGA Pages 项目。本文只说明基于 Agent 模板创建时的差异部分。

前提条件 #

• 已开通 IGA Pages。
• 已完成 GitHub 账号授权。授权步骤见创建 IGA Pages 项目中的 GitHub 账号授权。

选择 Agent 模板 #

1. 登录 IGA Pages 控制台。

2. 在 Pages 页签中单击 创建项目。

3. 在 创建方式 中选择 模板创建。

4. 在 应用场景 中选择 AI Agent，再按业务需求选择模板。

   说明

   • 模板清单可能更新，请以控制台中的实际内容为准。
   • 单击模板卡片提供 预览 链接，可打开链接查看模板效果。

   模板	适用场景和能力
   通用智能对话 Agent	用于构建通用智能对话应用。支持多轮流式问答、文件上传与处理、Sandbox 工具执行和结果文件发布。
   Sandbox 工具执行示例	用于让 Agent 在隔离 Sandbox 中执行代码、Shell 命令和文件操作，并查看执行过程。
   内容运营 Agent	用于内容研究和创作。支持热点研究、跨平台内容创作、内容质检和运营分析。
   企业知识库问答 Agent	用于将 PDF 文档处理为本地知识库，并提供带页级引用的问答和持久会话。
   DeepAgents 深度研究 Agent	用于多 Agent 协作的深度研究。支持编辑计划、子 Agent 协作、证据审查和稳定引用。
   CSV 数据可视化	用于分析 CSV 数据。上传文件并描述分析目标后，可生成经过复算校验的交互式报表。

配置代码仓库与基本信息 #

1. 配置代码仓库。

   • 在 GitHub 用户名 中选择已授权的 GitHub 账号。
   • 填写新建仓库名。仓库名长度为 2～100 个字符，只能包含小写字母、数字、连字符、下划线和点号。
   • 在 仓库属性 中选择 私有 或 公有。

2. 配置基本信息。

   在 项目名称 和 加速区域 中填写或选择所需值。系统会按所选模板预填 项目名称，您可以按需修改。

配置大模型 #

在 大模型配置 中选择接入方式，然后按页面说明选择或填写模型参数。通用模型参数的配置方法见创建 IGA Pages 项目。

基于模板创建时，模型数量由所选模板固定，您不能添加或删除模型。模板预置模型时，大模型配置 默认开启并预填该模型。保留开关开启和预填值，即可使用该模型。

配置模板环境变量 #

当模板要求环境变量时，请在 环境变量 中填写对应值。变量的 Key 由模板定义且不可修改。每个 Value 都必填，最长 2000 个字符，且不能只包含空白字符。

特殊模板的配置要求 #

个别模板对大模型或环境变量有额外要求，创建前请注意：

• 企业知识库问答 Agent 模板只能使用 其他模型。接入的模型服务必须兼容 Anthropic API 协议。
• 使用 深度研究 Agent 模板前，请先开通豆包搜索并准备所需密钥。然后在 环境变量 中填写密钥，配置方法见豆包搜索文档。

创建项目 #

确认以上配置后，单击 创建项目。创建成功后，系统进入 项目详情 并开始首次构建。

在 部署记录 中等待状态变为 部署成功。然后单击 预览 获取预览链接，并打开链接验证应用。对话 Agent 的验证步骤见部署第一个 Agent 应用。应用上线后的配置变更、重新部署和部署处理见管理 Agent 应用。