【Agent智能体项目实战一】阿里云通义千问兼容 OpenAI 接口实现 AI 对话

小仓桑2026-03-22 16:41

一、环境准备

首先安装依赖：

bash 复制代码

pip install openai

二、完整代码

python 复制代码

from openai import OpenAI

# 1. 创建客户端（对接阿里云通义千问兼容接口）
client = OpenAI(
    api_key="你的API-KEY",
    base_url="https://dashscope.aliyuncs.com/compatible-mode/v1",
)

# 2. 发起对话请求
response = client.chat.completions.create(
    model="qwen3.5-flash",
    messages=[
        {"role": "system", "content": "你是一个Python编程的专家，可以帮助我解决Python编程中的问题，并且不说废话以及是个非常有趣的人"},
        {"role": "assistant", "content": "我是一个Python编程的专家，你要问什么？"},
        {"role": "user", "content": "你是谁"}
    ],
)

# 3. 输出结果
print(response.choices[0].message.content)

三、代码逐行解释

1. 导入库

python 复制代码

from openai import OpenAI

我们使用官方 openai 库，不需要额外装阿里云 SDK。

2. 初始化客户端

python 复制代码

client = OpenAI(
    api_key="你的API-KEY",
    base_url="https://dashscope.aliyuncs.com/compatible-mode/v1",
)

api_key：在阿里云百炼平台获取
base_url：通义千问兼容模式固定地址

3. 构造对话

python 复制代码

messages=[
    {"role": "system", "content": "设定AI角色"},
    {"role": "assistant", "content": "AI历史回复"},
    {"role": "user", "content": "用户问题"}
]

system：设定 AI 人设
assistant：历史对话（可选）
user：当前用户提问

4. 获取并打印结果

python 复制代码

print(response.choices[0].message.content)

直接取第一条回答的文本内容。

四、运行效果示例

执行代码后输出类似：

复制代码

我是一名专业的Python编程专家，专注帮你解决Python相关问题，风趣又高效！

五、重要注意事项

API Key 不要明文写在代码里上传到公网 ，非常危险！
建议改用环境变量：

python 复制代码

import os
client = OpenAI(
    api_key=os.getenv("DASHSCOPE_API_KEY"),
    base_url="https://dashscope.aliyuncs.com/compatible-mode/v1"
)

模型 qwen3.5-flash 是免费/低成本版本，适合学习使用。
接口格式完全兼容 OpenAI，原有项目可无缝迁移。

六、最终效果

七、总结

通义千问兼容 OpenAI 接口，一行配置就能切换
代码极简、易上手，适合快速开发 AI 小工具
适合做：Python 答疑、聊天机器人、智能客服等