AI 实践课程 02 1 / 14

用 Qoder 搭建你的
第一个 AI Agent

从 API 到聊天界面,亲手跑通 Agentic 循环

业务同事也能跟练
用自然语言描述目标,让 Qoder 实现代码
一个看得见的循环
模型决定调用,应用执行,再把结果交回模型

课程 02 本机实操 三步跟练

AI 实践课程 02 2 / 14

今天要完成的小应用

问一句“2026 年 10 月有几个工作日”,看到它查数据后回答

01 查询 API
输入年份、月份,返回准确的日历计算结果
02 对话 AI
在网页中连续聊天,后端连接自己的模型服务
03 Agentic 循环
模型选择工具,应用调用 API,模型根据结果回答

前两步准备能力,第三步把它们接成循环

AI 实践课程 02 3 / 14

开始前的准备

你准备 Qoder、空文件夹和模型服务信息,环境由 Qoder 处理

你
描述目标,配置本机密钥,检查每步结果
Qoder
生成代码、安装依赖、启动应用、协助修复
你的应用
后端调用模型,执行工具,把调用记录显示出来

第一步无需模型密钥;第二步再配置你选择的模型服务

AI 实践课程 02 4 / 14

为什么这次选择 FastAPI

优先选容易验证、便于定位问题的工具

Swagger UI
浏览器里填参数、发请求、看返回
OpenAPI
接口说明随代码生成,Qoder 可据此接入
输入校验
错误参数给出反馈,让 Qoder 据此修复

把实现变成能检查的交付物,有助于与 AI 协作

AI 实践课程 02 5 / 14

第一步:在 Swagger 里发出请求

Qoder 启动服务后,打开它给出的 /docs 地址

第一步:在 Swagger 里发出请求
本机实跑截图;界面可不同,按行为与结果核对。

给 Qoder 的提示词

用 FastAPI 做工作日查询 API:输入年份、月份,返回工作日数量、日期清单和调休补班日期。日历用 https://unpkg.com/holiday-calendar@1.3.3/data/CN/{year}.json,按中国大陆普通双休计算,未知年份和无效月份报错。请检查并配置所需环境,安装依赖,只在本机启动,告诉我 /docs 地址和如何试查 2026 年 10 月。先不做聊天。
1 展开接口
找到 GET /workdays
2 Try it out
year 填 2026,month 填 10
3 Execute
点击后才真正发送请求

不用写调用代码,也能亲手验证 API

AI 实践课程 02 6 / 14

看到什么,才算第一步完成

在同一页面往下看 Server response 和 Response body

看到什么,才算第一步完成
本机实跑截图;界面可不同,按行为与结果核对。
HTTP 200
本次请求处理成功
workday_count: 18
2026 年 10 月工作日数量
补班日期
包含 2026-10-10

再查 2026 年 2 月,应为 16 天;月份 13 应报错

AI 实践课程 02 7 / 14

调用模型需要哪几项信息

向所选服务商取得配置,交由应用后端使用

项目作用在哪里填写
Base URL把请求发到哪里LLM_BASE_URL
API Key凭证,关联权限和计费LLM_API_KEY
Model调用哪个模型的准确编号LLM_MODEL
协议与能力Chat Completions;第三步需工具调用查服务商文档

兼容格式不等于能力完全相同;DeepSeek 是本课实测示例

AI 实践课程 02 8 / 14

第二步:能连续对话的 AI

使用你选择的兼容模型服务,先验证普通聊天

第二步:能连续对话的 AI
本机实跑截图;界面可不同,按行为与结果核对。

给 Qoder 的提示词

在现有项目上做一个类似 ChatGPT 的聊天网页,支持连续对话和新建对话。后端用 OpenAI Chat Completions 兼容接口,从 .env 读取 LLM_BASE_URL、LLM_API_KEY、LLM_MODEL,生成 .env.example 让我填写,密钥不进前端、日志或 Git。先不接工作日工具,配置后在本机启动并验证聊天,告诉我打开哪个地址。
连续对话
我叫小林 → 我叫什么
新建对话
再问名字,应不再记得
尚未接工具
工作日答案暂不能作依据

聊天页面已连上模型,下一步再赋予它查询能力

AI 实践课程 02 9 / 14

第三步:由模型决定调用工具

把工作日 API 介绍给模型,并实现收到调用后的执行逻辑

给 Qoder 的提示词

把第一步工作日 API 注册成聊天 AI 的 function tool,由模型决定调用,不用关键词分支。收到 tool call 后实际 HTTP 请求该 API,再把结果作为 tool 消息交回模型,最多 3 轮工具调用。页面显示工具名、参数、HTTP 请求、工具结果和最终回答,保留普通聊天模式作对照。缺年份先追问,API 失败说明原因,不猜数据。启动并用 2026 年 10 月验证。
工具说明
名称、用途、年份和月份参数
应用执行
实际 HTTP 调用第一步 API,把结果交回模型
应该看到
18 天、10 月 10 日,以及完整调用记录

模型提出调用请求,应用代码负责执行

AI 实践课程 02 10 / 14

Agentic 循环的基本框架

把执行结果交回模型,让它继续决定下一步

1 用户提问
2026 年 10 月有几个工作日?
2 模型返回调用
get_workdays(year=2026, month=10)
3 应用执行工具
HTTP 请求本机工作日 API
4 结果交回模型
tool 消息:18 天,10 月 10 日补班
5 模型继续处理
回答用户,或在限制内再次调用

核心连接在第 4 步:工具结果进入下一次模型请求

AI 实践课程 02 11 / 14

一条回答背后的执行记录

展开真实执行记录,核对模型选择和应用执行

一条回答背后的执行记录
本机实跑截图;界面可不同,按行为与结果核对。
工具名与参数
get_workdays,2026、10
HTTP 与结果
请求成功,18 天,10 月 10 日
最终回答
模型拿到结果后作答

只有“已调用工具”几个字不够,要看到参数、HTTP 与返回值

AI 实践课程 02 12 / 14

三类问题,检查不同环节

每次新建对话后测试,避免上一段答案干扰观察

提问应该看到检查什么
2026 年 10 月工作日?18 天,10 月 10 日补班工具与数据一致
比较 2026 年 2 月和 10 月16 天与 18 天,两个月调用模型选择参数、多次调用
10 月有几个工作日?先问哪一年缺信息先澄清
没有数据的年份/服务失败说明无法查询,不编造数量失败分支与停止

程序测试检查固定规则;真实模型试跑检查整条任务链

AI 实践课程 02 13 / 14

这次练习的适用范围

一台电脑、一个只读工具,先建立对循环的直观认识

日历口径
中国大陆普通双休,包含调休补班;企业排班另算
数据来源
开源日历整理国务院通知,UNPKG 分发;不是政府 API
实际使用前
核对新年份、处理超时与权限,评估模型费用和可靠性

确定计算交给程序;输入理解、工具选择和回答仍需验证

AI 实践课程 02 14 / 14

把一个工具换成你的业务能力

先找到一个边界清楚、结果能核对的只读任务

保留循环框架
用户请求、模型选择、应用执行、结果反馈
替换工具
例如订单状态、内部制度查询、费用规则计算
重新验证
接入方式与权限、可信答案、失败处理和成本

本课产出:工作日 API、对话界面、可观察的 Agentic 循环

课程目录

一起把课程改得更好

点赞、拍砖,或留一句话

不用登录,也不用实名。哪里有用、哪里看不懂,都可以告诉我们。

你的反馈

留言和称呼会公开。选填联系方式只为方便讲师联系你,不会展示在页面上。

开启 JavaScript 后可参与互动。