准备环境：你需要安装什么？

在开始之前，确保你的电脑上已经安装了 Node.js（一种让 JavaScript 在服务器上运行的工具，类似电脑的“翻译官”）。建议使用 Node.js 20 或更高版本（至少 18 以上）。你可以在 nodejs.org 下载安装包，安装后打开终端（命令提示符），输入 node -v 检查版本。

你还需要一个 Gemini API 密钥（Google 提供的人工智能服务，免费使用）。前往 aistudio.google.com，用 Google 账号登录，点击“获取 API 密钥”，创建后复制保存。免费额度每天 1500 次请求，足够学习使用。

安装步骤：一步步搭建项目

1. 新建一个文件夹，比如 my-agent，在终端进入该文件夹。
2. 运行 npm init -y 初始化项目，这会生成一个 package.json 文件。
3. 安装 Google AI SDK：npm install @google/generative-ai。
4. 创建文件 .env，在里面写上你的 API 密钥：GEMINI_API_KEY=你的密钥（注意不要有空格）。然后安装 dotenv 包来读取环境变量：npm install dotenv。
5. 创建主文件 agent.js，开始编写代码。首先引入依赖：require('dotenv').config(); const { GoogleGenerativeAI } = require('@google/generative-ai');。
6. 初始化模型：const genAI = new GoogleGenerativeAI(process.env.GEMINI_API_KEY); const model = genAI.getGenerativeModel({ model: 'gemini-1.5-pro' });。
7. 定义工具函数：比如 getWeather(city) 调用 Open-Meteo API 获取天气（免费，无需密钥），calculate(expression) 安全计算数学表达式，getExchangeRate(from, to) 通过 frankfurter.app 获取汇率（免费）。
8. 将工具描述（JSON 格式，包括函数名、参数、说明）传给模型，实现“函数调用”循环：模型返回工具调用请求，你执行函数，返回结果，模型再决定是否继续。

验证是否成功：跑一个测试

在 agent.js 中添加一个简单的交互逻辑（比如读取用户输入），然后运行 node agent.js。输入类似“柏林天气怎么样？”或“计算 500 欧元兑美元”，看是否返回正确结果。如果一切正常，恭喜你，第一个 AI 助手已经跑通了！

下一步可以做什么

你可以把这个助手封装成 Express HTTP 服务（一种搭建网页服务器的工具），让其他应用通过 API 调用它。添加更多工具，比如发送邮件、查询数据库，让它变得更强大。记住，核心思路就是“工具描述 + 循环调用”——模型不直接执行代码，而是告诉你该调用哪个函数，你执行后反馈结果。