本文帮助您在本地开发环境中完成 Agent SDK 的接入准备。完成后，您将拥有一套满足版本约束的 Node 运行环境、已安装的核心依赖包，以及通过 CLI 完成的登录与项目关联。这是后续调用 SDK 各能力的基础，建议在编写业务代码之前先按本文一次性配置到位。

接入时使用三个独立包：@iga-pages/cli 用于登录、关联项目和本地开发，@iga-pages/agent 提供 Store、Sandbox 与 Tools 等运行时能力，@iga-pages/blob 提供对象存储能力。

前提条件 #

在开始之前，请确认您的本地环境满足以下条件：

• Node.js 版本需为 20 或更高版本；SDK 仅在服务端运行。
• 具备从 npm 安装 @iga-pages/cli、@iga-pages/agent 和 @iga-pages/blob 的网络与访问权限。

操作步骤 #

第一步：准备 Node 环境 #

安装 Node.js 20 或更高版本。具体安装方式以 Node.js 官方文档或您所在环境的运行时管理方式为准。

第二步：安装 CLI 与依赖 #

首先全局安装命令行工具 @iga-pages/cli，它用于登录、关联应用与本地开发调试：

npm install -g @iga-pages/cli

随后在项目中安装运行库。核心包 @iga-pages/agent 不提供根路径导出，应用代码需要按能力从公开子路径引入，例如 @iga-pages/agent/store、@iga-pages/agent/tools、@iga-pages/agent/sandbox、@iga-pages/agent/store/openai、@iga-pages/agent/store/langgraph 或 @iga-pages/agent/store/claude。

npm install @iga-pages/agent

如需对象存储 Blob（二进制大对象存储）能力，再额外安装 @iga-pages/blob：

npm install @iga-pages/blob

第三步：登录并关联项目 #

SDK 会使用当前应用的运行时身份访问对应项目中的资源，不需要在业务代码中传入服务地址、密钥或项目身份。您只需通过 CLI 完成登录与项目关联：

iga login
iga pages link

完成登录和项目关联后，运行 iga pages dev 启动本地开发。

完成之后 #

至此，您已完成 Node 20 环境准备、核心包 @iga-pages/agent 的安装，以及通过 CLI 完成的登录与项目关联。您的本地开发环境已具备调用 Agent SDK 各能力的基础条件，接下来即可在业务代码中按需引入所需子路径并开始接入。