C#调用 AI学习从0开始-第1阶段(基础与工具)-第5天完善请求结构

调用接口(千问API)的数据格式:
1.Messages结构

千问API使用messages数组来保存对话内容,每个消息都包含role和content两个字段。

role分为:

system:系统消息,设定AI的角色和行为,使用场景:放在消息列表第一位,用于指定助手身份、回答风格、任务边界

user:用户消息,使用场景:用户输入的问题或指令

assistant:助手消息,使用场景:模型对用户的回复(在多轮对话中需要保存)

注意:user和assistant必须成对、交替出现

例子:messages: [

{ role: "system", content: "你是一个C#编程助手" },

{ role: "user", content: "什么是List?" },

{ role: "assistant", content: "List是..." }, ← 上一轮的回答

{ role: "user", content: "那Dictionary呢?" } ← 新的问题

]

2.核心参数说明

参数:model(string) 指定使用的模型,qwen-turbo, qwen-plus, qwen-max 等

参数:messages(array数组) 对话消息列表,包含system/user/assistant消息

参数:temperature(float) 控制回答的随机性。值越低回答越确定、简洁;值越高回答越多样、详尽,取值范围:0-2(常用0.3-0.8)

参数:max_tokens(int) 限制模型生成的最大token数,直接控制回复长度,取值范围:1 ~ 8192

参数:stream(bool) 是否流式输出,取值范围:true/false

3.响应数据结构

csharp 复制代码
{
  "id": "chatcmpl-xxx",
  "choices": [
    {
      "index": 0,
      "message": {
        "role": "assistant",
        "content": "模型返回的回答内容"
      },
      "finish_reason": "stop"
    }
  ],
  "usage": {
    "prompt_tokens": 100,
    "completion_tokens": 50,
    "total_tokens": 150
  }
}

参数总结:

参数 低值效果 高值效果 推荐场景

【1】temperature 0.2-0.4:回答简短、保守、确定性强 0.7-0.9:回答详细、有创意、多样性高 ,推荐场景:事实问答用0.3,创意生成用0.8

【2】max_tokens 50-100:回答非常简短 500+:回答详细完整,推荐场景:预览场景用小值,完整回答用大值

【3】model选择 qwen-turbo:速度快,成本低 qwen-plus:质量高,推荐场景:实时对话用turbo,复杂任务用plus

注意:temperature和max_tokens不传时,模型使用默认值

相关推荐
fly_sunnn11 分钟前
机械狗的前置学习(python与Linux基础操作)
学习
Rabitebla2 小时前
【Linux】文件篇(六):Shell 实战——从系统调用到命令行重定向
linux·服务器·c++·笔记·学习
Star(up up up)3 小时前
MySQL 事务隔离级别是如何实现的?从 MVCC 到锁机制原理详解
笔记·vscode·sql·学习·程序人生·mysql·学习方法
Z21-X20 小时前
云原生运维学习笔记:Kubernetes Volume 与 Secret 实验
运维·笔记·学习·云原生·kubernetes
李小白杂货铺1 天前
Windows 桌面 GUI 原型快速开发技术选型指南(Mac 开发 + Windows 交付场景)
windows·原型·gui·原型开发·技术选型·快速开发·技术路线
console.log('npc')1 天前
Python 学习教程 · 第4课:数据结构
数据结构·python·学习
星落梦生1 天前
Docker学习(11)
学习·docker·容器
承渊政道1 天前
magic-resume简历工具教程:Windows部署、在线编辑与远程访问
windows·远程访问·在线编辑·简历制作·工具教程·magic-resume