不少转行的朋友一上来就问：我不会写代码，能不能做 AI Agent。这个问题没有统一答案，取决于你要做的是「用现成平台搭一个能跑的东西」还是「自己接接口、控流程、扛线上」。这篇按目的分三档，把每档需要的前置能力、可以绕开的部分、以及验证自己够不够的方法摆出来，方便你判断从哪开始补。
不少转行的朋友一上来就问：我不会写代码，能不能做 AI Agent。这个问题没有统一答案，取决于你要做的是「用现成平台搭一个能跑的东西」还是「自己接接口、控流程、扛线上」。这篇按目的分三档，把每档需要的前置能力、可以绕开的部分、以及验证自己够不够的方法摆出来，方便你判断从哪开始补。
先给个结论：搭一档基本不碰代码，改一档要能看懂配置文件，造一档绕不开写代码。所以别急着问「要不要」，先问自己「想做到哪一档」。下面按档位拆开讲，后面跟一节具体补课顺序，可以照着走。模型和价格这类会变的数字，到 /models 和 /price-watch 核对当时的数字，这里不写死。
先分清三档：搭、改、造
第一档是搭：用零代码平台拖流程。前置能力是会拆任务、会写清楚提示词、会看日志，基本不碰代码。适合验证想法和做内部小工具，一两天就能出个能演示的东西。这档的门槛在表达清晰，不在技术。
第二档是改：在别人给的开源项目或客户端上改配置、换模型、加一个工具。需要看得懂 JSON 和 YAML、会用命令行、会看报错行号。这档是从「玩」到「用」的分水岭，多数人卡在这里，卡点通常不是代码本身，而是配置格式和报错读不懂。
第三档是造：自己写服务、控并发、做重试和日志。这档必须会一门语言，Python 或 TypeScript 二选一即可，并且懂 HTTP 请求长什么样。不用全会，够用就行，剩下的边做边查。
- 搭：会拆任务、写提示词、看日志，不碰代码，适合验证想法
- 改：看得懂 JSON/YAML、会用命令行、会定位报错，适合小团队落地
- 造：会一门语言、懂 HTTP、能处理并发和重试，适合对外提供服务
- 不适用的情况：目标要是上线给外部用户用、要承诺可用性，第三档的能力绕不开，只靠搭和改会卡在排查环节
第一档到第二档之间，必须补的四样东西
这四样是硬门槛，不补的话配置永远改不对、报错永远看不懂。下面按重要性排，从最容易见效的开始。
- HTTP 请求四要素
- 地址、方法、请求头（鉴权放这里）、请求体；接口调不通九成出在这一层，比背语法重要得多
- JSON 的读和写
- 会数括号层级、会改一个字段值、看得懂嵌套结构，工具调用和结构化返回全靠它
- 命令行三件事
- 切目录、跑脚本、看输出末尾的报错；不需要背命令，需要的是不害怕黑窗口
- 读日志的习惯
- 先看最后一行、再往上找第一个 error，别从第一行开始逐行看，那样容易被噪声淹没
| 能力 | 最小标准 | 怎么验证自己达标 |
|---|---|---|
| HTTP 四要素 | 说得出鉴权放在哪个位置 | 故意改错一次密钥，判断是鉴权还是地址问题 |
| JSON | 能手动改一个嵌套字段并保存成功 | 打开一份配置，把模型名改掉再跑通 |
| 命令行 | 能在项目目录里跑两条命令不出错 | 不看教程，自己切目录并执行一次脚本 |
| 日志 | 能从末尾定位到第一条真实报错 | 拿一次失败日志复述「发出没—返回啥—我错哪」 |
这四样凑齐，基本就能独立改配置了。有一样说不清楚，就先补那一样，别贪多。具体到各家平台和客户端的配置差异，本质都是这四样的组合，到 /sites 对照不同中转站的接入说明看一遍会更直观。
怎么判断自己够不够：三个自测动作
- 动作一：改配置跑通拿一份别人写好的配置，只改里面的模型名和地址，让它跑起来。能独立跑通，说明到了第二档。
- 动作二：制造一次失败故意把密钥改错一位，看报错信息，说得出这是鉴权问题还是地址问题。说不出来就回去补 HTTP 那层。
- 动作三：复述排查顺序把一次失败请求的原始日志复制出来，按「请求发出没—服务端返回了什么—我这边解析错在哪」的顺序复述一遍。这是排查能力的核心。
三个动作里有一个做不下来，就说明对应的前置能力还欠着。别急着往下学框架，先把卡住的那一步单独练几遍。这三个动作不需要买任何服务，用免费额度就能测。
可以先不学、别被劝退的部分
转行最怕被一堆「还应该学」劝退。下面这几样，在你还没跑出第一个能用的东西之前，可以放心往后放。
- 算法与数据结构：除非你要自己写检索排序，调接口做 Agent 基本用不到
- 框架底层原理：先用现成框架把流程跑通，遇到瓶颈再回头看它怎么实现的，顺序反了容易劝退
- 多语言齐上：Python 和 TypeScript 挑一门，等第一个能跑的东西出来再说第二门
- 运维全家桶：容器、网关、监控这些，等你要上线了再补，本地跑通阶段用不上
提醒一句：这些是「可以晚点学」，不是「永远不用学」。上线前该补的一样都跑不掉，尤其是日志、重试和并发处理这几块。想知道上线后会遇到哪些坑，到 /guides 翻一翻相关的实战指南会更清楚。
一条能落地的补课顺序
按周推进，每周只盯一个产出，别同时开好几条线。四周走完，你会比只看教程的人多出真实经验。
- 第一周：搭一个能用的东西用现成平台搭出一个能回答你所在行业问题的 Agent，体会「拆任务+写提示词」的手感。目标是能演示，不求稳定。
- 第二周：逼自己处理一次格式错误把提示词拆成结构化输出，故意让它返回格式不对的情况，然后自己修好。这一步会自然逼你去查 JSON 相关文档。
- 第三周：改一个开源客户端挑一个开源客户端或平台，改配置接一个第三方接口，跑通一次工具调用。跑不通就按排查顺序一条条排。
- 第四周：让它跑一周给自己定一个小目标（比如每天自动整理一份资料），把它跑一周，记录失败次数和失败原因。这份记录比任何教程都值钱。
四周之后你会知道自己到底卡在哪一层：是表达不清、配置读不懂，还是代码写不动。知道卡点，后面的学习路径就清楚了。工具和客户端的选择可以到 /tools 和 /sites 里对照，别一上来就纠结选哪个，先动起来。
下一步把你现在最卡的那一步跟站内的中转站可信度检测和指南中心对一遍，能省掉不少试错时间。→常见问题
完全不会写代码，能做出一个能用的 AI Agent 吗
能做出来，但边界要清楚：用零代码平台搭的内部工具、个人自动化流程，基本不需要写代码；一旦要接自己的数据、要给别人用、要处理失败重试，就会碰到代码或配置文件。建议先做出来一个，再按缺什么补什么，别一开始就陷进「先学三个月编程」。
学 Python 还是 TypeScript
看你想接的东西在哪。做数据处理、脚本自动化、跟本地知识库打交道，Python 生态现成的东西多；做网页端产品、要跟浏览器和前端打交道，TypeScript 更顺手。选一门先跑通一个能用的东西，比同时学两门强，第二门等有需求了再补。
零基础转行，简历上写什么才算数
写你真正跑起来过的东西，而不是学过的课程。一个每天自动整理资料并输出的流程、一次把失败率从高降到低的过程、一份排查记录，这些比证书有说服力。别编项目和数据，面试官问两句细节就会露馅，把自己真做过的那点事讲透更稳。
