2026最新|零基础在Windows搭建AI Agent开发环境完整教程(附可运行代码)

张开发
2026/4/21 1:50:18 15 分钟阅读

分享文章

2026最新|零基础在Windows搭建AI Agent开发环境完整教程(附可运行代码)
2026最新零基础在Windows搭建AI Agent开发环境完整教程附可运行代码摘要本文解决开发者在 Windows 环境下入门 AI Agent 开发时常见的环境配置、依赖安装和第一个 Agent 示例跑通问题适合刚接触智能体开发、自动化任务和多步骤推理的读者。读完可以完成本地开发环境搭建并运行一个具备“搜索 总结”能力的最小 AI Agent。一. 开篇引入AI Agent 不是“把问题发给大模型再拿回答案”这么简单它的本质区别在于普通 AI 调用通常只做一次输入输出而 AI Agent 会围绕目标自主拆步骤、调用工具、处理中间结果再返回最终结论。常见场景包括自动化任务、代码生成、网页信息整理、数据处理和多步骤推理。开发者第一次上手 AI Agent 开发时最容易卡住的地方通常不是概念而是环境太碎Python 版本不兼容、虚拟环境没隔离、依赖装错、API Key 不知道放哪、工具调用链路跑不通最后代码看起来没问题任务却始终执行不完整。二. AI Agent 开发完整教程这篇文章不讲抽象框架对比直接用Python OpenAI 兼容接口 搜索工具函数搭一个最小可运行的 AI Agent。本文固定使用以下环境系统Windows 11 64位Python3.12.3工作目录C:\Users\CF\ai-agent-demo\虚拟环境目录C:\Users\CF\ai-agent-demo\.venv\主代码文件C:\Users\CF\ai-agent-demo\agent_demo.py环境变量文件C:\Users\CF\ai-agent-demo\.env模型接口地址https://api.deepseek.com/v1模型名deepseek-chat温度参数0.2重要提示AI Agent 的成败往往不在“模型够不够强”而在“环境、参数、工具函数和执行链路是否一次配对”。第 1 步安装Python 3.12.3下载安装完成后在 PowerShell 中执行python--versionpip--version预期输出类似Python3.12.3 pip24.0再确认解释器路径where python常见路径类似C:\Users\CF\AppData\Local\Programs\Python\Python312\python.exe安装时务必勾选Add python.exe to PATH因为后面所有依赖安装、脚本执行和环境隔离都基于这一步。第 2 步创建本地项目目录与虚拟环境在 PowerShell 中执行mkdirC:\Users\CF\ai-agent-democdC:\Users\CF\ai-agent-demo python-mvenv .venv激活虚拟环境C:\Users\CF\ai-agent-demo\.venv\Scripts\activate激活后终端前缀通常会显示(.venv)这表示后面的依赖都会装进当前项目环境不会污染系统全局 Python。第 3 步安装依赖在已激活的虚拟环境中执行pipinstallopenai1.76.0 python-dotenv1.0.1requests2.32.3安装完成后检查结果pip list至少应看到openai1.76.0 python-dotenv1.0.1 requests2.32.3这里不用一次性装一堆框架原因很简单入门阶段先把“最小可运行 Agent”跑通比一口气装满生态包更稳。第 4 步创建.env配置文件新建环境变量文件notepad C:\Users\CF\ai-agent-demo\.env写入以下内容DEEPSEEK_API_KEY你的真实APIKey DEEPSEEK_BASE_URLhttps://api.deepseek.com/v1 DEEPSEEK_MODELdeepseek-chat AGENT_TEMPERATURE0.2关键参数说明参数名示例值作用DEEPSEEK_API_KEYsk-xxx模型接口凭证DEEPSEEK_BASE_URLhttps://api.deepseek.com/v1OpenAI 兼容接口地址DEEPSEEK_MODELdeepseek-chat使用的模型名AGENT_TEMPERATURE0.2控制回答稳定性越低越稳重要提示不要把 API Key 直接硬编码到脚本里后续项目一旦需要提交代码或复用环境.env是最稳妥的管理方式。第 5 步编写 Agent 代码创建主文件notepad C:\Users\CF\ai-agent-demo\agent_demo.py写入下面这段完整代码importosimportjsonimportrequestsfromdotenvimportload_dotenvfromopenaiimportOpenAI load_dotenv()api_keyos.getenv(DEEPSEEK_API_KEY)base_urlos.getenv(DEEPSEEK_BASE_URL)modelos.getenv(DEEPSEEK_MODEL)temperaturefloat(os.getenv(AGENT_TEMPERATURE,0.2))clientOpenAI(api_keyapi_key,base_urlbase_url)defsearch_web_mock(query:str)-str:mock_results{OpenClaw 是什么:OpenClaw 是一个面向 AI Agent 开发与执行的工具体系支持工具调用、任务执行与工作流扩展。,AI Agent 开发教程:AI Agent 开发通常包括模型接入、工具定义、任务规划与结果输出四部分。}returnmock_results.get(query,f没有找到与「{query}」直接对应的结果。)defagent_run(user_query:str)-str:search_resultsearch_web_mock(user_query)promptf你是一个AI Agent请根据用户问题和搜索结果给出结构化总结。 用户问题{user_query}搜索结果{search_result}请按下面格式输出 1. 简要回答 2. 关键信息 3. 可执行建议 responseclient.chat.completions.create(modelmodel,temperaturetemperature,messages[{role:system,content:你是一个会根据外部工具结果整理答案的 AI Agent。},{role:user,content:prompt}])returnresponse.choices[0].message.contentif__name____main__:queryOpenClaw 是什么resultagent_run(query)print(result)这段代码虽然是最小版本但已经具备了 AI Agent 的 3 个基本要素一个模型调用入口一个工具函数一个基于工具结果再组织答案的执行链第 6 步运行代码并验证结果在已激活虚拟环境的终端执行python C:\Users\CF\ai-agent-demo\agent_demo.py如果配置正常会输出类似内容1. 简要回答 OpenClaw 是一个用于 AI Agent 开发和执行的工具体系。2. 关键信息 - 支持任务执行 - 支持工具调用 - 支持工作流扩展3. 可执行建议 如果你准备入门 AI Agent 开发可以从搭建基础环境和跑通最小示例开始。这说明你的最小 Agent 链路已经跑通接收目标 → 调用工具 → 交给模型整理 → 输出结构化结果。常见报错及解决方法报错 1ModuleNotFoundError: No module named openai原因依赖没有装进当前虚拟环境。修复命令C:\Users\CF\ai-agent-demo\.venv\Scripts\activate pipinstallopenai1.76.0报错 2openai.AuthenticationError: Incorrect API key provided原因.env中的DEEPSEEK_API_KEY写错、为空或没有成功读取。修复方法检查文件C:\Users\CF\ai-agent-demo\.env确认存在这一行DEEPSEEK_API_KEY你的真实APIKey然后重新运行python C:\Users\CF\ai-agent-demo\agent_demo.py报错 3requests.exceptions.ConnectionError或模型接口无法访问原因DEEPSEEK_BASE_URL写错或者网络无法访问接口地址。修复方法确认.env中写的是DEEPSEEK_BASE_URLhttps://api.deepseek.com/v1不要漏掉/v1。如果仍然失败先在浏览器检查网络连通性再重试脚本。三. 实操案例场景构建一个“搜索 总结”型 AI Agent目标用户输入一个问题Agent 先查工具结果再基于工具结果生成结构化答案。输入条件主文件C:\Users\CF\ai-agent-demo\agent_demo.py配置文件C:\Users\CF\ai-agent-demo\.env当前查询参数queryOpenClaw 是什么操作过程保持.env配置正确确保虚拟环境已激活执行python C:\Users\CF\ai-agent-demo\agent_demo.py实际输入OpenClaw 是什么实际输出示例1. 简要回答 OpenClaw 是一个面向 AI Agent 开发与执行的工具体系。2. 关键信息 - 可用于智能体开发 - 支持任务执行 - 支持工具扩展与工作流接入3. 可执行建议 可以从最小 Agent 示例开始逐步加入真实搜索、网页抓取和多步骤规划能力。结果判断这个案例已经具备 AI Agent 开发的最小闭环有目标输入有外部工具结果有模型基于工具结果组织答案有最终结构化输出这比单纯调用一次大模型接口更接近真正的 Agent 开发。四. EasyClaw 用户的更简单选择如果你做的是 AI Agent 开发最费时间的通常不是“写一段代码”而是Python 环境隔离依赖版本管理.env配置维护工具函数接入本地调试和结果验证EasyClaw 在这个场景下最大的价值不是替代所有开发工作而是在一些环节帮你降低配置负担。尤其是当你的目标不是研究底层实现而是更快把任务流跑起来时EasyClaw 会更省步骤。在 Windows 环境下它有两个比较直接的优势1. 少处理一层依赖和本地配置传统 AI Agent 入门通常要自己管 Python、依赖包、环境变量和接口调试。EasyClaw 更偏“装好后尽快进入任务执行”减少了前期环境整理成本。2. 界面操作更适合日常任务验证如果你当前阶段更关心“这个 Agent 场景能不能跑通”而不是先手写最小代码链路EasyClaw 的图形界面和任务流入口会更直观。下载地址https://easyclaw.cn/?f232它不是替代底层 Agent 开发而是给希望更快验证 AI 工作流的人多提供一个更容易落地的入口。五. 总结AI Agent 和普通 AI 调用的本质区别在于它具备目标驱动、工具调用和多步骤执行能力Windows 下入门 AI Agent 开发先把 Python、虚拟环境、依赖和.env配置稳定下来最关键一个最小可运行 Agent至少要包含模型入口、工具函数和结构化输出链路只有跑通一次“输入目标 → 调用工具 → 输出结果”的完整过程才算真正入门如果你更想降低配置负担、快速验证任务流EasyClaw 会更省步骤AI Agent 开发最好的起点不是追求复杂框架而是先把第一个最小闭环真正跑起来。

更多文章