QDKT1-1使用 API 调用大模型，调整各项参数实践
一、前期准备（必做）
1. 工具下载与安装
- 核心工具：API Fox（客户端版，优先选择，避免网页端环境问题）、Kimi/Deepseek（二选一，需注册账号）、豆包（辅助使用）。
- 编程相关：Python（3.10及以上版本，Windows/Mac均可）、代码编辑器（Sublime Text 免费好用，或VS Code、Cursor）。
- 辅助工具：Cherry Studio（用于MCP服务测试，支持MCP客户端配置）、Excel（用于查看记账结果）。
2. 账号与资源准备
- Kimi/Deepseek 充值：登录账号后进入用户中心，充值购买TOKEN（建议至少50元，后续高频使用），未购买TOKEN将无法调用API。
- Python环境配置：安装Python时，Windows用户需勾选“Add Python to PATH”（自动配置环境变量），Mac用户直接默认安装即可，无需额外配置。
- 资源下载：从课程群获取MCP教程文档（后续MCP模块使用）、老师提供的示例代码（避免自己编写出错）。
二、核心模块操作步骤（按课程顺序）
模块1：API调用（JSON格式输出）
1. 核心目标
掌握API请求配置，让大模型输出结构化JSON格式，为后续工具调用打基础。
2. 操作步骤
- 获取API授权信息：打开课程群小程序，微信扫码登录后，获取API授权文档中的URL、Header参数（认证信息、Content-Type）。
- API Fox配置：
- 新建API接口，请求方式选择“POST”，粘贴获取到的请求URL。
- 配置Header：添加“认证参数”（从授权文档复制）、“Content-Type: application/json”。
- 获取API Key：
- 登录Kimi/Deepseek，进入“用户中心→API密钥管理”，新建密钥，命名为“课程演示”，创建后立即复制保存（后续无法再次查看）。
- 测试JSON格式输出：
- 在API Fox的Body中选择“JSON”格式，输入提示词（需包含“强制输出JSON格式”，建议附带示例，避免格式错误）。
- 模型选择：优先用Kimi Turbo版（速度快，半价期性价比高），替换默认模型。
- 发送请求，查看响应结果，用Sublime Text打开结果，删除转义符号（\）和换行符（\n），验证JSON结构是否完整。
3. 不同模型差异注意
- Kimi：专项训练过JSON格式，输出结果规范，基本无多余符号，直接可用。
- 千问（可选测试）：容易在JSON前添加代码块符号（```），导致下游程序无法识别，需手动删除，或在请求中添加“response format=json object”参数解决。
模块2：Function Call（工具调用实战）
1. 核心目标
让大模型调用自定义工具（记账+计算器），通过AI生成代码，无需手动编程。
2. 操作步骤
- 编写提示词（复制直接用）：
“帮我写一个Python Demo，包含两个工具：①记账工具：提取用户自然语言中的消费信息（时间、事项、金额），保存到Excel表格；②计算器工具：支持加减乘法运算。要求：接收用户输入，调用大模型API获取结构化数据，运行工具后返回结果，打印每个步骤的执行过程，允许用户在对话中输入需求，不使用示例数据。”
- 生成代码：
- 打开Kimi/Deepseek，粘贴上述提示词，发送后等待AI生成完整Python代码（约2分钟，Turbo版更快）。
- 若AI未补全工具参数，可追加提示词“补全记账和计算器工具的参数描述，确保代码可直接运行”。
- 配置代码环境：
- 新建文件夹（命名为“function_call_test”），将AI生成的代码保存为.py文件（文件名无空格，如“[function_call_demo.py](function_call_demo.py)”）。
- 打开终端（Windows用PowerShell，Mac用终端），输入命令安装依赖：pip3 install requests pandas（若下载慢，可先输入pip3 config set global.index-url https://pypi.tuna.tsinghua.edu.cn/simple切换清华源）。
- 运行与测试：
- 在终端中输入命令：python3 文件夹路径/function_call_demo.py（或直接将.py文件拖入终端，自动填充路径）。
- 按照提示输入需求，例如“早上吃麦当劳花了15元，记一下账”“3+7等于几”，运行后在文件夹中查找Excel文件，查看记账结果。
3. 常见问题排查
- 命令报错“不是内部或外部命令”：检查Python是否配置环境变量，Windows用户可尝试将命令中的“python3”改为“python”。
- Excel文件找不到：Mac可能默认保存到根目录，通过“搜索文件”功能查找文件名；Windows可在保存文件夹直接查看。
- 代码运行无响应：检查API Key是否正确粘贴（前后无空格）、模型是否替换为Kimi/Deepseek对应的模型。
模块3：MCP服务封装（工具复用进阶）
1. 核心目标
将Function Call工具封装为MCP服务，实现跨设备、跨平台使用，无需重复复制代码。
2. 操作步骤
- 准备工作：
- 下载课程群中的MCP教程文档，将其与之前的Function Call代码文件放在同一文件夹中。
- 打开Kimi，上传MCP教程文档和Function Call代码文件，作为附件发送。
- 生成MCP代码：
- 提示词：“附件1是记账工具的Function Call代码，附件2是MCP教程文档。请提取代码中的工具能力和实现逻辑，仅保留记账功能，将其改造成MCP服务，要求Excel表格路径支持用户通过环境变量自行填写，提供详细的安装依赖和配置步骤。”
- 等待AI生成MCP代码（.py文件）和配置说明，保存到之前的文件夹中。
- 安装MCP依赖：
- 终端输入命令：pip3 install mcp-cli（核心依赖，必须安装），其他依赖按AI提示安装。
- 配置Cherry Studio客户端：
- 打开Cherry Studio，点击右上角“设置→MCP服务→添加”。
- 复制AI生成的MCP配置JSON（包含command、路径、环境变量等），粘贴到配置框中，修改：
- 将“command”改为“python3”（Mac）或“python”（Windows）。
- 填写MCP代码的完整路径（无空格）。
- 环境变量中填写Excel表格的保存路径（例如“C:/function_call_test/记账表格.xlsx”）。
- 测试MCP服务：
- 启用配置好的MCP服务（勾选开关），新建对话，输入“中午吃面条花了20元，记账”，发送后查看Excel表格是否成功记录。
3. 关键注意事项
- MCP配置报错：检查路径是否包含中文/空格，API Key是否正确，依赖是否安装完整。
- Cherry Studio无响应：重启客户端，重新配置MCP服务，确保“command”与Python环境匹配（3版本对应python3）。
- 记账失败：检查Excel表格是否已创建，路径是否与配置一致，无权限则更换保存路径（如桌面文件夹）。
模块4：网页开发（后续课程）
1. 提前准备
- 核心目标：开发套壳版花式文案排版助手，本质是“API调用API”的实践。
- 预习任务：自行构思一个使用场景（例如“职场邮件生成”“朋友圈文案排版”），后续跟随老师操作时替换为自己的场景。
三、常见错误速查
|
错误现象 |
排查方向 |
|
API调用提示“无权限” |
1. TOKEN未充值；2. API Key错误；3. 授权文档未打开 |
|
Python运行提示“模块不存在” |
1. 依赖未安装；2. 安装命令与Python版本不匹配（用pip3） |
|
JSON格式解析失败 |
1. 未添加示例提示词；2. 模型未设置response format参数；3. 结果包含多余代码块符号 |
|
MCP服务无法启用 |
1. mcp-cli未安装；2. 配置路径错误；3. Cherry Studio未安装必要依赖 |
|
Excel表格无记账结果 |
1. 代码中路径未改为本地路径；2. 运行时未输入有效消费信息；3. 权限不足，更换保存路径 |
AtomGit 是由开放原子开源基金会联合 CSDN 等生态伙伴共同推出的新一代开源与人工智能协作平台。平台坚持“开放、中立、公益”的理念，把代码托管、模型共享、数据集托管、智能体开发体验和算力服务整合在一起，为开发者提供从开发、训练到部署的一站式体验。
更多推荐
9
0- 0
已为社区贡献41条内容
所有评论(0)